用途:作为编排者,把单个有边界的编码任务交给独立的实现者——GitHub Copilot CLI——然后自行审阅产出并落地。实现者在自己的会话、干净工作树中改代码;你负责写简报、判断与提交。该循环只需要 shell 命令和文件访问。
主要能力:随附 relay 脚本以 copilot -p 方式运行,使用 --output-format json --no-color --stream off,捕获 JSONL 事件流并写出 result.json;支持选择模型(--model)、推理强度(--effort low|medium|high|xhigh|max)、只读规划(--read-only 强制 --mode plan)、全工具自主(--allow-all-tools)、超时看门狗(--timeout,默认 30m)、会话恢复(--session 或 --resume-last)。
使用方式:先安装 copilot(npm install -g @github/copilot,CLI 需 Node 22+,relay 本身运行于 Node 18+),通过 copilot login 登录或设置 COPILOT_GITHUB_TOKEN / GH_TOKEN / GITHUB_TOKEN,确认 copilot 版本可用,并在目标 git 仓库中工作或通过 --cd 指定。写一份自包含简报存为文件,再运行 node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo。relay 会阻塞至完成;完成意味着进程退出且 result.json 存在,不要依赖进度显示。随后自行重跑项目门禁、按 touchedFiles 审阅 diff、必要时重派修正简报,最后自行提交(relay 从不提交)。未加 --allow-all-tools 时,无头模式下工具调用会被自动拒绝,relay 会报 status: "failed";--read-only 与 --allow-all-tools 互斥,且只读模式仍可执行 shell 命令。
适用场景与限制:任务足够大、值得承担委派开销;需要经人工审查的 PR 流程;不适合内联即可完成的小任务、未安装或未认证 copilot 的环境,以及需要硬沙箱的场景——Copilot 的沙箱控制属上游实验特性(基于 MXC,经 /sandbox 命令与设置控制,默认禁用),本 relay 不予配置。涉及凭据、生产数据或不可逆操作时应先询问人类。其他细节(如价格、平台支持范围)暂未提供。