用途:将编码任务委派给 agy(Google Antigravity CLI,快速 Gemini 模型)执行。agy 在无限制权限配置下直接编辑真实工作树;配套组件只是轻量启动器与任务收集器,Git 交付需在任务文本中明确说明,不要自行代做。
主要能力:在 git 仓库内允许脏工作区,若 git status --porcelain 不干净,会把有界的运行前状态摘要注入提示,让 agy 将相关路径视为用户自有上下文;仓库外会警告编辑无法通过 git 审查或回滚,但仍继续执行。默认留下工作树 diff;用户明确要求提交、推送或 PR 时,把该请求原样写入任务文本,由 agy 完成对应 Git 交付。
使用方式:技能文件位于 <plugin-root>/skills/implementer/SKILL.md,配套路径相对技能目录解析:node "<skill-dir>/../../companion/agy-companion.mjs" implement [flags] --prompt "task description"。任务描述通过 --prompt 原样传入,长文本用 --prompt-file <path> 或 --stdin。命令需在非沙箱环境运行,agy 需要 localhost 端口与 OAuth 令牌文件;在 Codex 中需为该命令申请提权。该模式下配套组件会向 agy 传 --dangerously-skip-permissions,这是无限制配置的预期行为。命令返回 job id,按 ../jobs/SKILL.md 收集结果:派发、等待最终结果、按需校验;运行中不要主动观察进度或读日志,仅在用户明确要求进度或需诊断失败时观察。
可选参数:--restricted / --unrestricted 权限配置,implement 默认 unrestricted,开箱即用;--restricted 为可选加固路径,agy 只能使用白名单工具,通常只能提议而非编辑,需配合设置流程的证据收集白名单。--continue 或 --conversation <id>、--model <id> / --effort low|medium|high(默认 gemini-3.8-flash-high)、--timeout <dur>(默认 60m,硬上限 120m)。
限制与规则:未经用户确认,不要预先实现、扩展或清理 agy 的改动;先原样返回 agy 的摘要再展示 diff;把用户明确授权原样传入任务字符串,提示模板默认拒绝高成本或不可逆副作用,仅当请求本身要求时才放开;除非用户明确要求宿主代理执行,否则不要自行提交 agy 的改动。已有会话的 --continue / --conversation 会继承其记录的模型与权限配置,除非显式覆盖;上述无限制默认仅适用于新任务。错误与恢复遵循 ../jobs/SKILL.md。