设计新系统架构、评审现有设计或做架构决策时，用 ADR…

适用于新系统高层架构设计、现有架构评审、微服务拆分、ADR 撰写、技术选型、组件交互设计、可扩展性规划和基础设施模式选择。

适用场景

解决思路

1. 按核心工作流推进：理解需求→识别模式→设计→文档化→评审；需求覆盖未验证完整前不要继续。
2. 理解需求：收集功能性需求、非功能性需求和约束条件，并在继续前验证全部需求是否覆盖。
3. 识别模式：将需求匹配到架构模式；选择单体与微服务时参考 references/architecture-patterns.md。
4. 设计：创建架构并显式记录权衡，产出架构图。
5. 文档化：为所有关键决策编写 ADR。
6. 评审：与利益相关者验证；如果评审失败，带着已记录的反馈返回第 3 步重新设计。
7. 加载 references/architecture-patterns.md，用于指导单体与微服务的模式选择。
8. 加载 references/adr-template.md，用于记录架构决策。
9. 加载 references/system-design.md，用于完整系统设计模板。
10. 加载 references/database-selection.md，用于数据库技术选型。
11. 加载 references/nfr-checklist.md，用于收集非功能性需求。
12. 必须做：所有重要决策都用 ADR 记录。
13. 必须做：显式考虑非功能性需求。
14. 必须做：评估权衡，而不仅仅是收益。
15. 必须做：规划失败模式。
16. 必须做：考虑运维复杂度。
17. 必须做：在最终确定前与利益相关者评审。
18. 禁止做：不要为假设的规模过度设计。
19. 禁止做：不要未评估替代方案就选择技术。
20. 禁止做：不要忽略运维成本。
21. 禁止做：不要在未理解需求的情况下进行设计。
22. 禁止做：不要跳过安全考虑。
23. 设计架构时按输出模板提供：需求摘要（功能性 + 非功能性）。
24. 设计架构时按输出模板提供：高层架构图，优先使用 Mermaid。
25. 设计架构时按输出模板提供：以 ADR 格式记录关键决策及权衡。
26. 设计架构时按输出模板提供：技术建议及理由。
27. 设计架构时按输出模板提供：风险与缓解策略。
28. ADR 内容包含：状态、背景、决策、已考虑的替代方案、后果、权衡；可参考 references/adr-template.md 和示例。
29. Mermaid 架构图可使用 graph TD 语法表达：客户端（Web/移动端）→ API Gateway → Auth Service / Order Service；Order Service → Orders DB (PostgreSQL) 和 Message Queue (RabbitMQ)；Queue → Notification Service。

适用边界 · 注意事项

• 仅需要代码级设计模式时，不使用本技能。
• 仅做数据库设计而非数据库选型或架构决策时，不使用本技能。
• 没有架构决策、架构评审或可扩展性规划需求时，不必使用本技能。