architecture-review

评估架构决策与ADR合规性,分析耦合度

代码质量 后端开发全栈开发 评审代码设计 通用 ★ 1.1k 更新于 2026-07-31

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:architecture-review。
它的用途是:评估架构决策与ADR合规性,分析耦合度
完整的 Skill 内容见:https://321skill.com/skills/architecture-review-x-3/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'请评估当前项目的架构决策,检查ADR合规性并分析模块间耦合度',它会自动扫描项目中的ADR文件、架构文档和代码,输出耦合度热力图、ADR合规性检查清单以及具体的改进建议,例如'订单模块与支付模块耦合度过高,建议引入事件驱动解耦'。

介绍

架构评审是技术债务管理中的关键环节,但人工评审往往依赖个人经验且耗时巨大。本Skill通过自动化分析架构决策记录(ADR)的合规性、评估模块间耦合度,帮助团队在早期发现设计隐患,避免因架构腐化导致的返工成本。它支持多种架构描述语言和代码仓库,可快速输出结构化报告。

使用方式简单:只需提供项目根目录路径或ADR文件目录,Skill会自动识别并解析架构文档、代码依赖关系,生成包含耦合度热力图、ADR合规性检查清单、改进建议的完整报告。你还可以通过参数自定义检查规则,例如忽略特定模块或调整耦合阈值。

适合负责系统设计的后端开发、全栈开发以及技术负责人。对于正在进行微服务拆分、模块重构或引入新架构模式的团队尤为实用,也可用于日常CI/CD流程中作为质量门禁。

建议每周运行一次或在关键架构变更后执行。注意本Skill的准确性依赖ADR文档的完整性和代码注释的规范性,若项目缺乏架构文档或记录混乱,可先结合人工梳理。

核心特点

同类大多聚焦代码规范或静态分析,而本Skill专门针对架构决策层面的ADR合规性和跨模块耦合度分析,能识别出文档与实践之间的偏差,并给出可量化的耦合评分。

注意事项

不适合尚未建立ADR制度或架构文档完全不存在的项目,此时分析结果参考价值有限。

常见问题

如何安装这个Skill?

执行 npm install -g architecture-review 即可全局安装。

支持哪些语言或框架?

支持Java、Python、TypeScript等主流语言,以及Spring Boot、微服务等常见架构风格。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/architecture-review-x-3/raw/index.md 读取 architecture-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。