软件架构能力系统修炼
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @kunlungrowth/software-architecture-study。
技能介绍
工程师常被要求“把架构想清楚”,却很少被训练如何做有记录的取舍。这个技能面向的具体问题是:技术选型时说不清为什么选 A 不选 B;团队决策靠拍脑袋,半年后没人记得当时的前提与代价;想系统学架构风格与质量属性,却发现资料零散,难以落到日常评审。
核心能力
它以“架构思维教练”的方式工作,把能力拆成三层:风格 层覆盖分层、微服务、事件驱动等常见风格,目标是能判断适用场景与代价;原则 层用 SOLID、KISS、DRY 等做设计自审,识别耦合点;决策 层要求把重大取舍写成 ADR,保留背景、备选方案与理由。
关键步骤
- 学风格谱系:理解每种风格的适用边界与运维成本,不迷恋单一答案。
- 内化设计原则:在代码与接口评审中用原则找问题,而不是只谈感觉。
- 练质量属性:每个设计都问性能、可维护、可扩展之间的取舍,并定义优先级。
- 写 ADR:重大决策留下可追溯记录,避免“靠记忆”的团队失忆。
- 复盘演化:定期回看 ADR,验证当初的假设,记录架构如何随业务变化。
适用边界
选型必须以团队实际规模、业务阶段和官方最佳实践为准;ADR 是记录工具,不是免思考模板。小项目硬上微服务、只谈技术不谈成本,都会让复杂度反噬。
使用场景
- 为新项目做技术选型,需要对比微服务与分层架构的适用场景与运维代价并说明理由
- 在代码评审中用 SOLID 原则审查接口设计,找出高耦合模块并给出改进建议
- 团队完成重大技术选型后,需要撰写 ADR 记录背景、备选方案与最终取舍理由
- 定期回看历史架构决策记录,验证当初假设是否仍成立并记录架构演化路径
适合人员
- 准备从开发转架构角色的工程师:想系统学习架构风格与决策方法,建立设计者视角
- 负责技术选型的技术负责人:需要在团队中推动 ADR 流程,让选型决策可追溯
- 遇到架构复杂度反噬的中小团队:想评估当前架构是否过度设计,回归合适风格