用途:adr-critique 是面向遗留、外部导入、LLM 生成或从未自审过的 ADR 的逐行审计技能,用于发现规则违反、缺失 why、与相邻 ADR 的不一致以及与 LikeC4 模型的漂移。
主要能力:按六个阶段执行。阶段1读取目标 ADR,并通过 supersedes、amends、relates-to 链接读取相邻 ADR,若引用 LikeC4 文件则读取 **/*.c4。阶段2逐行标记违规,每条标记包含 Original、Violates、Rewrite、Apply?,等待架构师逐条回复后才继续。阶段3检查 Decision 部分是否以“行业标准”“最佳实践”等替代业务关切到架构特性的映射,标记 missing-why。阶段4检查张力、frontmatter 与正文关系镜像不一致、重复权威声明。阶段5对比 ADR 与 LikeC4 模型中的组件,标记漂移但不自动更新。阶段6一次性应用已批准编辑,只触碰批准行,不添加审计标记。
使用方式:在需要审计既有 ADR 时激活;不适用于已由 adr-drafting 自审过的 ADR,也不用于从头重写(应改用 adr-drafting 并取代原 ADR)。
限制:每条消息只提一个标记,禁止批量列出;重写必须短于原文,否则应转 adr-drafting;不得编辑 Accepted ADR 正文,仅允许拼写、图兼容头部、元数据关系链接、头部 superseded by 说明或底部带日期的 Amendments 注记;张力、漂移、missing-why 只标记,由架构师决定解决方式。结束时输出一行摘要。参考资料包括 references/audit-checklist.md、../_shared/adr-is-not.md、adr-drafting 技能和 c4-model 技能。