【SDD系列09】文档就是生产力！《文档驱动

朋友听完我讲“7周迁完1100多个接口”，第一反应都是皱眉：“别逗了，写完三天就过期，怎么可能靠多写文档提速？”

他们以为 SDD 是让程序员多写八股文。其实不是。

我们吃过亏。5月随手建了几份散落文档，不到五天信息就漂移，差点让团队乱套。后来才明白：文档得变成代码前面的硬契约。

真正跑通的，是五份咬合的文档。动手前先写业务理解和测试计划；完成后记下迁移结果与真实用例。再加一份全局台账、一本踩坑记录，所有口径只在一处定义。

AI 写得越快，人的签字越不能省。机器测试全绿，还得有人在真实环境走单签字。遇到功能死活、规则空白、历史口径不一，Agent 只能列证据，必须人拍板。

最扎心的是“假绿灯”。H2 过了真 MySQL 会报错，单测过了断言可能根本没效，空表测过也看不出分页错。后来我们定了六条铁律——真库对比、变异测试、非空样本、反编译核包、LEFT JOIN 查缺失、直读远端分支。

这套法子也有保质期。新老双栈并存时，连空指针都得原样复刻；老栈一停，再不写判空防御就是渎职。

到8月底，测试计划只剩业务理解的41%。说明单靠自觉一定磨损，得用自动化门禁锁死。

想试的话，先做四件事：改代码前写一页大白话业务理解；建一本共性踩坑表；坚持机器绿灯加人工真环境审核；把回滚做成一分钟开关。