展开知识库目录
任务做一半想隔天继续或换台机器？先把状态和规则写进文件
终端工具的会话不是永久的。把当前进度、已完成步骤、未决问题和下一步写进项目里的交接文档，下次继续时让 AI 先读这份文档，比让它重新摸索快得多。
把进度和未决问题写进交接文档
你有没有这种体验：上周让 AI 改完项目，这周开新会话，它又不知道项目怎么构建、哪些文件不能动，你得把同样的话再说一遍。这不是 AI 健忘，是你没给它一份“项目说明书”。
说明书分两层：长期规矩写进项目的规则文件，当前进度写进 HANDOFF.md（目标、已完成、未决、下一步、涉及文件、验收命令）。下次会话第一句就是“先读这两份文件，再复述我的任务状态”。
这些情况适合用，另外几种先停一下
适合用
- 任务跨天、跨会话或换机器继续
- 多个协作者或工具交替处理同一任务
- 任务中断时还有未决问题和待办
先别急着用
- 任务 30 分钟内能一次做完，写交接文档反而多余
- 交接文档可能泄漏敏感信息，先确认能否落盘
把进度、未决问题和下一步写进 HANDOFF.md，恢复时先读文档再动手
为什么这样安排
Codex 与 Claude Code 官方都建议用项目文件承载长期上下文；这里把“会话不可靠”的官方事实变成“状态落盘、恢复先读”的工作流。
- 01
把进度落到文档
先看 git 当前状态，把已完成、未提交、未决问题如实写进 HANDOFF.md，别凭记忆写。
- 02
顺手把命令也放进去
把构建、测试、启动命令和禁止事项一起写进文档，或标注对应的项目规矩文档，避免新会话重新摸索。
- 03
待办拆成有序步骤
把后续工作拆成 3-5 步，标注先后依赖和需要拍板的事，别只写一句“继续做”。
- 04
先读文档再继续
新会话开头指令：“先读 HANDOFF.md 和 git 当前状态，复述目标和下一步，确认后再继续”。
复制前先替换 {占位}
任务交接提示词（复制后改 {占位}）
请把当前任务的进度整理成一份交接文档 HANDOFF.md，放在项目根目录，格式如下：
1. 任务一句话目标：{任务目标}
2. 已完成：{列出已完成步骤和产出文件，可附 git 提交号}
3. 当前改动：{列出未提交的文件，注明哪些不能覆盖}
4. 未决问题：{列出卡点和你需要的决策}
5. 下一步：{列出按顺序要做的 3-5 件事}
6. 常用命令：{构建/测试/预览命令及来源}
要求：全部基于真实状态填写，不确定的写“待确认”，不要编造进度。HANDOFF.md 示例
下面是已经填过变量的示例。复制时请换成自己的文件名、数字和材料位置，别把示例数据原样交出去。
看清格式再改
HANDOFF.md 示例
目标：给知识库详情页加左侧固定目录 进展：吸顶与面板样式已改（stage-b.css） 未提交：stage-b.css、build-stage-b.mjs 卡点：移动端目录吸顶高度待确认 下一步：1) 重新构建 2) 1440/390 截图 3) 全量校验 命令：构建与校验两条，写法见根目录脚本配置
先对症状，别一上来重写整段提示词
换了会话它全忘了
- 常见原因
- 状态只存在对话里
- 怎么修
- 把状态写进 HANDOFF.md，新会话先读文档再继续。
交接文档和实际代码对不上
- 常见原因
- 写文档时没有对照 git status
- 怎么修
- 写完后运行 git status / git diff 核对一遍再收尾。
恢复时又从头问一遍
- 常见原因
- 没有把“先读文档”放进恢复指令
- 怎么修
- 恢复会话第一句就指定读 HANDOFF.md，并让 AI 复述。
最后五分钟，逐项打勾
这篇具体参考了什么
正文按公开教程和官方文档重新整理，并换成了可以直接操作的中文场景。产品能力、规则和投稿要求会更新，真正执行前请再打开原始页面核对一次。