用途:把一项有边界的编码任务委派给独立的实现者——Google Antigravity CLI(agy),随后由你(编排者)审查它产出的 diff 并自行落地提交。你负责写任务简报并做判断,Antigravity 在它自己的会话里完成改动,你负责验证与提交。仅当用户明确要求委派给该实现者时使用;任务小到可内联完成、或 agy 未安装/未认证时不宜使用。该流程只要求“能运行 shell 命令、能读文件”,但按资料设计并运行于 Claude Code,其他编排者可视为“为其设计但尚未验证”。
前提:agy help 与 agy models 能成功执行(证明 CLI 已认证并能列出模型标签),且处于或指向目标 git 仓库。这些检查不能保证无头写入会被批准:--print 模式下 Antigravity 无法弹出写入授权,可能自动拒绝,中继会检测到拒绝而非报告完成。
五步循环:1)写简报,把所有目标、现状、要改与不要改的内容、真实门禁命令、报告契约都写进去,并说明不会由它提交;一份简报只放一个任务。2)派发,用自带 relay.mjs 包装 agy --print,捕获运行并写出结构化 result.json。命令:node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo,可选 --model、--effort high、--read-only、--sandbox、--resume-last。默认新建项目并传 --add-dir <repo>,默认不传 --dangerously-skip-permissions。3)等待完成,以 result.json 写出且进程退出为准,不要只看进度状态;实现者完整报告在 finalMessage 字段。4)审查,不要轻信自述:自己重跑测试/lint/build,按简报核对 diff,必要时跑守卫技能。5)落地,门禁通过且 diff 无误后由编排者提交;需要改动则用 --resume-last 发增量简报再审。
权限与授权:Antigravity 自管权限策略,中继默认不绕过。--read-only 走 plan 模式,去掉写入路径,与 --dangerously-skip-permissions 互斥;组合 --sandbox 与绕过标志时不应视为受控边界。无头写入被自动拒绝时中继返回 failed 并非零退出;--read-only 运行会前后做工作树指纹,在 result.json 中报告 readOnlyViolation。委派需人工主动选择,两条限制:暴露而非吸收(报告其设计决策与未请求的改动),遇范围变化先停下询问。
限制:此为纯文档导入,未包含可执行脚本 relay.mjs,完整运行时需见上游;需 agy CLI、Node 18+ 与 git;中继从不提交,只返回结构化 JSON。