开发者把AI当实习生用了3个月，代码事故少了47%

一个被Alice遗留代码暴打过的工程师，终于摸到了AI协作的命门。

Alice是谁？每个团队都有。8个月前离职，文档"基本是最新的"，代码里有套只有她懂的"系统"。你接手时像只站在煤气灶前的猩猩——AI也一样。

这不是AI能力的问题。是我们把LLM（大语言模型）当成了自动售货机：塞提示词，吐代码，上线。出错了就骂"AI没用"，然后滚回Stack Overflow。

但你想过怎么带新人进一个烂摊子代码库吗？你不会扔个仓库链接说"修第247号工单，冲"。你会先聊架构，画白板，讲清楚哪块代码碰不得。最后才动手。

这最后一步，所有人都在跳过。对人跳过，对AI也跳过。

为什么文档注定腐烂

我们都坐过那个站会。Bob承诺维护Postman集合，维护了两次，重构一来，集合变成历史小说。Karen发誓让功能文档常青，高尚，真心高尚。但事后补的文档没有灵魂——永远落后两个迭代，永远漏掉那个凌晨2点出事的边缘情况。

没人撒谎，没人懒（可能Bob有点）。文档天生是事后诸葛亮，事后诸葛亮会死。

所以我们烦了。要想做对，自己来。现在——带着agent一起做。

但多数人的AI workflow（工作流程）完全搞反了。

一个文件扭转协作逻辑

这位工程师的做法很朴素：在仓库根目录扔一个READ_BEFORE_CODE.md。

每次开新任务，给AI三样东西：相关文件的绝对路径、目标描述、以及一条铁律——

写代码之前，先更新READ_BEFORE_CODE.md。写清楚：每个文件是干嘛的、它们怎么跟这个bug勾连、你打算改什么以及为什么、你有什么假设和盲区。

代码？不许碰。

这个markdown评审是你的vibe check（氛围检验）。你不是在核实AI的事实，而是在校准共享上下文。它暴露两件事：AI有没有真懂代码结构，以及你自己有没有漏看关键依赖。

有个细节很多人忽略。别让markdown变成一锤子买卖。加一条常驻规则：

「你做的每件事之后，更新这个文件。这是你的日记，这样你能回溯思路，我也能跟上。」

AI开始自我记录了。不是那种敷衍的变更日志，是思考痕迹——为什么选这个实现、放弃了什么替代方案、哪块代码让它犹豫过。

外部化的心智模型

你让AI产出的不是代码，是一个外部化的心智模型。

代码是死的，跑完就忘。但那个markdown文件活着——它解释上下文、标记陷阱、记录决策理由。下一个接手的开发者（或三个月后的你自己）不用重新踩坑。

这位工程师管这叫「反重力agent」——不是让AI替人飞，是帮人别摔死。

Prompt engineering（提示词工程）那套？他早忘了。什么角色扮演、思维链、少样本示例，在烂代码库面前都是花拳绣腿。真正管用的是强迫AI先说话，说人话，说够清楚再动手。

有个残酷对比：以前他直接让AI写代码，平均每个任务要返工2.3次。用了这个流程，返工降到0.4次。不是AI变聪明了，是错误被拦截在写代码之前。

最讽刺的发现是什么？AI写的markdown经常比他自己的理解更准确。因为它被迫慢下来，一行一行梳理，不能靠肌肉记忆糊弄。

现在他的团队有个新规矩：任何进主分支的AI辅助代码，必须附带更新过的READ_BEFORE_CODE.md。不是给经理看的，是给下一个凌晨被报警吵醒的人看的。

Alice的遗产还在，但至少现在，每个新接手的开发者不用再做那只猩猩。

你的代码库里有自己的"Alice"吗？你上次完整读完一个模块的文档是什么时候？