用途:对项目路线图中的阶段进行灵活重组,包括跨里程碑移动和里程碑内重排。
主要能力:跨里程碑移动使用 /kata-move-phase 3 to v1.6.0;里程碑内重排使用 /kata-move-phase 3 before 1 或 /kata-move-phase 3 after 1。执行后会移动或重排阶段、重命名目录、更新 ROADMAP.md 与 STATE.md,并生成 git 提交作为历史记录。
使用方式:命令第二个参数决定操作类型,to 加里程碑版本为跨里程碑移动,before 或 after 加目标阶段编号为里程碑内重排。缺少参数或操作无效会报错退出。仅允许移动处于 pending 状态且没有 SUMMARY.md 的阶段;目标里程碑必须存在且与来源不同。重排时目标位置阶段需存在于同一里程碑。操作前会展示计划并等待确认。若检测到旧版 ROADMAP.md 格式,会调用 kata-doctor 自动迁移。目录重命名采用三趟临时名方式避免冲突,小数阶段随父阶段一起移动。是否提交由 commit_docs 配置决定。
适用场景:需要调整项目阶段归属或执行顺序时。
限制:不能移动 active 或 completed 阶段,不能移动已有执行计划的阶段,不能移动到同一里程碑,不能重排到相同位置,移动或重排后不能留下编号空缺,不能修改来源和目标里程碑之外的阶段。