用途:在执行过程中发现紧急工作时,将其作为小数阶段插入既有路线图,无需重新编号全部阶段。
主要能力:读取 .planning/ROADMAP.md 与 .planning/STATE.md;定位目标阶段(如 Phase 72),查找其已有小数后缀并计算下一个编号(无小数则为 72.1,已有 72.1 则为 72.2);创建阶段目录 .planning/phases/pending/{N.M}-{slug}/;在路线图中插入带 (INSERTED) 标记的新阶段条目;在 STATE.md 的 Roadmap Evolution 下记录插入事件。
使用方式:命令为 /kata:kata-insert-phase <after> <description>,例如 /kata:kata-insert-phase 72 Fix critical auth bug。第一个参数为整数阶段号,其余为描述。需存在 .planning/ROADMAP.md,且目标阶段须在当前里程碑中。
适用场景:里程碑执行中途出现的紧急修复或临时任务。
限制:不用于里程碑末尾的计划工作(应使用 /kata:kata-add-phase);不在 Phase 1 之前插入;不重排既有阶段;不修改目标阶段内容;不创建具体计划(由 /kata:kata-plan-phase 负责);不自动提交更改。