ARTICLE · 1135794
AI 每次都“失忆离职”?我把交接文档做成了可抄的模板
上一篇讲了“状态活在文件里,不活在对话里”的道理,评论区问得最多的一句话是:
道理懂了,文件到底长什么样?
今天不讲理,直接交底。
这套东西我已经多项目并行跑了一个夏天,五六个项目同时换班都不慌,现在把整套模板原样交给你。
01
PART
一、每个项目固定六份文件
SIX FILES PER PROJECT
分两个地方放。
项目代码目录里放两份(服务“当前任务”):
PROJECT_CONTEXT.md
:项目身份、代码路径、部署边界、禁止事项、下一步最小动作;
AI_HANDOFF.md
:交接说明,当前会话干到哪了。
知识库里放四份(服务“跨时间、跨账号”):
项目总览.md
:这个项目是什么、为谁存在;
里程碑记录.md
:每个阶段做完了什么、结论是什么;
最新接手指引.md
:新 AI 上岗第一份要读的文件;
发布与运维记录.md
:线上状态、发布链路、回滚点。
分工一句话:
项目文件夹解决“这个仓库”的接手,知识库解决“这件事”的接手。
聊天记录永远不参与交接,它会过期、会丢、会换平台,文件不会。
02
PART
二、两段口令,直接抄
TWO PROMPTS TO COPY
阶段收口口令(每完成一个阶段,发给正在干活的 AI):
请为当前项目做阶段收口和知识库同步。只做文档整理,不改代码、不部署、不重启服务器。
基于当前会话、项目文件、git 和服务器状态,更新:
项目目录内 PROJECT_CONTEXT.md、AI_HANDOFF.md;
知识库内项目总览、当前里程碑记录、最新接手指引。
必须写清:项目名称、项目路径、正式仓库路径、当前分支和
HEAD、服务器部署状态、已完成事项、未完成事项、当前卡点、下一步最小动作、禁止事项、哪些信息需要新任务只读核验、哪些旧路径旧方案旧判断已经废弃。
要求:不写模糊话,不只写聊天摘要,不让新任务去读旧会话,不省略发布链路、服务器路径、数据库位置、正式仓库路径;
某个事实没核验过,就明确标注“需核验”。
新任务接手口令(开新会话时发的第一条消息):
接手项目任务。不要读旧会话,不要猜历史。
第一步只读:知识库的项目总览、最新里程碑记录、最新接手
指引;项目目录的 PROJECT_CONTEXT.md 和 AI_HANDOFF.md;
只读核验 git status、git log、必要的服务器健康状态。
第一轮只汇报:项目身份、仓库路径、分支和 HEAD、工作树
状态、部署状态、已完成、未完成、卡点、下一步最小动作、发现的过时信息或冲突信息。
第一轮不改代码、不 push、不部署、不重启服务器。
03
PART
三、这套模板里藏着的四条铁律
FOUR IRON RULES
模板谁都能抄,真正让它运转的是背后四条不许商量的纪律:
第一,收口和干活永远分开发令。
收口指令里白纸黑字“只做文档整理”,防止 AI 借着写总结的劲头顺手改代码。
第二,新任务第一轮只许汇报,不许动手。
它汇报出来的“过时信息或冲突信息”,就是交接文档的质检报告,上一任写漏的、写错的,第一轮就现形。
第三,“下一步最小动作”必须具体到一句话。
不是“继续优化”,是“在测试服务器跑通 X 流程后发布 Y 包”。
新 AI 看完不知道该干什么,就是收口失败。
第四,废弃信息要显式划尸体。
哪些旧路径、旧方案、旧判断已经不作数了,必须列出来。
交接文档里最毒的不是缺失,是过时的内容还以权威口吻躺着, 新AI 会当真。

///
LAST
四、成本账
THE COST
这套流程每次收口多花两三分钟,每开一个新任务多读五个文件。
换来的是:
我从来没需要把一段历史给 AI 重新讲一遍;
换模型、换供应商、换电脑,项目照常推进;
以及最值钱的一条,我不再是那个“唯一知道项目状况的人”。
很多人用 AI 累,不是累在干活,是累在当活文档。
把它做成文件,你就是文档的读者,不再是文档的复读机。