用途:Command Code Delegate 用于把一项边界明确的编码任务交给独立的实现方——Command Code CLI(命令为 cmd)——执行,由编排者负责写任务说明、判断产出质量、复核并最终提交。它不针对某一特定编排代理,理论上只要代理能运行 shell 命令、读取文件即可使用;文档说明其设计并在 Claude Code 上运行,其他编排器属于“设计中、尚未验证”。
主要能力:提供五步循环:写 brief(任务说明)、派遣、等待完成、复核、落地提交。派遣通过 scripts/relay.mjs 包装 cmd -p,捕获运行过程并写出结构化 result.json,其中包含最终报告 finalMessage、改动文件 touchedFiles、运行版本及只读违规检测字段 readOnlyViolation 等。relay 支持 --read-only(只读审查/诊断)、--session(续接同一会话,只发增量说明)、--continue-last(无会话 ID 时的回退)、--timeout(看门狗硬超时,默认关闭)等选项。
使用方式:技能本身为文档目录,scripts/relay.mjs 缺失,需先定位经用户批准的上游版本,检查其源码、许可证和 CLI 帮助并确认兼容性,不得执行缺失路径或编造结果。环境需 Command Code CLI 已安装并登录(cmd login),cmd --version 成功、cmd status 显示已认证,Node 22+ 与 git;macOS/Linux 用 command -v cmd 确认,原生 Windows 需用 cmdc --version(cmd 是系统 shell),可通过 COMMANDCODE_BIN 指定绝对路径。派遣命令示例:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo。默认以 --yolo(全信任)模式运行,会实际编辑目标仓库;relay 不会提交,提交由编排者完成。
适用场景:将一项可界定的编码任务委派给独立实现方后自行审查 diff;以 --read-only 获取对抗性第二意见(列出已达成与争议点,请其逐条辩护或让步)。不适合:任务小到直接内联完成即可、cmd 未安装或未认证、想自己写代码或只需审查、原生 Windows 上 cmdc --version 失败(上游建议用 WSL)。
限制:仅为文档导入,不含可执行脚本,运行需上游实现;兼容性要求 Node 22+(旧文档中 Node 18 的说法已被取代);委派可能将工作区内容发送给配置的服务商并产生费用,需使用已批准的数据与最小凭据并设置有限预算;headless 模式只有“默认只读”和“--yolo 全信任”两态,无文件系统沙箱与路径限制,git worktree 只隔离检出而不隔离进程,若不允许目标树外写入应改用操作系统级沙箱或在容器内运行;全信任运行前需确认用户授权,必要时说明范围;只读保证依赖 CLI 权限层而非 OS 沙箱,relay 事后通过 git 可见改动检测,忽略或仓库外路径不在覆盖范围内;须先写清 brief(目标、现状、改什么、不改什么、真实门禁命令、报告约定),每次一项任务,并要求实现方不提交;复核时须自行重跑测试/lint/构建并对照 brief 检查是否超范围;落地前比较 HEAD 与派遣前基线。
参考文档包括 writing-the-brief.md、dispatch-and-poll.md、review-and-land.md、multi-task-queues.md;该技能改编自 amElnagdy/delegate-skills(MIT),为文档导入、运行时未捆绑。