ARTICLE · 1372852
以前先写文档再写代码,现在反过来了:AI把项目方法论整个倒转
技术观察 · 方法论
以前先写文档再写代码现在反过来了AI 把项目方法论整个倒转
大模型为什么会一本正经地胡说八道:因为它
干过项目的人都知道老规矩:先立项,再写需求文档,再写设计文档,评审签字,然后才轮到开发写代码。文档在前,代码在后——这个顺序天经地义了几十年,从没人怀疑过。
但这两年带项目,我发现自己和团队的做事顺序悄悄变了:先让 AI 快速搓一个能跑的原型(POC),拿去演示、试错、迭代,跑通了、确认方向对了,再回头补文档。
一开始我以为这只是“偷懒”,后来想明白了:这不是顺序的小调整,这是软件工程方法论的一次整体倒转。今天把它讲透。

一、老顺序为什么成立:代码贵,纸便宜
先要想清楚:为什么以前必须文档先行?不是因为先人迂腐,是因为经济学。
传统项目里,写代码是最贵的动作:一个熟练工程师一天写不了几百行,改一次需求的成本是一整条链的返工。而写文档便宜,改一段文字就是打几个字。所以理性的策略是:用便宜的纸面推演,把所有不确定性提前消灭,再动用昂贵的代码。
需求文档、设计文档、评审会、签字确认——整套流程的目的只有一个:确保代码这发昂贵的子弹打出去之前,方向已经是想清楚了的。评审会拦住一个错误设计,省下的是几十人天的返工。文档先行,本质是一张纸面的保险单。
但代价也是明摆着的:纸面上想清楚的,和真实跑通的,永远隔着一条鸿沟。文档写得再漂亮,客户签字签得再郑重,第一版系统跑起来那天,该冒出来的意外一个都不会少。我们只是在纸面上把意外“想象掉了”,没有真正消灭它。
二、AI 干了什么:把“试一遍”变得比“想半天”还便宜
现在 AI 把天平的另一端砸了:写代码不再贵了。
以前一个报表工具、一个接口 demo、一个流程验证,认真做要一周;现在把需求讲给 AI,几个小时能搓出一个能跑的原型。哪怕客户环境进不去,先在本地把逻辑跑通、把界面长什么样演出来,完全做得到。
于是一切都变了:当“跑一遍”的成本低于“想半天”的成本,理性策略就从纸面推演变成了经验验证。有疑问?别开会争了,直接做个 POC 让事实说话。三个方案拿不准哪个好?让 AI 各搓一版,拉出来遛遛。
一句话:以前文档是地图,人照着地图修路;现在 POC 是探路,文档是探完路之后画下来的图。

三、这个倒转,在方法论上有三个名字
① Spike 常态化。极限编程(XP)里早有个概念叫 Spike(探针):正式开发前,用一个“一次性”的小代码验证关键疑问。以前 Spike 是补充手段,偶尔用一下;AI 把它的成本打到接近零之后,探针从例外变成了默认动作——每个需求进来先问一句“这个要不要先 POC 一下”。
② 先验设计 → 经验迭代。文档先行的本质是“先验设计”:相信人脑能在纸面上推演出正确答案。POC 先行是“经验迭代”:承认纸面推演有边界,干脆用最小的可运行物去撞真实世界,撞完再修正方向。精益创业那套 build-measure-learn,落到工程现场就是这个。
③ 文档从「指令」变「记录」。这是最深的一层。以前的文档是下给程序员的命令:你照这个做。命令写错全盘皆输,所以必须字斟句酌、前置评审。现在的文档是留给后来人的史记:我们验证过了,事实是这样。史记只须如实,且记录的东西必须先存在——所以文档天然落在 POC 之后。
四、但顺序倒转不等于文档可以不写:三个坑
新玩法有新坑。这三个坑都是我在项目上见过的,一个个说。
坑一:POC 直接上了生产
POC 跑得又快又好,客户一高兴:“就它了,别重写了!”然后 demo 代码原封不动进了生产。POC 没有权限设计、没有异常处理、没有日志、没有运维接口——它有“形”,没有“骨头”。POC 验证的是可行性,正式开发必须另起炉灶,这根纪律松不得。
坑二:POC 跑通了,没人沉淀文档
这是最隐蔽也最致命的。验证过的知识留在 demo 脚本里、留在当事人的脑子里——团队换一个人,知识归零。AI 时代的正确姿势不是“不写文档”,是把文档从“前置指令”改成“后置沉淀”。而且这一步现在也有 AI 帮忙:让 AI 从跑通的代码反向生成技术文档,成本已经很低了。
坑三:需求确认还停留在“看文档签字”
客户对着文档点头,和看到能点的东西点头,是完全不同的两件事。文字有歧义,演示没有。有 POC 能力却还让客户“看文档想象效果”,等于手里有枪还在拼刺刀。演示取代描述,是 AI 时代需求管理最大的红利,但多数团队还没吃到。

五、落成一套新打法
把倒转后的流程整理成可执行的四步,供参考:
① 提炼关键疑问:这个需求里最不确定的是什么?性能?集成方式?客户到底要什么界面?先列出来,别急着写文档。
② AI 搓 POC:每个关键疑问一个最小原型,能跑就行,别追求工程质量——它生来就是为了被验证的。
③ 演示代替评审:拿 POC 给业务方看、给客户点,让反馈打在真东西上,而不是打在想象上。
④ 跑通后沉淀:方向确认、正式开发启动时,让 AI 基于验证过的代码生成设计文档——这时的文档写的是已验证的事实,不是待验证的猜想。
注意第四步——文档没有被取消,只是换了位置和性质。写文档这个动作依然重要,因为它是把“跑通的经验”升级成“团队的资产”的唯一途径。
六、结语:贵的东西变了,顺序就该跟着变
方法论从来不是教条,是成本结构的产物。瀑布流诞生在“代码昂贵”的年代,所以文档先行、评审把关;AI 把代码的成本打下来之后,“想清楚”反而成了项目里最贵的环节——而消灭“没想清楚”最便宜的方式,不再是纸面推演,是先跑一遍。
先写文档再写代码,是先画地图再修路;先做 POC 再写文档,是先探出路再画图。地图会画错,路探出来的不会。
上篇说过,企业 AI 的下半场比的是谁的业务本体干净完整。而本体从哪来?不是从会议室的讨论里来,是从一次次“跑通了、验证了、写下来”的循环里沉淀出来的。POC 负责跑通,文档负责写下来——两步都别省。
—— 你现在的项目,还在文档先行吗?评论区聊聊你们团队的新顺序。

— 关注「曰天曰地」,技术 + 生活,周哥陪你聊 —















































































