SuperAPI AI 工具集

kiro-spec-status

编程与开发

查看项目

更新于 11-09 09:54

技能介绍

kiro-spec-status 是一个规格状态查看工具,属于 gotalab/cc-sdd 项目。其核心用途是展示指定规格(specification)的当前状态与进度,帮助使用者了解规格在开发流程中所处的阶段、完成情况以及下一步需要执行的操作。

主要能力包括:读取 {{KIRO_DIR}}/specs/$1/spec.json 获取元数据与阶段状态;读取 brief.md、requirements.md、design.md、tasks.md 等文件;检查目录中可用的文件;若存在 steering/roadmap.md 且该规格出现在其中,也会读取以了解上游依赖与相邻规格更新情况。随后分析各阶段:统计需求数量与验收标准;检查设计中的架构、组件、图表以及边界部分是否齐全;统计任务列表中已完成与未完成的任务数量(通过解析 - [x] 与 - [ ] 标记);检查 spec.json 中的审批状态。此外,还会从 brief.md 中提取边界候选、上游/下游、已有规格接触点等信息;从 design.md 中提取边界承诺、边界外内容、允许的依赖以及重新验证触发条件;从 roadmap.md 中识别上游依赖以及该规格是否与已有规格更新相邻。最后生成重新验证关注清单,识别可能因本规格变更而需要重新验证的下游规格、相邻已有规格更新或对发布敏感的设计说明,并在当前规格范围过宽时提示可能需要进行路线图或设计拆分而非局部修补。

使用方式:通过指定规格标识运行该技能,技能会输出一份报告,报告语言由 spec.json 中指定的语言决定。报告内容包括当前阶段与进度、各阶段完成百分比、任务分解(若存在任务则显示已完成与剩余数量)、边界上下文(上游/下游、边界外、允许依赖等,若可用)、重新验证关注清单、下一步行动以及阻塞项。若未找到指定规格,会提示“No spec found for $1. Check available specs in {{KIRO_DIR}}/specs/”并列出可用规格目录;若规格不完整,会警告缺失文件并建议下一阶段命令。不带参数或使用通配符运行时可列出所有规格及其状态。

适用场景:规格驱动开发流程中的进度追踪、阶段交接检查、变更影响评估、任务完成度统计以及阻塞项识别。

限制:该技能依赖 {{KIRO_DIR}}/specs/ 目录结构及上述文件的存在;缺失文件时只能给出警告与建议,无法生成完整分析;不提供自动化修复或执行后续阶段操作的能力;具体错误处理与回退逻辑以原始描述为准,其他细节暂未提供。