用途：将执行过程中发现的、应归属于当前里程碑末尾的计划工作，以顺序阶段形式追加到路线图。命令形式为 /kata-add-phase。
主要能力：读取 .planning/ROADMAP.md 与 .planning/STATE.md；定位“## Current Milestone:”标题，解析该里程碑下已有阶段编号（忽略 4.1 这类小数），取最大整数加一作为新阶段号并格式化为两位；生成 slug 并创建目录 .planning/phases/pending/{两位阶段号}-{slug}/；在路线图中插入新阶段条目（含 Goal、Depends on、Plans 等占位内容）；更新 STATE.md 的当前进度与 Roadmap Evolution 记录。
用法：/kata-add-phase <description>，所有参数作为阶段描述；或 /kata-add-phase --issue <issue-file-path>，从 issue 文件 frontmatter 读取 title 与 provenance，若 provenance 为 github:owner/repo#N 则提取编号并在阶段中写入 Closes #N。无参数时报错并提示用法。若检测到旧版路线图格式，会调用 kata-doctor 自动迁移。
限制：不修改当前里程碑之外的阶段，不重编号已有阶段，不使用小数编号（小数编号属于 /kata-insert-phase），不创建具体计划（属于 /kata-plan-phase），不自动提交变更。阶段描述若被判定为水平分层、纯基础设施或上一阶段延续，会提示改用垂直切片方案。缺少 .planning/ROADMAP.md 时报错退出。