用途:在执行过程中发现紧急工作时,将其作为小数阶段插入既有阶段之后,无需重新编号整个路线图。
主要能力:解析阶段号与描述,校验参数;检查并自动迁移旧版 ROADMAP.md 格式;在路线图中定位目标阶段,计算下一个可用小数后缀(如 72 无小数则为 72.1,已有 72.1 则为 72.2);创建阶段目录 .planning/phases/pending/{N.M}-{slug}/;在目标阶段内容之后插入带 (INSERTED) 标记的新阶段条目;更新 .planning/STATE.md 的 Roadmap Evolution 记录。
使用方式:命令为 /kata-insert-phase <after> <description>,例如 /kata-insert-phase 72 Fix critical auth bug。需存在 .planning/ROADMAP.md,且目标阶段属于当前里程碑。插入后可用 /kata-plan-phase {decimal_phase} 拆分计划。
适用场景:里程碑执行中出现的紧急修复或临时任务,需要保留原阶段逻辑顺序时。
限制:不用于里程碑末尾的计划工作(应使用 /kata-add-phase);不在阶段 1 之前插入;不重排既有阶段;不修改目标阶段内容;不创建计划;不自动提交更改。资料未提供收费、平台与效果信息。