用途:将执行过程中发现的、应归属于当前里程碑末尾的计划工作,以顺序阶段形式追加到路线图。
主要能力:自动读取 .planning/ROADMAP.md 与 .planning/STATE.md;定位“## Current Milestone:”标题,解析该里程碑下已有阶段编号(忽略 4.1 这类小数),取最大整数加一作为新阶段号并格式化为两位;生成 slug 与阶段目录 .planning/phases/pending/{NN}-{slug}/;在路线图中插入新阶段条目(含 Goal、Depends on、Plans 等占位内容);更新 STATE.md 的 Next Phase 与 Roadmap Evolution;若路线图为旧格式,会调用 kata-doctor 自动迁移。
使用方式:/kata-add-phase <description>,例如 /kata-add-phase Add authentication;或使用 /kata-add-phase --issue <issue-file-path>,从 issue 文件 frontmatter 提取 title、provenance,若 provenance 为 github:owner/repo#102 则记录 ISSUE_NUMBER 并在阶段中加入 Closes #102。无参数时报错并提示用法。
适用场景:在里程碑执行中新增后续阶段,且希望保持阶段顺序与编号连续。
限制:不修改当前里程碑之外的阶段,不重编号已有阶段,不使用小数编号(小数编号属于 /kata-insert-phase),不创建具体计划(属于 /kata-plan-phase),不自动提交变更。若描述涉及横向分层、纯基础设施或延续上一阶段未完成工作,会提示可能不符合垂直切片原则并给出替代选项。缺少 .planning/ROADMAP.md 时报错退出。