夜雨聆风学习资料网

ARTICLE · 1135794

AI 每次都“失忆离职”?我把交接文档做成了可抄的模板

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 累,不是累在干活,是累在当活文档。

把它做成文件,你就是文档的读者,不再是文档的复读机。

相关学习资料