architecture-review

评估架构决策、ADR合规性与代码耦合度

安装使用

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

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

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

使用示例

‘请分析当前项目的src目录,检查其是否符合我们制定的微服务架构ADR文档,并给出模块耦合度报告。’,它会扫描代码库,比对ADR中的设计约束,识别出违反架构决策的代码片段,并计算各服务模块间的依赖关系,生成一份包含问题定位和改进建议的详细评估报告。

介绍

这个Skill旨在帮助开发团队分析和评估软件架构的质量。它主要解决在项目演进过程中,架构决策是否被有效遵循、架构设计文档(ADR)的合规性以及代码模块间的耦合度问题,帮助团队识别潜在的架构风险和技术债。

使用时,你可以向AI提供代码库路径或具体的架构决策文档,它会自动扫描和分析代码结构,检查其与既定架构模式(如ADR)的一致性,并计算模块间的依赖关系,从而评估耦合度。分析结果会以报告形式呈现,指出不符合项和高耦合区域。

该Skill非常适合后端开发、全栈开发、运维开发以及项目经理等角色,尤其是那些负责维护大型、长期演进项目的技术负责人和架构师,他们需要确保代码实现与架构蓝图保持一致。

建议在项目关键节点(如发布前、重构后)或引入重大变更时使用此Skill进行架构健康度检查。需要注意的是,其分析深度依赖于代码的可读性和文档的完整性,对于高度混淆或文档缺失的代码库,分析效果可能受限。

核心特点

与一般的代码质量扫描工具不同,它专注于架构层面的合规性检查,能关联架构决策文档(ADR)与实际代码实现,提供耦合度量化分析,而不仅仅是代码风格或漏洞检测。

注意事项

不适合分析文档极度缺失或代码结构极其混乱(如大量动态生成代码)的项目。

常见问题

它能分析哪些类型的架构文档?

主要支持Markdown格式的架构决策记录(ADR),能解析其中的决策内容和约束条件。

耦合度分析是基于什么指标?

通常基于代码的导入/导出关系、类/模块间的依赖数量、循环依赖等静态分析指标来评估耦合度。

给 AI 助手的安装指引

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

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