SuperAPI AI 工具集

kata-plan-milestone-gaps

编程与开发

查看项目

更新于 10-16 06:55

技能介绍

用途

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" 调用。执行流程如下:

  1. 预检:检查 ROADMAP.md 格式,若为旧格式则自动调用 kata-doctor 进行迁移。
  2. 加载审计结果:查找最新的 v*-MILESTONE-AUDIT.md 文件并解析缺口。若无审计文件或无缺口,则报错提示先运行 /kata-audit-milestone。
  3. 优先级排序:按 must/should/nice 分组,集成/流程缺口根据受影响需求推断优先级。
  4. 分组为阶段:将相关缺口聚类为逻辑阶段。
  5. 确定阶段编号:从现有最高阶段编号继续。
  6. 展示缺口关闭计划:列出拟议阶段、关闭的缺口、任务数量,以及可选的 nice-to-have 缺口,等待用户确认(yes / adjust / defer all optional)。
  7. 更新 ROADMAP.md:在当前里程碑下添加新阶段条目。
  8. 创建阶段目录:在 .planning/phases/pending/ 下创建 {NN}-{name} 目录。
  9. 提交路线图更新:根据 commit_docs 配置决定是否执行 git add 和 git commit。
  10. 提示后续步骤:建议运行 /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 忽略。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。