用途:从路线图中干净地移除已决定不做的工作,不污染上下文,不留下取消或延期标记。输出为删除阶段、后续阶段重新编号,并以 git 提交作为历史记录。
主要能力:校验目标阶段必须是未来且未开始的阶段;检查阶段目录中是否存在 SUMMARY.md,若有已完成工作则拒绝移除;删除阶段目录;对后续整数与小数阶段重新编号,并重命名目录内带阶段编号的文件;更新 ROADMAP.md 与 STATE.md,包括阶段总数、进度百分比和依赖引用;默认执行 git 提交记录变更。
使用方式:命令为 /kata-remove-phase <phase-number>,例如 /kata-remove-phase 17。必须提供阶段编号,否则报错退出。执行前会读取 .planning/ROADMAP.md 与 .planning/STATE.md,若检测到旧版路线图格式会先调用 kata-doctor 自动迁移。移除前会列出将删除和重新编号的阶段并等待确认。
适用场景:清理路线图中已决定不做的未来阶段,保持编号连续。限制:不能移除当前或已完成阶段;不能移除含 SUMMARY.md 的阶段;不修改已完成阶段目录;不添加“已移除阶段”说明,git 提交即记录。若阶段目录不存在,则跳过删除,仅更新路线图。小数阶段移除只影响同系列小数,整数阶段不变。