用途:doc-adr-reviewer 是 ADR 质量保证层的审查技能,对 ADR 文档做深度内容分析(而非仅结构与格式校验),用于 ADR 生成后、人工编辑后、生成 SYS 前、定期审查以及正式架构评审时。ADR 尚不存在时应先用 doc-adr 或 doc-adr-autopilot;仅需结构与模式校验用 doc-adr-validator。
主要能力(按检查项):0. 结构合规(嵌套文件夹规则,BLOCKING,REV-STR001-003);1. 决策完整性(上下文、决策、理由、状态、日期);2. BRD 主题对齐(含 REV-BA001-004);2a. 图表契约合规(@diagram: c4-l3、sequence-*,数据影响决策需 dfd-l2);3. 后果覆盖(正/负后果、风险、缓解);4. 备选方案评估;5. 交叉引用完整性;6. 占位符检测(TODO/TBD);7. 命名合规(ADR.NN.xxxx);8. 上游漂移检测(强制缓存,默认监测 @bdd: 等模式,SHA-256 哈希比对,>20% 变化为严重)。
用法:/doc-adr-reviewer ADR-01;/doc-adr-reviewer docs/05_ADR/ADR-01_authentication_strategy.md;/doc-adr-reviewer all。报告写在 ADR 嵌套目录内,命名 ADR-NN.R_review_report_vNNN.md,自动递增版本;漂移缓存为 docs/05_ADR/.drift_cache.json。评分阈值:PASS ≥90,WARNING 80-89,FAIL <80。
限制:漂移缓存不可禁用,创建或访问失败报 REV-D006;哈希须真实执行 sha256sum 计算,占位值会被拒绝;资料未提供具体价格、平台支持范围与运行环境要求。