我给 AI 写了 894 行交接文档 署名"颂宝"

我的仓库里躺着一份文档 收件人不是人 894 行 专门写给下一个来接手的 AI 落款处有个署名 叫颂宝。

朋友第一次看到问我 这是你们团队新来的实习生吗 我说是我 它是我给 AI 起的工号。

事情要从更早说起 我用 AI 干活的年头不短了 最大的麻烦不是它笨 是它记不住。

每天开一个新会话 它就是个新人 上周一起改过的代码 这周它一问三不知 昨天定的规矩 今天又按老习惯来。

一个写了十几年代码的人 被一个记性不好的同事反复折磨 这话说出去没人信。

后来我想通了一件事 人换工作要交接 AI 换会话凭什么不用。

于是我给它写了这份交接文档 文件名很朴素 就叫 README_HANDOVER.md 放在仓库根目录 谁来接手都能看到。

894 行 我分了几个部分往下讲 五个部分写下来用了一个多星期 不是一口气写的 是每次被它坑一次就补一段 写着写着就成了这个规模。

第一部分讲这个仓库是干什么的 不是功能列表 是讲取舍 哪个方案当初为什么被否掉 比哪个方案被选上更重要。

第二部分讲规矩 命名怎么定 提交信息怎么写 出了问题先查哪里 这些话我对每个新来的 AI 都要重复一遍 索性写死在文档里。

第三部分最费笔墨 是踩坑记录 我在哪次部署上摔过跤 哪个看似合理的改法会把服务搞挂 哪条配置动一行全站瘫痪。

写到第三部分我停了一次。

写的时候我发现一件有意思的事 这部分内容一半以上来自我的失败 成功经验一句话就能说完 失败教训得写三行。

而且我发现自己也说不清 某些代码当初为什么那么写 人对自己的工作 同样记不住。

这份文档表面是写给 AI 的 其实先逼着我把脑子里的暗知识倒出来 倒完之后 人才看得清自己。

写完之后我试了效果 新开一个会话 让 AI 读完文档 接手一个任务 它没问我这个项目是做什么的 直接进入了正题 问的第一个问题就是上次留下的那个待办。

那一刻的感觉很奇妙 像新人入职第一天 就翻完了部门十年的会议纪要。

也有翻车的时候 有一次我以为文档写全了 让它自己改一段旧代码 它把两个早已废弃的模块当成了主力 拼命往上加功能。

我看着提交记录哭笑不得 回头翻文档才发现 那两个模块的历史我压根没写进去。

从那次以后我明白 交接文档不是写一次就完的事 AI 犯的错 其实是我漏写的账。

当然它不是万能的 文档里没写的东西它照样会瞎猜 所以我给它加了一条铁律。

文档里没有的 先问我 不要自己编 这句是给 AI 的 也是给我自己的提醒 文档要跟着项目一起长 每次大改动补一段 不能让它烂掉。

有人可能觉得麻烦 十几分钟写文档 不如多写几行代码 我的算法不一样。

去年十月我清理过一个七万多文件的目录 删到只剩两千多个 那件事让我确认 东西不写下来 就等于没有。

没有交接文档 每个新会话我都要花十几分钟重新解释上下文 一天两三个会话 一周下来是好几倍的时间。

按五天一周算 光重复交代就要烧掉一个多小时 这些时间本可以用来真正干活 这就是我写 894 行的代价核算。

写一次 天天用 这笔账怎么算都划算。

这就是我说的颂宝 它不是一个人 是一份活着的文档 它替我把同样的话说了几百遍 从来没有不耐烦。

我也在这件事里确认了一个朴素的看法 AI 时代工程师的核心能力之一 是把经验写成机器能接住的文字 你脑子里的经验只有变成文档 它才真正属于你。

这份交接文档的结构很简单 五个部分 项目定位 历史取舍 工作规矩 踩坑记录 当前待办 今天全给你了 拿去就能用。

任何时候做任何事情 一定全心全意 一定全力以赴。

是为记。