SuperAPI AI 工具集

spec-coverage-map

智能体与模型

查看项目

更新于 10-15 23:42

技能介绍

用途:在实现阶段(Gear 6)之后或清理/文档收尾阶段,生成一份规格到代码的覆盖映射文档,直观展示规格与实现文件的对应关系,输出到 docs/spec-coverage-map.md。

主要能力:按规格列出所覆盖的代码文件(含状态与分类,如 Backend、Frontend、Infrastructure、Database、Scripts 等),生成规格到文件的 ASCII 方框图;构建“文件→规格”反向索引并标注被引数量;按类别统计覆盖率并绘制热力图;识别未被任何规格覆盖的缺口文件并给出建议;标出被 3 个及以上规格共享的文件并评估风险等级。

必要用法:先发现规格文件,例如 find .specify/memory/specifications -name "*.md" -type f 2>/dev/null 或 find specs -name "spec.md" -type f 2>/dev/null;再从各规格的 Files、Implementation Status、Components Implemented、Technical Details 等章节及代码块中提取文件路径;随后分类、生成图表、反向索引、覆盖率统计、缺口与共享文件分析。可手动触发,例如输入“Generate spec-to-code coverage map”,也可在 Gear 6 完成或清理阶段自动触发。

适用场景:需要核对规格与代码一致性、补充文档、发现遗留或未记录文件、评估共享工具耦合风险时。

限制:若未找到任何规格,或规格中不含文件引用,则无法生成;覆盖率过低(如低于 50%)会被提示规格可能不完整。路径需实际存在,否则在映射中标记为缺失。具体收费、价格与平台支持信息暂未提供。