聊两句就能出能点的东西，这种快感很难拒绝。可很多项目不是死在不会用 AI，而是死在用了之后：说不清做了什么、改不动、交不出去、过两周没人敢碰。
圈子里叫氛围编程。快是真的，问题来得一样快。
1 实际使用里，这些坑几乎人人都会碰上
说不清系统到底承诺了什么。 能跑，只说明今天没当场垮。验收、对客、交接时，谁也指不出「当时认的是哪一版」。没有写下的承诺，就没有尺子。
同一句话，下次写出另一套。 换窗口、换模型、多说半句，实现就漂。两边都能圆，因为从来没有一份大家认的底。不是偶发抽风，是每次都在重新猜。
改一处，别处就怨。 助手只看见眼前这几轮对话，看不见整张图。登录、价格、接口、旧逻辑，常常是按下葫芦浮起瓢。更阴的是：已经不要的做法，会在某次修改里混回来，把刚改好的盖掉。
演示过关，接到真实使用就翻车。 好看的路径它会演。空数据、重复提交、中途退出、权限差一档、网络一抖，这些难看的事如果没人先写进设计，上线才算账。能跑不等于能用。
设计活在聊天里，窗口一关就开始忘。 过两周连自己都想不起来为什么那样做。人一换，代码还在、依据没了，等于从零猜。越改越乱，最后只能推倒——这就是大家说的快速腐烂。
人对不齐，人和 AI 更对不齐。 「就按上次那个」谁也说不清是哪个。产品、研发、助手各记一版，吵到后来不是对错，是依据根本不在场。没法协作，也没法把活交出去。
看起来快，收拾更久。 前几天进度吓人，后面几周全员盯着填坑。局部写得飞快，整体没人兜着，账会在后期一起算。
这些问题很少单独出现。共同点很土：走得太快，什么经得起用的都没留下。
2 解决办法：先留下能依据的设计
少用 AI 没用，速度也回不去了。继续空着手聊，只是把翻车往后推。
能按住的，还是把要做成什么样写下来，再动手。不是写没人看的说明书，是留下一份人能看懂、能拍板、AI 能跟着做的设计。承诺在纸上，验收才有尺子；人和助手共用一份底，换会话也不至于整张脸换掉；改需求知道该动哪，不用靠回忆；难看的约束先写再编码；设计跟项目待在仓库里，后来者还找得到。
普通随手文档往往不够。过两天自己都不认；AI 生成的长文看起来完整，内部对不上，改一处找不到牵连。要当实现的依据，就得经得起审、经得起改、经得起换人。这就是规范化设计文档在这儿的意思。
顺序倒过来：你拍板，它按文档实现。快感会少一点，后面那种不敢动，也会少很多。
3 design-doc 怎样把这件事做下来
design-doc 是开源工具，帮你编制这种文档。规矩装进你自己的仓库，Cursor、Claude Code、VS Code 这些常用助手都能跟着写。你用普通话说话，它按规范落设计，而不是再吐一堆很快过期的散文。
它做的几件最要紧的事：
把该交代的摊开——为什么做、谁在用、系统必须有什么、怎么拼、怎么验。你补判断，不必从零想文档长什么样。小功能不必从战略 1写起，大项目可以从「为什么做」往下铺，按需写，不必一次写全套。
每条设计有固定位置和编号，互相指得过去，不用「见上一节」。不用了也不偷偷删号，免得废弃逻辑再混回来，也知道改一处会扯到谁。
没拍板的不当作实现依据。还在商量的就是还在商量，定下来的才能拿去写代码。正式内容要改，也得经过你，不能下一轮对话随手覆盖。草稿和定稿搅在一起，是很多腐烂的源头。
设计跟代码待在同一个项目里，不锁在聊天、网盘、某个人脑子里。开源的意义也在这儿：规矩跟着项目走，不绑死哪一家平台。
它解决不了「你自己都没想清楚」。想清楚并拍了板之后，它让这份东西还能被下一次修改、下一个人、下一次会话找回来。氛围编程缺的，往往就是这个找得回来。
4 开源，免费，可商用
已经在用 AI 写代码，并且碰上过上面那些坑的人，都用得上。
design-doc 采用 MIT 许可，个人和公司都可以用、可以改、可以放进自己的仓库。
https://github.com/reddishz/designdoc
装进去，把要做成什么样说清楚。你拍板，它按文档实现。
GitHub: design-doc | 技能介绍: designdoc