Copilot Delegate 是一个面向编码任务委派的技能,核心思路是把有边界的编码工作交给独立的实现者——GitHub Copilot CLI(命令为 copilot),再由编排者(orchestrator)负责审查和落地。
用途 当你希望把一项有边界的编码任务委派给单独的 Copilot 实现者,然后自己审查其 diff 时使用。前提是用户明确要求委派给该实现者。编排者负责撰写简报并承担判断责任;实现者在自己的会话、干净的工作树中进行修改;编排者负责验证并提交。该循环只需要 shell 命令和文件访问,因此任何同类编排者都可以驱动它。
不适用场景 任务小到可以直接内联完成,委派开销不划算;copilot CLI 未安装或未认证;需要硬沙箱。Copilot 暴露了沙箱控制,但属于上游实验性功能(基于 MXC,通过 /sandbox 命令和设置控制,默认禁用),本 relay 不配置它们。--read-only 只禁用编辑工具(--mode plan),shell 命令仍会运行。如果项目文件完全不能改动,应针对干净或隔离的工作树进行派发。
运行时可用性 该目录分发不包含 scripts/relay.mjs。不要针对该技能目录运行示例,也不要自行编造 relay。如果用户授权安装上游运行时,应从署名来源获取固定版本,先检查,并验证其实际的 help/CLI 兼容性。下文关于产物/结果的保证描述的是上游行为,尚未在本包中测试。简报/事件中不要包含机密信息;分享前审查并脱敏日志。
前置条件(检查一次) 安装 copilot(npm install -g @github/copilot;CLI 需要 Node 22+,relay 本身运行于 Node 18+,relay 会探测 copilot 版本)。认证:运行 copilot login(交互式网页/设备流程),或在环境中设置 COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN。确认 copilot version 成功。在目标 git 仓库中工作,或用 --cd 指向它。
选择模型(可选) Copilot 会挑选默认模型(auto)。要选择其他模型,传入 --model <name>。relay 只接受字母、数字以及 . _ : / -(该值在 Windows 上会到达 shell)。
选择推理强度(可选) Copilot 支持推理强度调节:--effort <level>,取值为 low、medium、high、xhigh 或 max。relay 会在派发前拒绝其他任何值。
循环 每个任务执行以下五步。第 1、4、5 步需要判断;第 2、3 步是机械操作。
-
撰写简报 Copilot 只能看到你发送的文本,无法读取你的对话:简报必须独立完整,包含目标、当前状态、要改什么、不要动什么、项目真实的门禁以及报告契约。每份简报只针对单个任务。将其写入文件并作为 relay 的 --brief 传入。参见 references/writing-the-brief.md。
-
派发 使用单独安装并审查过的上游 relay。它运行 copilot -p,带 --output-format json --no-color --stream off,捕获 JSONL 事件流,并写入 result.json。
node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
选择模型: add --model <name>
设置推理强度: add --effort <level>
只读规划通过: add --read-only (forces --mode plan)
完整工具自主: add --allow-all-tools
硬性时间限制(看门狗): add --timeout 2h (the 30m default suits brief runs)
恢复会话: add --session <id> or --resume-last
查看所有选项: node .../relay.mjs --help
子进程的 cwd 固定工作区。relay 默认将产物写入系统临时目录,且从不提交。参见 references/dispatch-and-poll.md。
-
等待完成 relay 会阻塞直到 copilot 完成。用编排者的后台命令设施运行它,或在 shell 中后台运行并轮询 result.json。运行前的用法错误会以退出码 2 退出且不写结果;缺少 copilot 会以 127 退出并写入 status: "copilot_unavailable"。完成意味着进程已退出且 result.json 存在——相信进程状态和工作树,而不是进度显示。Copilot 的最终助手消息是 result.json 的 finalMessage 字段。
-
审查——不要信任自我报告 自己重新运行项目的门禁。对照简报阅读 diff,从 touchedFiles 开始。如果安装了相关守卫技能,运行它们。参见 references/review-and-land.md。
-
落地 如果工作良好,提交它。relay 从不提交——diff 和 result.json 就是记录;先运行 git status 和 git diff 确认到底改了什么。如果团队有 PR 流程,进行提交并推送分支;让人类审查发生。如果 diff 错误或不完整,在新的运行中用修正后的简报重新派发并再次审查。
自主性与权限 不带 --allow-all-tools 时,copilot 在无头模式下会自动拒绝工具调用:进程以 0 退出,但 relay 会检测到拒绝事件并报告 status: "failed",附带 CLI 自身的错误消息以及传入 --allow-all-tools 的提示。这是诚实的默认行为——编排者看到失败,而不是静默的空操作。
--allow-all-tools 显式授予完整工具自主权,需要该次运行获得明确的人类授权。请求委派给 Copilot 本身并不等于同意不受限制的工具。--read-only 选择 --mode plan,禁用编辑工具,使项目文件无法被直接编辑改动;它无需 --allow-all-tools 即可工作。plan 模式下 shell 命令仍会运行,因此它防范的是编辑,而非一切。这两个标志互斥。
Copilot 还暴露沙箱控制,但属于上游实验性功能(基于 MXC,通过 /sandbox 命令和设置控制,默认禁用)。本 relay 不配置它们。
授权模型 委派是人类主动选择的行为。一旦简报完成,copilot 就作为你已批准使用的工具工作。边界是:不要接受自我报告的结论;在磁盘上验证一切。对于涉及凭据、生产数据或不可逆操作的任何内容,先停下来询问人类,而不是把它写进简报。
参考 references/writing-the-brief.md——结构、范围、门禁、简报交付。 references/dispatch-and-poll.md——标志、产物、result.json 和失败恢复。 references/review-and-land.md——在运行结束时,宣布 diff 完成前要验证什么。 references/multi-task-queues.md——顺序队列、约束延续、进度跟踪和最终一致性检查。
限制 仅文档导入——不包含可执行 scripts/relay.mjs;完整运行时见上游。需要 copilot CLI、Node 18+、git。relay 从不提交——它只返回结构化结果 JSON;由你审查并落地提交。改编自 amElnagdy/delegate-skills(MIT)——仅文档,未捆绑运行时。