用途
agy-delegate 用于把有边界的编码任务委派给一个独立的实现者——Google Antigravity CLI(agy),然后由编排者(orchestrator)审查其产出并自行落地提交。编排者负责撰写任务简报并保留判断权;Antigravity 在其自己的会话中完成编码;编排者负责验证与提交。
该技能不绑定特定的编排智能体。整个循环只需要能够运行 shell 命令和读取文件,因此任何同类智能体都可以驱动它。它专为 Claude Code 设计并在其上运行;其他编排者视为“设计上支持、尚未验证”。
何时使用
- 你希望把一个有边界的编码任务委派给独立的 agy 实现者(Google Antigravity),然后自己审查其 diff。
- 用户明确要求委派给该实现者。
何时不使用
- 任务足够小,直接内联完成即可——委派的开销不划算。
- agy CLI 未安装或未认证。需从 Antigravity 的 CLI 文档安装并完成首次启动设置。
- 你想自己写代码,或者只需要 Antigravity 对你写的代码给出意见(--read-only 派发可覆盖只读审查,但普通审查可能根本不需要委派)。
前置条件(检查一次)
agy help成功。若不成功,安装 Antigravity CLI 并完成首次启动设置。agy models成功。这证明 CLI 可以认证并列出可用的模型标签。- 你处于(或将通过 --cd 指向)目标 git 仓库。
这些检查并不能证明无头写入会被批准。在 --print 模式下,Antigravity 无法提示写入权限,可能会自动拒绝。relay 会检测到该拒绝,而不是报告完成。
选择实现者模型
agy 有配置好的默认模型,因此 --model 是可选的。当人类对任务有偏好的 Antigravity 模型标签时使用它。否则让 Antigravity 使用其当前默认值,而不是猜测。
循环
每个任务运行以下五个步骤。步骤 1、4、5 属于你的判断;2、3 是机械操作。
1. 撰写简报
Antigravity 只能看到你发送的文本以及它能在工作区中检查到的内容——没有聊天历史,没有共享上下文。任务所需的一切都放进简报:目标、当前状态、要改什么、不要动什么、项目实际的 gate 命令,以及报告契约。告诉 Antigravity 它不会提交(由你来提交)。每个简报只放一个任务。完整指南与模板见 references/writing-the-brief.md。
2. 派发
使用捆绑的辅助脚本把简报发送给 Antigravity。它封装 agy --print,捕获运行结果,并写出结构化的 result.json——因此你唯一的工作就是“运行命令、读取文件”。(下文的 <skill-dir> 是本技能安装目录,即包含本 SKILL.md 的文件夹。)
node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# 选择模型标签: add --model "<label from agy models>"
# 推理强度(low, medium, high): add --effort high
# 只读(plan 模式——不编辑): add --read-only
# 启用 Antigravity 终端沙箱: add --sandbox
# 恢复最近一次会话: add --resume-last (仅增量简报)
# 查看所有选项: node .../relay.mjs --help
该辅助脚本默认启动一个全新的 Antigravity 项目,并传入 --add-dir <repo>(--cd 路径,绝对路径),以便 agy 拥有明确的工作区。它默认不传 --dangerously-skip-permissions。机制、标志与 result.json 结构见 references/dispatch-and-poll.md。
3. 等待完成
该辅助脚本会阻塞直到 Antigravity 完成,因此用你的编排者提供的任何方式支撑它,并在其返回时恢复:
- Claude Code:以
run_in_background: true运行 Bash 调用;完成时会收到通知。 - 普通 shell / 其他智能体:短任务前台运行,或后台运行并轮询结果文件。
不要用进度跟踪器代替现实:当 result.json 被写出且进程已退出时,运行才算完成。读取工作树,而不是状态行。实现者的完整报告是 result.json 中的 finalMessage 字段(也会在报告标记之间完整打印到 stdout)。
4. 审查——不要相信自我报告
Antigravity 的 result.json 包含它自己的最终消息和任何 gate 声明。要重新验证,不要直接接受:
- 自己重新运行项目的 gate(步骤 1 中的 test/lint/build 命令)。
- 对照简报阅读 diff:Antigravity 是否做了被要求的事,不多不少?result 中的 touchedFiles 是你的起点。
- 如果安装了相关 guard 技能,对 diff 运行它们。
- 对于 schema/迁移变更,做往返验证;对于删除,grep 悬空引用。
(资料在此处截断,后续内容暂未提供。)
适用场景
- 需要把有边界的编码任务交给独立实现者,同时保留编排者的审查与提交控制权。
- 用户明确要求委派给 Google Antigravity CLI 的场景。
限制
- 仅在用户明确要求委派时使用。
- 需要 agy CLI 已安装并完成认证。
- 在 --print 模式下写入权限可能被自动拒绝,relay 会检测该拒绝而非报告完成。
- 其他编排者尚未验证,仅 Claude Code 经过实际运行。
- 资料在审查步骤后截断,后续内容暂未提供。