系统架构设计

解决的核心问题

做系统架构设计时，团队常面临几个实际困扰：需求和约束没捋清就急着出方案，导致后续频繁返工；技术选型只看单点优势，忽略长期维护成本和演进空间；关键决策没有明确记录，后来想追溯 "为什么这么选" 时找不到依据；产出的架构图和文档太零散，下游开发、运维团队没法直接参考落地。

技能如何工作

这个技能以系统架构师的角色切入，分5步推进设计：

• 第一步澄清目标：先对接用户自然语言描述的需求、约束，明确性能、可用性、成本等核心质量属性，避免盲目设计。
• 第二步方案设计：拆解系统组件、边界、数据流和部署方式，形成初步架构轮廓。
• 第三步权衡取舍：列出多个候选方案，分析各方案的优劣势，撰写ADR记录关键决策的上下文、结论和影响。
• 第四步质量自检：核对单点故障风险、系统可演进性、可观测性三个关键维度。
• 第五步输出工件：生成结构化的 ArchDecision（含标题、上下文、决策、影响、状态），附自然语言摘要和2-3点最该优化的建议，方便下游衔接。

适用边界与注意点

这个技能聚焦高层架构设计和决策记录，不负责具体语言的实现细节（这类需求需交给对应框架专家）；它能提供专业架构思路和权衡建议，但不能替代业务方的最终决策。