我给 AI 写了 894 行交接文档，还给它署了个名

我给 AI 写了一份 894 行的交接文档，最后署名"颂宝"。 这不是给哪一个 AI 的 是给下一任的 就像公司里人走了要交接一样 机器上的 AI 也会走 版本会换 会话会断 上下文会一夜清零

事情是这样的。 我在一台服务器上养着一个自动化 agent，它每天替我干活，早已经不止聊天那么简单。 它知道哪个定时任务几点跑 哪个目录不能碰 哪个接口前阵子刚坏过 这些东西 全存在它的会话记忆里

问题来了。 某天我升级环境，会话一重建，它看我的眼神就像第一天来上班的新人。 东西还在 人不在了 我知道那些经验就存在某个文件里 我就是调不出来 那一刻我意识到 我缺的不是技术 是人事制度

于是我写了那份 README_HANDOVER.md。 894 行，我一行一行核过，里面全是这几个月攒下来的现场知识。 哪条命令危险 哪个目录是它的地盘 每天几点有什么活 出过什么事故 当时怎么查出来的 哪台机器的磁盘最紧 哪个证书几号到期

文档的大结构也定得很快，五个部分。 边界 禁忌 日常 事故 还有一份定时任务的时间表 最难的是中间那几段 我卡了很久。 我发现我根本讲不清它自己是怎么看待那些事的，我只能写"它应该怎么理解"，而不是"它当时是怎么想的"。 我删掉重写了三遍 最后干脆把当时的日志原文贴进去 让它自己看当时的自己 它比我的转述更准

失败也有一次很典型的。 第一版交接文档我写成了操作手册，全是步骤，一条一条编着号，看起来特别专业。 新会话接手后 它把步骤全执行了一遍 包括那些只在特定故障下才该做的事 那天它把一个备份任务跑了四遍 磁盘差点被自己的备份塞满

我这才明白 交接文档不是说明书 是给继任者的判断力。 那天晚上我把第一版整个推翻，重写花了一个多小时，但值。 步骤它自己会查 它缺的是"什么情况该停"的判断 第二版我把结构倒过来了 先写边界和禁忌 再写日常 再写历史事故 每个事故后面都加一句 当时的错误判断是什么

至于署名这事 很简单。 文档结尾我落了一个"颂宝"，这不是什么玄乎的操作，就是给这份文档一个责任人。 文档会老 会过时 会说错话 有署名 就有得追 没署名的交接文档 跟没盖章的合同差不多

有人可能觉得 这不就是把提示词写长一点吗。 我以前也这么想，真踩过坑才知道这两样东西根本不是一回事。 提示词是命令 交接文档是判断 命令管一次 判断管一任 提示词写的是"你现在要做什么" 交接文档写的是"你接手之后会碰到什么" 一个是开车时的导航 一个是交给新司机的车况记录

如果你也在养自己的 agent，我劝你今天就写一份交接文档。 不需要 894 行，三条就够起步。 一 它的地盘 哪些目录哪些任务归它管 二 它的禁忌 什么情况下必须停下来问人 三 它的历史 出过什么事 当时怎么解决的 每次它替你做了一个重要决定 就回去补一行 坚持一个月 你会发现自己也比以前清楚它在干什么 这东西写起来慢 用起来真省 我现在新起一个 agent 第一件事就是建这份文档

顺便说一句 这份文档反过来也救了我自己。 有一次我出差一周 回来完全想不起某个流程为什么那么设 翻开的正是这份交接文档 一行一行看下去 五分钟就想起来了 要是没这文档 我大概率把那套流程整个重搭一遍 我给自己的机器写文档 最后是自己用上了

四十岁的人了 还在给不领工资的 AI 写交接 听起来有点好笑 但我的老师身份提醒我一件事 知识只有交接出去 才算真的拥有过 讲得清楚 才是真的懂了

任何时候做任何事情一定全心全意 一定全力以赴 AI 也一样 换一茬 就得带一茬