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