architecture-review
评估架构决策与ADR合规性,分析耦合度
安装使用
复制下面这段提示词发给你的 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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/architecture-review-x-3/raw/index.md(查看排版版本)