把编码任务委托给 Command Code CLI…

当你想把有边界的编码任务交给 Command Code CLI（cmd）作为后台实现者，自己只做审查和提交时使用。

适用场景

解决思路

1. 确认前置条件：`cmd --version` 成功且 `cmd status` 显示已认证，否则安装 Command Code 并运行 `cmd login`；确认 PATH 上的 CLI（macOS/Linux 用 `command -v cmd`，原生 Windows 用 `cmdc --version`，`COMMANDCODE_BIN` 只能指向绝对路径且绝不能指向系统命令解释器）；进入目标 git 仓库且工作树干净后再派发。
2. 写 brief：Command Code 只能看到你发送的文本（除仓库自带的 AGENTS.md 外没有仓库记忆、聊天历史或共享上下文），brief 必须包含目标、当前状态、要改什么、不要动什么、项目真实的 gate 命令（从 AGENTS.md/CLAUDE.md/Makefile 中发现，不要假设）以及报告契约，并告知它不会提交（由你来提交）；一个 brief 只放一个任务。
3. 派发：用捆绑的 helper 发送 brief，它包装 `cmd -p`、捕获运行并写出结构化 `result.json`：`node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo`；只读审查/诊断加 `--read-only`；继续同一会话加 `--session <sessionId>`（只发增量 brief）；无 session id 时用 `--continue-last`；硬超时加 `--timeout 2h`（默认关闭，实现运行常需 1-2 小时）；查看全部选项用 `node .../relay.mjs --help`。
4. 等待完成：helper 会阻塞直到 Command Code 结束，用编排器提供的能力支撑它并在返回时恢复——Claude Code 用 `run_in_background: true` 运行 Bash 调用并在完成时收到通知；纯 shell/其他 agent 短任务前台运行，或后台运行并轮询结果文件（bash/zsh 用 `… &`）。运行完成的标志是 `result.json` 存在且有 `status`（预运行用法错误如参数错误或空 brief 会以退出码 2 退出且不写结果文件，所以也要检查退出码；缺少 `cmd` 二进制会以 127 退出但会写 status 为 `commandcode_unavailable` 的 `result.json`）。不要相信进度跟踪器，以 `result.json` 写入且进程退出为准，读工作树而不是状态行；实现者的完整报告是 `result.json` 的 `finalMessage` 字段。
5. 审查——不要相信自述：`result.json` 含 Command Code 自己的总结和 gate 声明，必须重新验证而非接受——自己重跑项目的 gate（第 1 步中的 test/lint/build 命令），绝不轻信“gates passed”；对照 brief 读 diff，看是否做了要求的事、没有多做（范围蔓延）也没有少做，以结果中的 `touchedFiles` 为起点，且因为运行是全信任的，要检查 brief 指定路径之外（而不只是之内）的编辑；如果装了相关 guard skills（clean-code-guard、test-guard 等）就对 diff 运行它们；对 schema/迁移变更做往返测试，对删除操作 grep 悬空引用。
6. 落地：relay 从不提交，但无法阻止 `--yolo` 下的 Command Code 写 `.git`；brief 禁止实现者提交，审查者在落地前把 `HEAD` 与记录的派发前基线比较。只有 gate 通过且 diff 站得住脚后，由编排者自己用清晰的信息提交已验证的工作；若需要修改，用前一次 `result.json` 中的 `--session <sessionId>` 发送增量 brief（仅在无 session id 时用 `--continue-last`）并再次审查。
7. 只读第二意见：用 `--read-only` 派发，brief 列出已达成一致的点，然后逐条列出争议点及双方立场，要求 Command Code 对每条辩护或让步——交付物在其最终消息中，不触碰任何文件；此处的只读保证来自 CLI 自身的权限层而非 OS 沙箱，所以 relay 事后也会检查：`readOnlyViolation: false` 表示 Git 可见检测器未发现变更（被忽略或仓库外路径不覆盖），`true` 表示发现变更，`null` 表示 git 无法判断。
8. 授权模型：委托是人工主动选择的，一旦用户说“运行这个队列”“继续”，提交已验证、通过 gate 的工作就是约定的契约；但有两个限制——暴露而非吸收（报告 Command Code 的设计决策、可辩护但未被要求的改动和非阻塞的小问题，而不是默默保留）以及范围变更时停下（若正确完成需要超出 brief，先问，不要自行扩大授权）。

适用边界 · 注意事项

• 任务小到可以直接内联完成——委托开销不值得。
• `cmd` CLI 未安装或未认证（需先运行 `cmd login`）。
• 你想自己写代码，或只需要审查（Command Code 有自己的 `/review`）。
• 在原生 Windows 上且 `cmdc --version` 不工作（上游建议用 WSL 以获得稳定的 Windows 体验）。