Software Design Evidence

导言

AI 相关需求经常采用敏捷方式推进:先完成最小穿刺,遇到问题再解决问题。这种方式可以快速消除技术未知,却容易留下另一类债务:需求散落在聊天和 issue 中,关键取舍没有 ADR,安全与可靠性只在事故后出现,性能结果只有一张截图,最终很难回答“你究竟设计了什么,为什么这样设计,怎样证明它有效”。

任职要求要看的不是文档篇幅,而是从问题到结果的可复核判断链。一份合格的软件设计材料应该同时连接需求/Top 问题、架构视图、质量属性场景、候选方案、设计原则与模式、代码提交、测试/Profiling/运行证据,以及后续架构治理。缺失的环节应如实列为设计或代码工作,不能由 AI 根据最终代码补写成虚构的事前决策。

本文解释 4+1 视图、设计原则、GoF 23 个设计模式(不是 24 个)、安全威胁分析、可靠/可用性、可测试性、功能安全、体验、性能、架构治理和技术决策,并给出一个可复用的本地 Skill:输入需求和穿刺代码 commits,输出软件设计文档、任职举证报告、追踪矩阵与缺口清单。

Read more