用途:执行一个已经 groom 过的里程碑。它读取 /groom-milestone 产出的调度计划,创建集成分支,按波次并行启动 kage-bunshin 会话(独立的 claude -p 进程),每个会话位于自己的 worktree 中并具备完整编排能力(Agent 工具、全部 MCP 服务器),最后依次合并各分支,并在所有波次完成后把集成分支落地到 main。
进入条件:需提供里程碑编号;调度计划存在且可通过 dispatch_read(milestone_number=N) 读取;计划中所有条目均为 groomed: true;Backlog MCP 与 SAM MCP 正常响应;main 上 git 状态干净(若脏,运行 plugins/development-harness/scripts/prepare_clean_worktree.sh {integration-branch} 并接受或拒绝 stash 提示)。若计划缺失或过期,先运行 /groom-milestone {N}。
主要流程:加载并校验调度计划;创建集成分支 milestone/{N}-{slug}(GitHub 后端用 github_branches create,beads 后端用 git checkout -b);一次性抓取所有条目;按波次创建 worktree、写入 .claude/kage-bunshin.lock 锁文件、通过 spawn.py 启动会话;等待全部会话退出并读取结果 JSON;按返回顺序依次合并 worktree 分支,处理冲突;构建发现中继文档注入下一波提示;最后运行完整质量门禁,通过后执行 git switch main、git merge --no-ff milestone/{N}-{slug}、git push origin main,并调用 /complete-milestone {N}。
限制与错误处理:计划缺失时阻塞并提示重新 groom;条目在 groom 后变化需重新生成计划;Backlog 或 SAM MCP 不可用报进程错误;集成分支已存在需检查是否为陈旧分支;会话非零退出时读取错误日志,可修复则重试,否则跳过;存在阻塞或失败任务行时为其创建 backlog 条目并加入里程碑;质量门禁全部失败需先升级给用户;main 在期间分叉需先 rebase。worktree 分支仅本地存在,不推送、不创建 PR。模型选择上,--model 仅控制被启动会话的编排模型,子代理按各自 frontmatter 定义使用模型。