用途:这是“编写/评审架构文档”配对中的评审一半。当一份已完成的整体系统架构文档(含其关联 ADR 文件)需要做出接受或修改决定时使用,例如工程师将据此开发、功能技术设计需在架构中定位、修订后复审,或对已批准文档的变更请求做增量范围评审。它只判断,不撰写、修复或重写文档。
主要能力:按固定的 10 项架构质量检查表逐条判定通过或缺口,包括上下文与边界、结构与抽象层级、图与叙述同步、ADR 机制(索引与文件双向同步、每个 ADR 单一决策、已接受 ADR 不得改写)、重大决策的驱动因素与真实备选、NFR 落地与权衡、横切关注点、需求/ASR 覆盖、假设显式且不编造、以及增量变更的范围与涟漪处理。最终输出一行机器可解析的 VERDICT: approve 或 VERDICT: revise,并附可执行发现(失败条件、具体位置、修复方式)。
使用方式:以独立评审者视角通读架构文档,同时持有链接的 ADR 文件、上游 PRD 及文档引用的 api-spec/data-model;逐条判定条件,仅在有真实、具名缺陷时判失败;随后输出裁决与发现。若未提供 ADR 文件,条件 4 标记为不可验证,不得编造内容。
适用场景:架构文档的验收门禁、修订后复审、增量变更评审。不适用于撰写或修复架构文档、评审 PRD、评审单个功能技术设计、评审 api-spec/data-model、评审通用设计文档/RFC/独立 ADR,或检查模板章节一致性。
限制:不撰写或修改文档;不新增私有条件;C4/arc42/ATAM/4+1 等仅为作者技法,按结果判定而非强制要求;无能力记录时能力覆盖项为不适用;绿地首版不要求变更日志;不得为凑长度制造缺口。