用途:帮助用户将 .spec-driven/specs/ 中的规格与仓库中已存在的行为同步,属于文档类技能,不修改产品代码。
主要能力:支持仓库级或指定目录、模块、功能范围的扫描;先读取 .spec-driven/config.yaml、.spec-driven/specs/INDEX.md 及相关主规格文件,再检查所选范围内的代码、测试和附近文档,将发现分类为:代码中已确认但规格缺失的行为、过时或不完整的现有需求、需人工确认的模糊发现、无明显漂移的区域。
使用方式:先确认 .spec-driven/ 目录存在,可用 ls .spec-driven/ 检查;若不存在需先运行 /spec-driven-init。确定扫描范围后读取规格上下文与仓库证据,在聊天中报告漂移摘要,获得用户明确确认后再编辑规格文件,添加、修改或删除 ### Requirement: 块,并维护 mapping.implementation 与 mapping.tests frontmatter。完成后运行 node {{SKILL_DIR}}/scripts/spec-driven.js init 刷新 INDEX.md;若映射 frontmatter 有变化,再运行 node {{SKILL_DIR}}/scripts/spec-driven.js verify-spec-mappings。最后在聊天中总结新增、修改、删除的规格文件及未解决的模糊发现。
适用场景:需要让规格文档与现有代码行为保持一致、发现规格缺口或过时需求时。
限制:仅处理文档,不改产品代码;不创建变更、不写独立报告文件;编辑前必须获得用户明确确认;只将可观察行为写入规格,不把内部实现细节当作需求;范围扫描后不得暗示覆盖全仓库。