用途:在提交 PR 前或评审 PR 时,检查代码改动是否违反仓库中状态为 Accepted 的架构决策记录(ADR)。ADR 位于 handbook/engineering/decisions/,所有 Accepted 状态的 ADR 视为有约束力。也可作为更广泛评审(如 /polar-code-review)的一个维度。
主要能力:按改动遍历与文件所属领域(Backend、Frontend、Infra、Cross-cutting)匹配的 ADR;从每条 ADR 的 Decision 与 Consequences 推导违规特征并在改动块中查找;报告违规时给出 ADR 编号与标题、file:line、一行说明违反了什么规则及修复方向;无违规时仅回复“No violations”。
使用方式:1) 获取改动,优先分支 diff,其次工作区,例如 git diff --name-only main...HEAD、git diff --name-only、git diff --name-only --staged,再读取具体改动块 git diff main...HEAD -- <file>;若 PR 目标分支不是 main,则以其为基准。2) 动态加载 ADR:ls handbook/engineering/decisions/[0-9]*.mdx,逐条读取,只把 Status: Accepted 的条目作为规则,并按其 Area 限定适用文件。3) 对每个领域匹配的 Accepted ADR,读取 Decision 与 Consequences 推导违规特征,再在改动块中查找。不要硬编码 ADR 清单,ADR 文本是唯一事实来源。4) 报告保持简洁,不叙述检查过程、不列出适用与不适用的 ADR;违规按严重程度排序,每条引用 ADR 与具体位置。
适用场景:提交 PR 前自检、评审他人 PR、在架构决策层面验证改动。
限制:该技能只做评审与报告,不修改代码,修复需另行跟进。需要仓库中实际存在所需 ADR 文件与相应 git 历史,资料未提供具体 ADR 条目内容、平台与收费信息。