用途:按波次(wave)并行执行某阶段内的所有计划,并完成阶段收尾。触发词包括“execute phase”“run phase”等。
主要能力:编排器保持精简,负责发现计划、分析依赖、按波次分组、派生子代理并收集结果;每个子代理加载完整 execute-plan 上下文并处理自己的计划。上下文预算约为编排器 15%、每个子代理全新 100%。支持 --gaps-only 标志,仅执行 frontmatter 中 gap_closure: true 的缺口关闭计划(通常在 phase-verify 生成修复计划后使用)。
使用方式:读取 .planning/ROADMAP.md 与 .planning/STATE.md;通过 node scripts/kata-lib.cjs read-config 读取模型配置(默认 balanced),并读取 workflows.execute-phase 的 post_task_command、commit_style、commit_scope_format 等偏好;读取 github.enabled、github.issue_mode、worktree.enabled、pr_workflow 等配置。用 bash "scripts/find-phase.sh" "$PHASE_ARG" 校验阶段并获取 PHASE_DIR、PLAN_COUNT、PHASE_STATE;阶段从 pending 移入 active。若启用 PR 工作流,先创建阶段分支并提交激活变更,再按波次创建计划 worktree、并行派生执行器、等待完成后合并 worktree、校验 SUMMARY、更新 GitHub issue 复选框,首波后创建草稿 PR。随后汇总结果、提交编排器修正、运行项目测试套件(gap 阶段跳过)、派生验证器生成 VERIFICATION.md,并按需更新代码库索引。
适用场景:需要按依赖波次并行推进多计划阶段、并自动完成分支/PR/验证/索引更新的开发流程。
限制:worktree 与 PR 相关操作仅在对应配置开启时执行,默认关闭;验证器为自动化代码库检查,非面向用户的 UAT;合并失败会报告但继续,需人工解决冲突后重跑;模型选择依赖配置与查找表。其余细节资料未提供。