architecture-review
评估架构决策与ADR合规性
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:architecture-review。 它的用途是:评估架构决策与ADR合规性 完整的 Skill 内容见:https://321skill.com/skills/architecture-review-x/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'请审查我们这个微服务项目中所有ADR的合规性,并评估订单服务和用户服务之间的耦合度。' 它会读取你提供的ADR目录和代码结构,输出一份合规性检查清单,指出缺失的ADR项、决策理由不充分的地方,以及耦合度评分和改进建议。
介绍
该技能专注于对软件架构决策进行系统性审查,包括检查架构决策记录(ADR)的完整性、合规性,以及评估模块间的耦合度。它能够帮助团队在代码评审或架构评审阶段,快速识别架构层面的潜在风险,确保设计决策与项目目标一致,并降低因耦合度过高导致的维护成本。
使用时,你可以将项目的架构文档、ADR文件或代码库结构输入给该技能,它会自动分析架构决策的合理性、ADR的规范程度,并输出耦合度报告。例如,你可以要求它审查某个模块的架构决策是否符合团队约定,或评估两个服务之间的依赖关系是否合理。
该技能适合后端开发、全栈开发、项目经理等需要在架构层面把控质量的用户。特别适用于微服务架构评审、系统重构前的架构分析、以及新项目初期架构规范的制定。
建议将本技能与代码静态分析工具配合使用,形成从架构到代码的全链路质量检查。注意,它不适用于微观代码级别的审查,也不适合对业务逻辑的正确性进行验证。
核心特点
与通用的代码审查工具不同,本技能专注于架构层面的决策评估和ADR合规性,能自动识别架构决策记录中的缺失、矛盾以及模块间的耦合度异常,而不仅仅是检查代码风格或潜在Bug。
注意事项
不适合对具体代码行级别的逻辑错误或性能优化进行审查,也无法替代人工对业务需求的判断。
常见问题
这个技能可以自动生成ADR吗?
本技能侧重于评估现有ADR的合规性和完整性,不直接生成ADR。但你可以结合其他写作工具来创建ADR,再用本技能进行审查。
它支持哪些架构风格的耦合度分析?
支持常见的面向对象、微服务、分层架构等,主要通过分析模块间的依赖关系来评估耦合度,不限于特定风格。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/architecture-review-x/raw/index.md 读取 architecture-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/architecture-review-x/raw/index.md(查看排版版本)