Antigravity CLI 是一个智能体技能，用于从监督型智能体向 Antigravity CLI（agy）委派有边界的调查、审查或实现任务。
用途 当用户明确要求使用 Antigravity，或另一个智能体能够提供可验证的额外价值时，可使用该技能进行委派。对于常规工作，如果额外的启动和审查时间超过收益，应保留在监督型智能体侧完成。
主要能力 捆绑的客户端会立即返回任务 ID，并保留后台工作进程以支持后续追问。每一轮使用官方流式 JSON 输入/输出，并在下一轮恢复完全相同的 Antigravity 对话。等待进程和 stderr 结束，可以让权限拒绝和部分输出超时变得可见；每次追问都会产生 CLI 启动时间。
使用方式 Antigravity CLI 必须已经安装并完成认证。使用项目的 Python 3.12+ 解释器运行 scripts/agy.py。该辅助脚本仅使用标准库；当项目没有 Python 环境时，也可以使用 uv run --python 3.12 <script> ...。脚本路径应相对于本技能解析，而不是相对于接收任务的项目。
分配任务与追问时，需要提供目标、绝对工作目录、相关文件和证据、范围以及完成检查。Antigravity 不会继承监督型智能体的对话。对于较长的指令，应使用 UTF-8 提示文件：
python <script> start --cwd <absolute-project-path> --prompt-file <task-file> python <script> wait <task_id> --timeout 30 python <script> status <task_id> python <script> reply <task_id> --prompt-file <follow-up-file> python <script> cancel <task_id> python <script> close <task_id>
任务运行期间，独立工作仍由监督型智能体处理。wait 超时只返回快照，不会取消任务。reply 在当前轮次结束后才会被接受。应保留 task_id，并在不再需要追问时关闭工作进程。
该辅助脚本同时提供进程工作目录和 --add-dir。对于重叠文件的并发编辑，应使用独立 worktree 并将其路径作为 --cwd 传入；辅助脚本不会创建 worktree。应检查实际输出路径，因为 Antigravity 也可能写入其对话产物。
配置与权限 继承 Antigravity 的认证、模型和权限配置。订阅和 API 认证仍由 Antigravity 负责。不要切换提供商、更改认证或重写其全局设置来掩盖失败。
start 的 --model、--effort、--mode 和 --sandbox 是任务级覆盖项。应尊重用户选择的模型或 effort。否则根据复杂度、错误成本和可验证性选择 effort；当模型支持情况或合适选择不确定时，省略覆盖项。可使用 agy --output-format json models 发现模型。
权限应与已授权的工作匹配。--mode plan 是规划指令，不是强制只读访问：无头模式下的计划审查可以自动进行。监督型智能体的沙箱不会配置 AGY 的沙箱。在未检查目标平台支持情况前，不要承诺隔离。
对于已授权的工作区编辑，--mode accept-edits 允许文件更改而无需交互式 diff 审查；shell 命令仍遵循工具权限规则。如果文件工具以无效产物路径为由拒绝目标，应要求 Antigravity 写入常规工作区文件而不是产物。在尝试 shell 变通方法或扩大权限前，先检查该工具错误。
无头 AGY 无法接受程序化批准响应。当辅助脚本报告 blocked 时，应检查 denied_actions 和部分结果。如果任务需要这些工具，应使用限定范围的 Antigravity 权限规则或交互式 AGY 会话建立所需权限，并遵循原始授权。不要以未更改的权限反复提交被阻止的操作。辅助脚本仅将 --dangerously-skip-permissions 作为显式覆盖项暴露；不要仅为避免批准而使用它。限定范围的规则限制哪些操作匹配；它们存储在 Antigravity 的全局设置中，而不是由该辅助脚本管理的临时授权。
检查结果与恢复 应结合 status、closed、stop_reason、error、denied_actions 和 tool_errors 一起阅读。completed 表示该轮返回了响应，并不表示其声明或编辑已验证。应检查 diff、输出文件和相关检查。AGY 可能从单个工具错误中恢复，因此即使最终轮完成，工具错误仍应保持可见。
辅助脚本不会将原生 SUCCESS 或退出码 0 等同于完成。它会检查权限拒绝和 stderr 超时诊断，并强制执行自己的启动、轮次和关闭截止时间。
cancel 会停止该任务的 AGY 进程树并关闭其工作进程。它不会撤销已执行的编辑或外部操作。重试前应阅读部分结果。要继续已关闭的对话，需显式使用其返回的 session_id 启动新任务：
python <script> start --cwd <same-project-path> --conversation <session_id> --prompt-file <follow-up-file>
打开的任务可以在提供商失败后使用 reply。这是同一对话中的显式新轮次；没有自动重试。如果启动在获得会话 ID 之前失败，应解决错误后重新开始。
如果安装、认证、网络、权限或执行阻止了任务，应告知用户什么失败了以及哪些仍未完成。不要静默地用自身工作或其他提供商替代所请求的 Antigravity 贡献。提交、发布和其他外部操作保留原始分配的授权边界。
可使用 <script> --help 查看命令，使用 references/client.md 查看状态字段、超时、存储和诊断信息。
适用场景 适用于需要将调查、审查或实现任务委派给外部编码智能体，并希望保留任务 ID、支持追问、检查权限拒绝和部分结果的场景。
限制 Antigravity CLI 必须已安装并认证；无头 AGY 无法接受程序化批准响应；辅助脚本不创建 worktree；不将原生 SUCCESS 或退出码 0 视为完成；cancel 不撤销已执行的编辑或外部操作；没有自动重试。