SuperAPI AI 工具集

blueprint-adr-validate

编程与开发

查看项目

更新于 10-15 23:49

技能介绍

用途:校验 ADR 之间的关系一致性、引用完整性与领域冲突,适合发布前审计、重构后检查或定期文档审查。

主要能力:发现 docs/adrs/ 下全部 ADR 并解析 frontmatter(number、id、created、modified、status、domain、supersedes、superseded-by、extends、relates-to);校验 supersedes/extends/related 目标是否存在、状态是否匹配、是否存在自引用与循环链;支持跨工作区引用(ADR-NNN、<workspace-path>/ADR-NNN、/ADR-NNN);检测 ADR 编号冲突与索引漂移;按 domain 分组标记潜在冲突与未打标签的 ADR;生成汇总报告。

使用方式:命令为 /blueprint:adr-validate [--report-only]。默认交互模式,会询问修复方式(自动修复、逐项审查、导出报告到 docs/adrs/validation-report.md、跳过)。编号检查脚本:bash ${CLAUDE_SKILL_DIR}/scripts/check-adr-numbers.sh --project-dir "$(pwd)";索引检查与重建:bash ${CLAUDE_SKILL_DIR}/scripts/generate-adr-index.sh --project-dir "$(pwd)" --check 与不带 --check 的写入模式。索引仅重写 <!-- ADR-INDEX:START --> 与 <!-- ADR-INDEX:END --> 之间的表格。

限制:需存在 docs/adrs/ 目录,否则报错;跨工作区未解析引用仅作警告;无 manifest 或 id_registry 时注册表检查静默;具体修复细节与报告格式见 REFERENCE.md。