architecture-review
架构决策评审与ADR合规分析工具
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:architecture-review。 它的用途是:架构决策评审与ADR合规分析工具 完整的 Skill 内容见:https://321skill.com/skills/architecture-review-x-2/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'评审当前订单模块的架构决策,检查ADR-001到ADR-005的合规性,并分析订单模块与支付模块的耦合度。' 它会读取ADR文件,逐一核对决策记录是否完整,分析模块间依赖关系,生成耦合度评分表,并给出降低耦合的建议。
介绍
本技能专注于评估软件架构决策的质量,检查架构决策记录(ADR)的合规性,并分析模块之间的耦合度。它能够帮助团队在项目演进过程中保持架构的一致性和可维护性,避免因架构决策不当导致的技术债务。
使用方式:您可以直接对AI描述当前项目的架构决策或提供ADR文件,技能会自动分析这些决策是否符合团队既定的架构原则,检测ADR是否完整记录了上下文、决策、后果等关键要素,并量化模块间的耦合程度。它还会生成可视化的耦合度报告和改进建议。
适合架构师、技术负责人、项目经理以及参与架构评审的后端开发者。尤其适用于微服务架构、领域驱动设计等需要严格管控架构一致性的场景。
注意:本技能依赖项目已有的ADR文档和清晰的模块边界定义。如果项目缺乏架构文档或模块划分不明确,分析结果可能受限。建议结合代码静态分析工具(如代码扫描)共同使用,以获得更全面的架构健康度评估。
核心特点
与普通代码审查工具不同,本技能聚焦于架构层面——检查ADR的完整性和合规性、量化模块耦合度,而非关注代码风格或语法错误,弥补了架构评审自动化工具的空白。
注意事项
不适合没有ADR文档或模块边界模糊的项目,也无法替代人工对业务逻辑合理性的判断。
常见问题
这个技能能分析微服务架构吗?
可以,它支持分析微服务间的耦合度,并检查各服务对应的ADR是否合规。
需要提前准备什么文件?
需要项目中的ADR文件(通常为Markdown格式)以及定义模块接口的文档或代码元数据。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/architecture-review-x-2/raw/index.md 读取 architecture-review 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/architecture-review-x-2/raw/index.md(查看排版版本)