用途:capsule-driver 是“超级编排者席位”,在主工作树中通过一层子代理把某个 slice 的各阶段推进到完成。它实现已制定好的计划,不负责制定计划。
主要能力与结构:分层为——你(交互、有人类在场)→ capsule-orchestrator(约 3 个阶段、验证、提交)→ capsule-phase-planner(一个阶段→运行时表)与 capsule-worker(一个阶段→源码增量)。目的是让任何单一上下文不超过约 250k tokens。你的纪律是尽量少消耗上下文:不审查 diff,只生成编排者并读取其回传。
使用方式:开始时声明“Using the capsule-driver skill to drive SL-NNN through capsule orchestrators.”。循环为:为一段连续阶段(通常 3 个)charter 一个 capsule-orchestrator;读取其回传,检查每个 worker 的模型选择是否有真实理由、检查它对计划做了哪些调整;拿到回传后立即 TaskStop 该编排者,并在 /tasks 中确认其已消失;再为下一段阶段 charter 新的编排者,不要恢复已疲惫的实例;记录上报的摩擦;阶段实现完成即停止,不开始审计。
前置条件:确认会话权限姿态可被子代理继承;设置 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH: "2" 以保证两层生成深度;确认主工作树中没有其他写入者;slice 已规划(设计锁定、plan.toml 已编写、阶段存在);在会话环境中导出 CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1(按会话设置,不要写入 settings.json)。
升级与边界:子代理无法提问,AskUserQuestion 被扣留,编排者只能通过返回值沟通,你是唯一的升级路径;高影响决策与治理冲突交给人,其余自行决定。它不是 /dispatch:无工作树、无 fork、无隔离、无导入步骤,worker 直接编辑真实树、编排者直接提交;需要隔离或并行文件不相交阶段应改用 /dispatch。不要自己实现,不要审计(/audit 是后续独立阶段)。相关:/plan 与 /phase-plan 产出它所消费的内容,/audit 在其后,/dispatch 是受限工作树替代方案。