用途:把用户的编码任务交给 agy(Google Antigravity CLI,快速 Gemini 模型)执行,agy 在无限制权限配置下直接编辑真实工作树;配套组件只是轻量启动器与任务收集器,不代替 agy 做 Git 操作。
主要能力:通过 --prompt 原样传入任务描述,长文本可用 --prompt-file 或 --stdin;支持 --continue 或 --conversation <id> 延续已有会话,--model 与 --effort low|medium|high(默认 gemini-3.8-flash-high),--timeout 默认 60m、硬上限 120m;--restricted 为可选加固路径,agy 只能使用白名单工具,通常只能提议而非编辑。
使用方式:命令为 node "<skill-dir>/../../companion/agy-companion.mjs" implement [flags] --prompt "task description"。需在非沙箱环境运行,因为 agy 需要 localhost 端口与 OAuth 令牌文件;在 Codex 中需为该命令申请提权。该模式会向 agy 传 --dangerously-skip-permissions,这是无限制配置的预期行为。
工作区与交付:在 git 仓库内允许脏工作区,若 git status --porcelain 不干净,配套组件会把有界的运行前状态摘要注入提示,让 agy 视这些路径为用户自有上下文;在 git 仓库外会警告编辑无法通过 git 审查或回滚,但仍继续,需转达该警告。默认留下工作树 diff;只有用户明确要求 commit、push 或 PR 时,才把该请求原样写入任务文本交由 agy 执行。
结果收集:命令返回 job id,按 ../agy-jobs/SKILL.md 的协议派发、等待最终结果并按需校验;运行中不要主动观察进度、读日志或检查中间产物,仅在用户明确要求进度或需诊断失败时观察。
限制与规则:不要预先实现、扩展或“清理”agy 的改动;先原样返回 agy 的摘要再展示 diff;把用户明确授权原样传入任务字符串,提示模板默认拒绝高成本或不可逆副作用,仅当请求本身要求时才放开;除非用户明确要求,宿主代理不得自行提交 agy 的改动。已有会话的 --continue/--conversation 会继承记录的模型与权限配置,除非显式覆盖。若环境缺少所需工具,可用等效能力替代,但须保留任务目标、授权要求、确认步骤、结果交付与停止条件;无法等效时应说明缺失能力并请用户协助,不得静默跳过或绕过限制。