用途:在实现前评估拟议架构,或评估现有系统的可扩展性、可维护性与安全性,也可用于评审架构决策记录(ADR)和开展技术债评估。与逐行代码评审不同,它聚焦系统级设计。
主要能力:梳理系统上下文与外部依赖;评估耦合(依赖方向、接口边界、共享状态、数据库耦合、时序耦合)与内聚;按 SOLID 五项原则逐条检查;评审 API 设计的一致性、版本化、错误处理、认证授权、限流、文档与幂等性;评估可扩展性与可靠性(无状态、数据库扩展、缓存、故障处理、可观测性、数据一致性);盘点技术债并给出严重度、影响与工作量;评审 ADR;最终输出含执行摘要、优势、按严重度分级的关注点、技术债摘要与后续步骤的报告。
使用方式:需要提供系统代码库或架构文档(图、ADR、README),以及系统用途、规模与约束的上下文;可选提供非功能需求、团队规模与技能构成、技术约束、已知痛点。可按步骤执行,示例命令如 npx madge --circular src/ 用于检测循环依赖。
适用场景:架构方案评审、系统扩展或功能扩张前的就绪评估、技术债评估、ADR 评审。
限制:不适用于 PR 级代码质量反馈;不应强制指定具体技术;需考虑团队与组织约束,避免过度设计与完美主义;若缺少架构文档,需从代码结构、配置和部署文件推导上下文;若未记录非功能需求,建议先定义。相关技能包括 security-audit-codebase、configure-git-repository、design-serialization-schema、review-data-analysis。