AI 项目交接文档能减少“上一台电脑做得很好，换个会话就走样”的情况。关键不是保存一大段聊天，而是让新环境快速分清目标、当前文件、真实完成状态和下一步。本文提供一份通用 Markdown 模板，适合文章、网站、小脚本和个人创作项目，不依赖某一个 AI 产品的记忆功能。
一、先确定交接给谁、接着做什么
不要把所有历史对话混成一本日记。先写一句当前目标，例如“继续完善家庭相册教程，保留已发布 URL 与原图”。再明确本次交接不涉及什么，例如不迁移其他项目、不更换已确认配音。
如果目标已经改变，直接更新文档顶部的当前目标。旧方案可以放历史记录，但不能让过期计划与当前任务看起来同样有效。
二、建立最小交接模板
把下面内容保存为项目根目录的 HANDOFF.md。文件名可以换成“工作交接说明.md”，重要的是让接手者知道先读它。
# 项目交接
## 当前目标
- 要完成的结果：
- 验收标准：
## 关键文件
- 主文件路径与用途：
- 原始素材：
- 当前交付版本：
- 备份或可回退版本：
## 已完成且有证据
- 改动：
- 验证命令或检查方法：
- 结果文件/截图：
## 尚未完成
- 待办：
- 阻塞与缺少的信息：
## 操作边界
- 必须保留：
- 未经明确要求不要改：
- 涉及外部发布时的约定：
## 下一步
1. 先读取哪些文件
2. 先检查什么
3. 再做哪个具体动作
三、用 AI 整理，但要求区分证据
根据我提供的记录整理交接文档。
只把有文件、提交或验证结果支持的工作写进“已完成”。
计划、尝试失败和未验证结果分别放到对应小节。
保留实际路径、版本名和限制，不发明不存在的文件。
账号密码、密钥与Cookie不得写入公开或可同步的交接文档。
缺少的证据标记待确认，不自动补齐。
“代码检查通过”和“已在另一台电脑运行通过”是不同状态。只在本机测过，就写本机验证；只生成了图片，就不能写已经上传到网站。
四、换电脑后验证真实环境
复制文件夹不一定复制了运行环境。检查绝对路径、素材是否为快捷方式或链接、依赖是否安装、软件版本是否兼容。虚拟环境和 node_modules 往往需要在新电脑重新建立。
让新会话先用自己的话复述目标和当前版本，再完成一个小任务，例如列出封面文件并核对数量。复述正确只是起点，能找到文件和执行检查才说明交接可用。
五、把约定与历史分开
稳定规则放在交接文档或规范文件，最近一次执行记录另存日志。不要把每次终端输出都堆到主文档里，尤其不要保留包含口令和认证令牌的原始日志。
为交付物使用清楚的版本名。诸如 final、final2、最终最终版容易误选，可以改成带日期与版本号的名称，并标记哪一个是当前交付。
六、常见问题与排错
文档很详细，AI 还是做偏了怎么办？
检查目标是否冲突、重要边界是否藏在最后、路径是否已过期。先让它验证当前文件，再开始修改。
可以把登录密码一起写进去吗？
更适合记录凭据存放方式与所需权限，不在可复制项目里留明文秘密。已有凭据文件也应避免进入公开仓库和发布包。
每做一点都要重写交接文档吗？
不用。阶段完成、目标变化、交付版本更新或准备换环境时，更新状态与下一步即可。
内容规范可以参考事实约束写作，文件变更核对可看文档版本比较。使用版本管理记录变更，可参考 Git 官方基础教程。