architecture-review
architecture-review 是一个面向架构决策的代码评审技能(skill)。当代码变更涉及架构决策、新模块、数据流变更或系统设计时使用,例如 PR 引入新服务、改变接口或数据流等场景。它扮演 staff 级工程师角色,专注于发现单元测试和 linter 无法捕捉的设计问题,包括错误的抽象、泄漏的边界、遗漏的边界情况与扩展性陷阱。评审流程包括:理解意图(阅读 PR 描述、关联 issue 或规格,区分核心需求与附带复杂性)、数据流分析(从输入边界、转换链、存储到输出边界逐步追踪)、依赖方向检查(依赖应指向内部,标记领域逻辑引用基础设施、循环依赖和 god module)、错误与边界情况审计(超时、部分失败、并发访问、下游不可用、10 倍负载)、API 契约评审(向后兼容性、错误响应一致性、幂等性、限流与滥用风险)。每条发现按 [ARCH-NNN] 编号,标注严重程度(Critical/High/Medium/Advisory)与类别(Data Flow/Dependency/Concurrency/API Contract/Scalability),并给出具体替代方案。同时会标记分布式单体、chatty 接口、共享可变状态、过早抽象、缺少熔断、schema 耦合等反模式。