软件架构设计指南
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-dev-architecture
技能介绍
要解决什么问题
架构评审里最常见的争论不是“哪个技术更先进”,而是缺少统一的判断依据:项目应该上微服务还是先做单体?事件驱动能解耦多少真实收益?Serverless 的运维边界划在哪里?质量属性之间互相冲突时,该牺牲可扩展性还是可观测性?这些问题如果没有结构化方法,很容易变成个人经验主导的拍脑袋决策。本技能把架构设计从“灵感驱动”拉回“需求驱动”,让模式选型有可复用的检查清单和权衡路径。
核心能力与工作方式
技能的核心方法围绕四个维度展开:需求驱动按体量、团队规模、演进速度定架构;模式选型覆盖 单体、微服务、事件驱动、Serverless 的权衡;质量属性评估 可用性、扩展性、安全性、可观测性;设计表达用 C4 分层图 与 时序图 把设计意图说清楚。
实际使用时按四个步骤推进:
- 明确目标与场景边界,先界定系统要服务的业务边界和约束条件。
- 逐项执行或自查,按需求、模式、质量属性、表达四层方法检查当前设计。
- 输出结构化结果,生成清单、分级或建议,而不是一段模糊结论。
- 标注不确定项,把需要人工复核的环节单独列出,避免把假设当成事实。
适用边界与注意点
适合在架构设计、architecture 评审、微服务/单体拆分、质量属性权衡、C4 图表达等场景提供方法论参考和清单支撑。不适合需要实时数据或外部系统直连的高频自动化任务,也不提供法律、医疗、财税等需要持牌专业人士出具的确定性结论。
需要特别留意的是,架构没有银弹,任何模式都有隐含成本。避免脱离团队实际能力做“过早优化”,尤其是为了未来可能的规模而提前引入微服务治理体系。所有建议都应结合当前工程能力、组织结构和交付节奏做二次判断。
使用场景
- 为新业务系统做架构选型,需要判断单体、微服务、事件驱动或 Serverless 中哪种模式更适合当前体量与团队规模
- 现有单体应用出现扩展瓶颈,需要在拆分微服务前评估可用性、可观测性等质量属性的代价
- 技术方案评审会上需要用 C4 分层图和时序图清晰表达系统设计意图,避免口头描述造成的理解偏差
- 团队要梳理架构演进路线,需要一份结构化的权衡清单来标注决策依据和不确定项
适合人员
- 后端工程师——负责核心服务重构,需要在单体与微服务之间选择合适时机与拆分粒度
- 系统架构师——组织技术方案评审,需要一套可复用的模式选型与质量属性权衡框架
- 技术负责人——评估新项目架构方向,需要结合团队规模和演进速度给出有依据的决策建议
- 技术布道师——向团队推广架构设计方法论,需要结构化的清单和步骤来替代经验式讨论