项目里最值钱的文档，是一份"踩坑清单"
和 AI 长期做一个项目，最有用的积累不是架构说明，而是"我们之前在这里踩过坑，不要再踩"这类记录。每次花了较长时间才解决的问题，用三句话记下：现象、原因、正确做法，放进项目文件，让 AI 开工前先读。久而久之，它会变成你自己的开发流程和工具。
用 AI 做项目久了，会发现一个现象：同一个坑，换个对话，AI 又踩了一遍。
它不会自动记住上周你们花了一下午才解决的问题。能让它记住的，只有你写下来的东西。
一、为什么踩坑记录比架构文档更有用
- 架构说明告诉 AI "应该怎么做"，但 AI 本来就会按常规做法来；
- 踩坑记录告诉 AI "常规做法在这个项目里行不通"，这恰恰是它不知道的；
- 很多坑和具体环境有关：某个依赖的版本问题、部署平台的特殊限制、某个接口的奇怪返回格式。
以下为会员内容
本文为 AI 编程 会员内容。开通会员后可阅读全部教程、问答和模板：12 月 3 日前限时 ¥199/年（原价 ¥365），开通送 voicemake.cn 高级会员 1 个月，会员可 1V1 咨询。