利用 AI 建立系统架构决策框架与 ADR 文档

解决架构设计缺乏记录且随意性强的问题：通过 AI 引导的需求分析、权衡评估和 ADR（架构决策记录）编写，将碎片化的设计想法转化为标准化的技术方案。

为什么需要这个技能

在复杂系统的开发过程中，架构决策往往隐藏在开发者的脑海中或散落在聊天记录里。当项目规模扩大或人员变动时，后续维护者很难理解“为什么当初选择了这个方案”而没有选择另一个。

本技能通过一套标准化的决策流，强迫 AI 在给出设计建议前先分析约束条件、对比方案优劣，并最终输出 ADR 文档。它遵循“简单至上”原则，避免过度设计，确保每一个复杂度增加的决定都有据可查。

适用场景

• 启动新项目设计：需要从零定义系统拓扑、技术栈和交互模式时。
• 核心模块重构：在面对多种设计模式选择（如微服务 vs 单体）时进行权衡分析。
• 技术方案评审：需要向团队或客户提供正式的架构决策文档以达成共识。
• 分析反模式：审查现有设计是否存在潜在的架构风险或违背最佳实践的情况。

核心工作流

1. 上下文挖掘（Context Discovery）：AI 通过预设的问题集引导用户明确业务需求、技术约束及性能指标。
2. 模式筛选（Pattern Selection）：基于决策树在多种架构模式中筛选最匹配的方案，并识别潜在的“反模式”。
3. 权衡分析（Trade-off Analysis）：对候选方案进行维度对比（如可扩展性、维护成本、开发速度），明确每项选择的代价。
4. ADR 存档（ADR Documentation）：将最终决策记录在 ADR 模板中，包含状态、上下文、决定及后果，形成可追溯的知识库。

下载和安装

下载 architecture 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐