SuperAPI AI 工具集

agy-delegate

编程与开发

查看项目

更新于 10-22 03:20

技能介绍

用途

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 经过实际运行。
  • 资料在审查步骤后截断,后续内容暂未提供。