全靠 AI 写代码的我,意识到套用模板比规范开发文档更强

之前在《AI辅助开发，怎么才能从手忙脚乱到稳如老狗？》里，我讲过经验沉淀四步法——把踩过的坑整理成方案，归档入库，新项目直接引用。读者反响不错，但有个后续的翻车故事我一直没讲，今天单独聊聊。

我建了个规范库，十几份文档，PWA怎么配、部署怎么做、命名怎么定，全有。按理说开新项目应该很顺了吧？结果上个星期我做部署审计，六个项目，三个挂了。

挂的项目里，有两个是"参考"过规范的。

这事让我琢磨了挺久。文档明明写得很细，坑也标出来了，为什么照着做还是翻车？后来我对比了成功和失败的项目配置，发现失败的项目不是没看文档，是看漏了。文档有二十条要点，它落实了十七条，漏的那三条里正好有一条是致命的，让构建第一步就死掉。

我一开始的反应是：那把文档写得更醒目一点？加粗、标红、放到最前面？

试了，没用。后来想通了一个特别简单的道理：文档可以被读漏，模板不可能被读漏。

你让AI"参考规范新建项目"，本质是一个抄写过程，抄写就有遗漏率。二十条要点，每条哪怕只有5%的概率漏掉，整体全对的概率也不到四成——差不多正好是我那个三成三败的比例。这个数字对上的时候我还挺乐的，虽然可能是巧合。

但如果新项目是从一个模板仓库直接fork出来的呢？配置文件天生就在正确的位置，部署脚本天生就是对的命令。不需要"落实"任何要点，因为初始状态就是合规的。遗漏率直接归零，不是降低，是这个环节整个消失了。

所以我现在的做法是：把三个部署成功的项目里总结收敛出来的结构，固化成一个模板仓库。新项目一律从模板起步，禁止从旧项目复制配置——旧项目的配置里藏着它自己的历史包袱，你复制的时候根本分不清哪些是通用的哪些是当时的临时方案。这个坑我踩过，从一个老项目抄vite配置，把人家为了兼容某个废弃功能写的hack也一起抄过来了，排查了一晚上。

那规范文档是不是就没用了？也不是。我现在把两者的分工想清楚了：模板管"起点正确"，文档管"为什么"。模板里每一处不寻常的配置，注释里留一个链接指向规范文档的对应条目。新AI不需要读懂全部文档才能开工，但想改某个配置的时候，能查到它为什么长这样。

顺便说一句，AI在这件事上不比人强。我在《AI开发最危险的幻觉：你的项目看起来已经完成了》里写过它的虚报问题，读文档这事上它一样会漏、会想当然，指望它"仔细阅读全部规范再动手"，跟指望自己每次都不看漏是一个性质。

写规范半年，我对"经验沉淀"这件事的理解大概经历了三层：一开始觉得写下来就是沉淀了；后来发现写下来的东西要能被验证才算数；现在觉得，最好的沉淀是让正确的做法变成默认状态，根本不给犯错留入口。

文档是给人读的，模板是给项目用的。能用模板固化的，就别指望人的记性了，包括AI的。