architecture-review

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

安装使用

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

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

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

使用示例

'请分析当前项目的src目录,检查其代码实现是否与我们docs/adr目录下的架构决策记录保持一致,并生成一份耦合度分析报告。' 它会扫描代码库,比对ADR文档,识别出违反决策的代码片段,并计算各模块的依赖关系,最终输出一份包含问题定位和改进建议的详细报告。

介绍

该技能旨在帮助开发团队评估和审查软件架构决策。它通过分析代码库,检查架构决策记录(ADR)的合规性,并识别模块间的高耦合问题,从而确保架构设计的合理性与一致性。

使用时,用户只需提供代码库路径或相关文档,该技能便会自动扫描并生成评估报告。报告会指出与已记录的ADR相冲突的代码实现,并高亮显示存在紧密耦合风险的模块,帮助开发者定位潜在的架构腐化点。

它非常适合后端开发、全栈开发和运维工程师,尤其是在进行代码重构、技术债务清理或新功能开发前进行架构健康度检查时使用。项目经理和测试工程师也可以利用其报告来评估项目的技术风险。

建议在项目关键节点(如版本发布前、重大重构后)定期运行此技能。需要注意的是,其分析深度依赖于项目内ADR文档的完整性和准确性,若文档缺失,评估效果会打折扣。

核心特点

专注于将书面架构决策记录(ADR)与实际代码实现进行自动化比对,而不仅仅是静态代码分析;能够量化并可视化模块间的耦合度,为架构演进提供具体数据支撑。

注意事项

不适合缺乏明确架构决策文档(ADR)或文档严重滞后的项目。

常见问题

这个技能能检查哪些类型的架构问题?

主要检查ADR合规性、模块/服务间耦合度、以及违反预设架构模式(如分层、微服务边界)的代码结构。

需要提前准备什么才能使用?

需要提供代码仓库访问权限,并建议项目拥有格式良好的架构决策记录(ADR)文档。

给 AI 助手的安装指引

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

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