architecture-review

介绍

解决什么问题：在软件架构演进过程中，架构决策记录（ADR）的合规性、模块间的耦合度以及架构设计的一致性常常被忽视，导致后期维护成本剧增。本Skill能够自动扫描项目中的ADR文档，检查其是否遵循既定模板与决策原则，同时分析代码库中模块间的耦合关系，生成可视化的耦合度报告，帮助团队快速识别架构腐化信号。

怎么用：将本Skill接入你的开发工作流后，只需对AI发出指令，例如“评审当前项目的架构决策，分析ADR合规性并评估模块耦合度”。它会自动读取项目中的ADR目录（如docs/adr/），解析每条记录的标题、上下文、决策和后果，对照预设规则（如是否包含状态、日期、替代方案等）进行合规性评分。同时，通过静态分析代码的依赖关系、接口调用和包结构，计算模块间的耦合指标（如扇入、扇出、循环依赖），并以表格或图表形式输出结果。

适合谁：适合后端开发、全栈开发以及技术负责人，尤其是正在进行微服务拆分、模块重构或架构治理的团队。如果你希望将架构评审从“人工主观判断”变为“量化可追踪”，这个Skill将极大提升效率。

使用建议：建议先统一团队内ADR文档的编写规范，再接入本Skill进行自动化检查。对于耦合度分析，建议结合项目实际使用的语言和框架，可能需要额外配置依赖扫描规则。注意：本Skill不涉及性能优化或代码风格检查，仅聚焦于架构层面的决策合规与耦合度。