https://arc42.org/overview 这里给了模板和样例 https://zh-style-guide.readthedocs.io/zh-cn/latest/ 这里给了写作风格指南 两个结合起来就是一篇合格的设计文档了

@Betsy 能把设计文档写清楚的人还是很厉害的， 能写他人之所想，想他人之未想； 知道哪些该写，哪些不该写（可能在评审的时候能被喷死）； 能准确表达自己的思想，准确向干系人传递设计方案 从经验来看，这个能做好的人，工程能力不会太差

https://i.imgur.com/Ug1iMq4.png 依照 2 年前我在 v 站的讨论, OpenAPI spec 先行的理论做法被一致批评

文档也让 cursor 来写就好了，不过前提是你后端代码清晰，设计比较好

写完代码以后再用大模型逆推文档不应该更容易吗

我理解设计文档写好是必要的，也是基本的。要老板眼前一亮还是得有全局视角的规划，不限于业务规划、技术规划或者有明显的技术革新方案能提效降本。

只要后端开发完了文档就出来了(使用 ai 或者 swagger),不过这就涉及到一个争论点,先有文档还是先有接口?