为什么你的 AI 项目做完就废了：缺的不是代码，是构建记录

AI 项目做完就废，原因通常不在技术。代码还在，但当初为什么这么选、哪句提示词起了作用、怎么确认它真的能跑，这些都没留下来。下次打开它，你等于从零开始。

缺的不是代码，是构建记录。

现象：能跑，但碰不动

三个信号，中一个就说明上下文已经断了。

• 隔了几个月打开，看不懂某段逻辑为什么存在
• 想加一个小功能，先要花半天摸清原来的结构
• 换了个模型或工具，同样的东西要重做一遍

共同点很明显：文件还在，判断不在了。

断点一：决策断点，为什么这么选

每个项目里都有一批选择看起来没有理由：为什么用这种存储、为什么不拆组件、为什么这个字段留空。

当时的理由往往很具体——某个接口只支持这种格式、某个方案在你机器上起不来、时间只够做一版。这些理由不会写进代码，代码只保留结果。

于是下一个版本里，有人（很可能就是你自己）会把这些选择当成随手写的，然后改掉，再踩一次同样的坑。

把这类理由写下来成本很低：一句话，说清当时的前提是什么、什么时候该重新考虑。

断点二：提示词断点，哪句起了作用

用 AI 做的项目里，真正起作用的常常是一句很具体的约束：只改这个函数、不要引入新依赖、返回结构保持原样。

这句话不在代码里，也不在提交信息里。它在某次对话记录里，而对话记录通常是最先丢的那份文件。

所以约束要在提要求的时候就想好。完整的五步流程里，验收标准和约束是同一步写下来的，不是事后补。

结果是：别人用同样的问题问一遍，拿到完全不同的答案，然后判断当初那个方案不可行。方案其实没问题，是约束没了。

断点三：验证断点，怎么确认它真的行

这是代价最高的一个断点。「它跑起来了」和「它是对的」之间差着一整轮验证。

跑起来只证明没有报错。空数据试过吗？超长输入试过吗？重复提交试过吗？断网试过吗？这些试没试过，代码里一个字都看不出来。

更麻烦的是，没验证的部分会在下一次被当成「已验证」继承下去。错误就这样一层层往上叠，直到某天你必须重写。

三个断点，其实是一件事

决策断点丢的是理由，提示词断点丢的是约束，验证断点丢的是结论。三样东西都在代码之外。

代码只告诉你结果长什么样，不会告诉你它为什么是这样、在什么范围内成立。这也说明为什么「多写注释」解决不了问题：注释贴在代码旁边，而理由和验证过程不贴在那里。

AI 项目复盘真正要复的是什么

多数 AI 项目复盘写成了一份进度说明：做了什么、花了几天、遇到什么困难。读完你记住了它的辛苦，但不知道下次该怎么做。

真正能复用的只有三样：判断依据、有效约束、验证结论。这也是为什么大部分 AI 项目复盘看完没有用——它们记的是过程，不是判断。

构建记录四段式：问题、工具、结果、下一步

不用发明格式，四段够用。

• 问题：这次解决什么，边界在哪，什么不在这版范围内
• 工具：用了哪些模型、框架、服务，卡在哪一步
• 结果：现在能做到什么，哪部分是通的，哪部分只是看起来通
• 下一步：接下来做什么，当前卡在哪

四段都不需要长，一段两三句，有信息量就行。它同时可以当作 AI 项目文档的骨架——写给别人看的那部分，和写给未来的自己看的那部分，本来就是同一份。每段的反例和判断标准，四段式模板里逐条列了。

记录带来的三层复利

第一层给自己：下次遇到同类问题，你手上有一份带结论的参考，不用从零判断。

第二层给别人：别人能照着复现，也能指出你哪一步验证得不够。这一步比几十个赞有用。

第三层是可被搜索到：写下来的东西会沉淀，能被搜到、被引用。没写下来的，等于没发生过。

前两层要你还在做这件事才生效，第三层不需要。

AI 项目复盘的价值不在当时，在第二次打开的时候。

一段最小记录（示例）

下面是格式示例，内容为虚构，只用来标定颗粒度，不是真实案例。

问题：给一个静态页面加「按标签筛选」，不改数据结构。

工具：某代码模型 + 浏览器控制台。它第一次给的方案改了数据结构，被否掉，重问时明确要求「只改查询逻辑」。

结果：筛选可用，刷新后状态丢失。已测：单标签、多标签、空结果。未测：直接带参数进 URL。

下一步：把筛选状态写进 URL，再补一次直接进入的测试。

注意后两行：它明确写了没测什么。这段看起来简陋，但判断、约束、验证结果都在里面，别人照着做能少试一轮。这才是这条记录能被信任的原因。

什么时候不必写

一次性脚本、跑完就删的临时工具，写了也不会再看第二眼。

纯学习性质的练习也不必凑齐四段，留一句「这个方案在我这里不通，原因是 X」就够，这句话本身就是结论。

判断标准很简单：这个项目你还会打开第二次吗？会，就值得留四段。AI 项目复盘不必对每个项目都做，只对还要继续的做。

把这一次留下来

造个啥的发布页按内容类型收结构化字段：目标、工具、结果、下一步、卡点；正文和验证状态分开填，发出来就是一条能被搜到的记录。

想先看别人怎么写的，去广场翻几条不同状态的，注意看他们标的是「未验证」还是「作者已验证」；想找同类项目，去构建过程按方向翻。

如果只记一件事，就记这四段。它是 AI 项目复盘里唯一能被别人直接拿去用的部分。