SuperAPI AI 工具集

kata-insert-phase

通用与其它

查看项目

更新于 10-15 21:49

技能介绍

用途:在项目执行过程中发现紧急工作时,将其作为小数阶段插入到指定阶段之后,无需重排整个路线图。

主要能力:读取 .planning/ROADMAP.md 与 .planning/STATE.md;校验参数与阶段号;检测旧版路线图格式并调用 kata-doctor 自动迁移;查找目标阶段并确认其处于当前里程碑;扫描已有小数后缀,计算下一个编号(如 72 无小数则为 72.1,已有 72.1 则为 72.2);创建阶段目录 .planning/phases/pending/{N.M}-{slug}/;在路线图中插入带 (INSERTED) 标记的新阶段条目;在 STATE.md 的 Roadmap Evolution 下记录插入事件。

使用方式:命令格式为 /kata-insert-phase <after> <description>,例如 /kata-insert-phase 72 Fix critical auth bug。需提供阶段号与描述两个参数,阶段号必须为整数。

适用场景:里程碑执行中出现的紧急修复或临时任务,需要保留原计划顺序时。

限制:不用于里程碑末尾的计划性工作(应使用 /kata-add-phase);不能在阶段 1 之前插入;不重编号既有阶段;不修改目标阶段内容;不创建具体计划(由 /kata-plan-phase 负责);不自动提交更改。缺少 .planning/ROADMAP.md 或目标阶段不存在时会报错退出。