SuperAPI AI 工具集

spec-driven-resync-code-mapping

写作与研究

查看项目

更新于 10-16 06:22

技能介绍

用途:帮助用户在 .spec-driven/specs/ 中补齐或修复规格文件与实现文件、测试文件之间的映射 frontmatter。属于规划/文档类技能,不修改实现代码或测试,也不改写需求行为。

主要能力:提供三个命令:verify-spec-mappings 校验映射;audit-spec-mapping-coverage <spec-path> [--implementation <repo-path> ...] [--tests <repo-path> ...] 审计单个规格的映射覆盖;audit-unmapped-spec-evidence [--implementation <repo-path> ...] [--tests <repo-path> ...] 检查未被任何主规格映射的文件。

使用方式:先确认项目根目录存在 .spec-driven/(可用 ls .spec-driven/ 检查,失败则先运行 /spec-driven-init)。确定修复范围后,读取 config.yaml、specs/INDEX.md 及范围内主规格文件,运行 verify-spec-mappings 定位缺失、格式错误、非字符串条目和缺失文件。再依据仓库证据推断映射,实现文件与测试文件分开,路径使用仓库相对路径、文件粒度,不用行号或符号。对候选规格运行 audit-spec-mapping-coverage 与 audit-unmapped-spec-evidence,编辑前向用户展示将变更的规格文件及拟定的 mapping.implementation、mapping.tests 路径,等待明确确认后再仅修改映射 frontmatter,最后重跑 verify-spec-mappings 并汇报结果。

适用场景:规格映射缺失、格式错误、路径过期,或需要检查未被映射的仓库证据时。

限制:不修改实现代码或测试;不创建、修改、归档或取消 .spec-driven/changes/ 下的条目;修复映射时不改写需求行为;若发现行为与规格漂移,应改用 /spec-driven-sync-specs、/spec-driven-spec-edit 或常规变更流程;证据不足或冲突时标记为歧义并询问用户,不臆造覆盖。