用途
kata-plan-milestone-gaps 用于在里程碑审计（milestone audit）之后，把审计发现的各类缺口（gaps）转化为可执行的修复阶段（phases）。它读取 MILESTONE-AUDIT.md，将缺口分组为逻辑阶段，写入 ROADMAP.md，并创建阶段目录，从而避免逐个缺口手动添加阶段。
主要能力
- 读取并解析 MILESTONE-AUDIT.md 的 YAML frontmatter，提取结构化缺口：
- gaps.requirements：未满足的需求
- gaps.integration：缺失的跨阶段连接
- gaps.flows：断裂的端到端流程
- 按 REQUIREMENTS.md 中的优先级对缺口排序：must（创建阶段，阻塞里程碑）、should（创建阶段，推荐）、nice（询问用户是否纳入或推迟）。集成/流程缺口根据受影响需求推断优先级。
- 将相关缺口聚类为逻辑阶段，分组规则包括：同一受影响阶段合并、同一子系统（auth、API、UI）合并、按依赖顺序（先修复桩再接线）、每个阶段保持聚焦（2-4 个任务）。
- 确定新阶段编号：扫描 active、pending、completed 各状态下的阶段目录，找到最高编号后继续递增。
- 展示缺口关闭计划，等待用户确认（yes / adjust / defer all optional）。
- 更新 ROADMAP.md，在当前里程碑下新增阶段条目，包含目标、需求 ID 和缺口关闭说明。
- 创建阶段目录：.planning/phases/pending/{NN}-{name}。
- 提交路线图更新：检查 commit_docs 配置，若为 true 则执行 git add 和 git commit。
- 提供后续步骤提示，如 /kata-plan-phase {N}、/kata-execute-phase {N}、/kata-audit-milestone、/kata-complete-milestone {version}。
使用方式
该技能通过触发词 "plan milestone gaps" 或 "plan gaps" 调用。执行流程包括：
- 预检：检查 ROADMAP.md 格式，若为旧格式则自动迁移（调用 kata-doctor --auto）。
- 加载审计结果：查找最新的 v*-MILESTONE-AUDIT.md，解析缺口。若无审计文件或无缺口，报错提示先运行 /kata-audit-milestone。
- 优先级排序。
- 分组为阶段。
- 确定阶段编号。
- 展示缺口关闭计划并等待确认。
- 更新 ROADMAP.md。
- 创建阶段目录。
- 提交路线图更新。
- 提供后续步骤。
适用场景
适用于使用 kata-skills 进行里程碑管理的项目，在完成里程碑审计后，需要系统性地规划并创建修复阶段以关闭所有审计缺口。
限制
- 依赖 MILESTONE-AUDIT.md 文件，若不存在或无缺口则无法执行。
- 需要 .planning 目录结构及 ROADMAP.md、REQUIREMENTS.md、STATE.md 等文件。
- 提交行为受 commit_docs 配置和 .planning 是否被 git 忽略影响。
- 具体收费、价格、平台支持等信息暂未提供。