用途
Subagent Orchestrator 是一个面向 Antigravity 2.0 的配额感知、并行子代理协调技能。它把一个大型任务转化为一组相互隔离、高效的代理任务（agent missions），旨在不耗尽每周配额的前提下完成多代理协作。
技能说明中列出的适用场景包括：任务横跨 3 个以上文件或组件；希望多个代理同时工作；曾经在任务中途遇到配额问题；任务同时涉及规划与构建；需要浏览器代理、代码代理与终端代理协同运行。
不适用场景包括：只编辑单个文件或修复单个 bug；编写 50 行以内的快速脚本；仅提问或仅生成计划。
主要能力与工作流程
该技能按六个阶段运行。
Phase 1 — DECOMPOSE（拆解）
在任何子代理运行之前，协调器必须先产出 Mission Brief，并宣布：“Running subagent-orchestrator skill. Decomposing task into isolated missions.” Mission Brief 的格式包含：目标（Goal，一句话描述完成状态）、代理总数（Total Agents）、配额策略（Quota Strategy，FLASH / SONNET / MIXED）、预期 Token 成本（Expected Token Cost，LOW / MEDIUM / HIGH），以及每个代理的条目，含 ID、Role（如 Planner / Builder / Tester / Browser）、Scope（该代理触及的确切文件或 URL）、Model（Gemini Flash / Claude Sonnet）、Input、Output、Depends on。必须等待用户批准 Mission Brief 后再继续；若用户修改，需更新并重新确认，绝不能跳过此步骤。
Phase 2 — QUOTA ROUTING（配额路由）
在分配模型前应用决策树：如果任务超过 20 个文件或超过 500 行新代码，则所有代理使用 Gemini Flash，Sonnet 仅保留给最终审查；否则，如果属于创意 UI / 复杂逻辑 / API 设计，则构建代理使用 Sonnet，其余全部使用 Flash；否则全部使用 Gemini Flash。模型成本规则（不得违反）：Claude Opus 绝不用于子代理，成本过高；Claude Sonnet 每个任务最多 1 个子代理；Gemini Flash 是所有子代理的默认选择，快速、便宜且使用独立配额池；浏览器子代理始终运行在自己的池中，应节约使用，每个任务最多 1 个。
Phase 3 — CONTEXT ISOLATION（上下文隔离）
每个子代理获得一个受限的上下文包，绝不向所有代理提供完整代码库。为每个代理准备 AGENT CONTEXT PACKET，包含：Files to read（仅列出该代理需要的文件）、Files to write（仅列出该代理将创建或编辑的文件）、Do NOT read（明确排除无关文件）、Knowledge（仅粘贴 GEMINI.md 中相关章节）。规则：如果代理不需要 node_modules、package-lock.json、.next/ 或 dist/，则应在代理运行前将它们加入 .antigravityignore。
Phase 4 — PARALLEL EXECUTION（并行执行）
按依赖顺序生成代理：第 1 轮（无依赖）并行运行；第 2 轮（依赖第 1 轮）等待第 1 轮全部输出后运行；第 3 轮（最终）整合并验证。轮次之间，协调器必须收集每个代理的输出产物，并执行三点抽查：代理是否停留在其被分配的范围内；与其他代理输出是否存在 import/export 冲突；是否有代理产出占位符（“TODO”“implement later”）。若任一检查失败，则用修正后的上下文重新运行该代理，不得继续。
Phase 5 — ERROR RECOVERY（错误恢复）
若子代理失败或产出损坏，遵循 RECOVERY PROTOCOL：不要重跑整个任务；定位确切的失败点；派发单个修复代理，仅以损坏文件为范围、以错误信息为上下文、模型使用 Gemini Flash（修复最便宜的选择）；继续之前先验证修复。绝不把损坏的输出级联到下一个代理，必须先修复再推进。
Phase 6 — INTEGRATION CHECK（集成检查）
所有代理完成后执行最终集成检查：所有 import 能正确解析；文件之间没有重复的函数/变量名；没有本应是环境变量的硬编码值；生产文件中没有遗留 console.log；组件之间类型一致（TypeScript）；构建能够成功（在脑中验证 npm run build）。若任一检查失败，派发一个最终修复代理，范围限定为该确切问题。
使用方式
用户提供大型多文件任务后，该技能先行拆解并输出 Mission Brief，等待用户批准或修改确认，再进入后续阶段；执行过程中按依赖分轮并行运行代理，并在轮次之间做抽查与修复。
配额监控规则
任务全程跟踪估算用量。各事件对配额的影响：代理生成 = LOW（建立阶段）；文件索引（每个）= LOW；工具调用（文件读写）= MEDIUM；终端命令 = MEDIUM；浏览器子代理激活 = HIGH；思考模式启用 = VERY HIGH。若任务中途估算用量超过冲刺配额的 60%：暂停并报告“Quota checkpoint: ~60% of sprint used. Continue or defer remaining agents?”；把剩余代理切换为 Gemini Flash；若浏览器子代理尚未启动则禁用它。
沟通规则
始终宣布当前正在运行哪个代理；轮次之间显示紧凑进度条，例如：Mission Progress: ████████░░ 4/5 agents complete；Quota Status: ▓▓▓▓░░░░░░ ~40% sprint used。不得连续超过一个代理回合保持沉默；若被阻塞，应明确说明原因，不得只是停下。
示例与限制
技能提供 examples/ 文件夹，包含 nextjs-feature.md（用 3 个并行代理构建完整的 Next.js 功能）、api-plus-frontend.md（后端 API 代理与前端 UI 代理并行运行）、debug-mission.md（以最小配额为损坏构建执行修复任务）。
限制：该技能协调代理规划，但不提供运行时调度器，也不自动强制执行配额限制；并行代理仍需要父代理进行显式的范围界定、审查与集成；当单次聚焦编辑或直接回答更快更清晰时，不应使用该技能。