拒绝文档腐烂：代码反向同步与“基线重建”工程

这是系列专栏的第十篇。

在此前的篇章中，我们构建了一套精密的“正向开发”流水线：从需求到设计，再到代码。这套流程在V1.0版本开发时无往不利。 但在软件工程的漫长生命周期中，“开发”只占20%，“维护”占80%。

随着V1.1、V1.2……V2.0的不断迭代，一个隐形的杀手开始逼近：代码在变，但文档（PRD/API/DB）还在原地踏步。 在传统开发中，这叫“文档腐烂”，程序员顶多骂两句。但在AI原生开发中，这是“致命伤”——因为过时的文档会喂给AI错误的上下文，导致AI产出错误的代码，最终导致整个自动化系统的崩溃。

这一篇，我们将探讨如何利用AI进行“逆向工程”，低成本地解决这个世界级难题。

如果说前面的九篇文章是在教你如何“造一辆自动驾驶的赛车”，那么这一篇就是在教你“如何保养这辆车”，不让它在高速行驶中散架。

我们团队在实践中发现，当项目进入二期、三期迭代后，AI生成的代码质量开始莫名其妙地下降。

• AI引用的API字段，后端代码里已经改名了。

• AI生成的SQL语句，忽略了上周新加的“租户隔离”逻辑。

• AI判断的业务流程，漏掉了昨天刚加的“风控拦截”。

排查后发现，AI没有错，错的是输入。 我们投喂给AI的PRD和API文档，还停留在V1.0版本，而线上代码已经跑到了V1.5。文档与代码的“剪刀差”，构成了AI的