用途
kata-plan-milestone-gaps 用于在里程碑审计完成后,把审计发现的缺口(gaps)转化为可执行的修复阶段。它读取 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 各状态下的阶段目录,找到最高编号后继续递增。
- 向用户展示缺口关闭计划,等待确认后更新 ROADMAP.md 并创建阶段目录。
- 根据配置决定是否提交规划文档到 git。
使用方式
该技能通过触发词 "plan milestone gaps" 或 "plan gaps" 调用。执行流程如下:
- 预检:检查 ROADMAP.md 格式,若为旧格式则自动调用 kata-doctor 进行迁移。
- 加载审计结果:查找最新的 v*-MILESTONE-AUDIT.md 文件并解析缺口。若无审计文件或无缺口,则报错提示先运行 /kata-audit-milestone。
- 优先级排序:按 must/should/nice 分组,集成/流程缺口根据受影响需求推断优先级。
- 分组为阶段:将相关缺口聚类为逻辑阶段。
- 确定阶段编号:从现有最高阶段编号继续。
- 展示缺口关闭计划:列出拟议阶段、关闭的缺口、任务数量,以及可选的 nice-to-have 缺口,等待用户确认(yes / adjust / defer all optional)。
- 更新 ROADMAP.md:在当前里程碑下添加新阶段条目。
- 创建阶段目录:在 .planning/phases/pending/ 下创建 {NN}-{name} 目录。
- 提交路线图更新:根据 commit_docs 配置决定是否执行 git add 和 git commit。
- 提示后续步骤:建议运行 /kata-plan-phase {N} 规划第一个缺口关闭阶段,并列出其他可用命令。
适用场景
- 里程碑审计后发现需求未满足、跨阶段集成缺失或端到端流程断裂,需要系统性地创建修复阶段。
- 希望一次性为所有缺口创建修复阶段,而不是逐个手动添加。
- 需要按优先级和依赖关系组织修复工作,确保先修复桩再接线。
限制
- 依赖 MILESTONE-AUDIT.md 文件的存在;若无审计文件或无缺口,技能会报错并提示先运行 /kata-audit-milestone。
- 需要 .planning 目录结构(PROJECT.md、REQUIREMENTS.md、ROADMAP.md、STATE.md)以及 scripts/kata-lib.cjs 脚本。
- 阶段编号依赖现有阶段目录的扫描结果。
- 是否提交 git 取决于 commit_docs 配置和 .planning 是否被 git 忽略。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。