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 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/architecture-review-x-5/raw/index.md(查看排版版本)