长任务换 Codex 会话，怎样准备一份可继续工作的交接包

长任务换 Codex 会话前，准备一份可继续工作的交接包，核心是把项目状态放到可读文件里。交接包不是整段聊天导出，而是一组有身份、证据和下一步的材料。本文不介绍恢复或分叉按钮；即使从全新会话开始，这份目录也应该让接手者理解现场。

推荐的最小目录

handoff-demo/
  00-target.md
  01-state.md
  02-changes.md
  03-checks.md
  04-next.md
  05-attempts.md
  manifest.csv

目标文件写用户要的行为、验收条件和明确不做的范围。状态文件记录仓库根、分支、提交号、工作树位置、未提交变化归属及数据是否合成。变化文件不必复制全部源码，列路径、函数、目的和是否已提交；补丁如需附上，先脱敏并另存原始受限副本。

每个文件都要有能接着用的内容

以“导入 CSV 时保留订单号”为合成任务：目标不是“优化导入模块”，而是“输入 000123 后导出和重开仍为六位文本”。状态写明正在处理哪个仓库的哪个目录，不能只写项目昵称。检查文件写实际运行命令、退出码、已通过用例和未验证的 Excel 重开环节；未运行命令放在下一步文件，不能混进通过列表。

下一步按依赖排序，例如先确认编号列类型，再补测试，最后人工重开验收。每项说明完成判据，避免接手者从“继续优化”自行扩展需求。失败尝试文件只保留仍有价值的信息：试过什么、观察到什么、为什么停止。不要把一个失败假设写成“以后永远不能用”的结论。

材料	合成示例	不足的写法
目标	编号逐字保持六位	把代码修好
当前状态	分支 task-csv，基线 H1	就昨天的项目
验证	七个解析用例通过，重开未验	测了没问题
下一步	用文本方式导入并比对三行编号	再看看

交接时处理未提交差异

提交号只覆盖已提交内容，不能代表完整工作区。把暂存与未暂存差异分别记录，未跟踪、忽略文件和外部资产另列清单。若某文件同时含用户与任务改动，明确哪些块不能动。附件清单记录相对路径、用途、摘要和敏感等级，接手者拿到之后可以确认文件是否齐全。

不要把整个凭据目录、登录缓存、真实客户附件作为“上下文补全”。需要复现数据时优先做保留结构的合成样本。确实需要真实数据的环节写清访问前提，由有权限的人提供，而不是在交接包中绕过权限。

新会话先做三步回读

让接手会话先读取目标与状态，复述准备修改的范围；随后核对当前仓库与清单是否一致；最后重跑一项成本低的关键检查。若提交号变化、文件摘要不符或工具环境缺失，先更新交接状态，再开始改代码。交接文件是快照，不能自动跟上别人在目录里继续做的变化。

AGENTS.md 是仓库规则的入口之一，适用规则也应在交接包里列出路径，避免复制过期规则。具体发现顺序按官方文档及当前运行入口核对，本文不假设任意文件名都能被自动加载。

常见问题

交接包越大越好吗？ 不，大量过期输出会掩盖当前状态。保留可复核证据，把长日志放附件并标时间段。

能完全替代会话历史吗？ 它可以支持继续工作，但对授权背景或讨论细节仍可能需要回查。

交接完可以删旧材料吗？ 先确认新会话能读懂并完成关键回读，保留恢复所需材料直到任务验收。

继续处理相关问题

相关入口：Codex 会话管理。

官方依据与核对日期

核对日：2026-10-23。Codex 项目规则：Codex 通过 AGENTS.md 等规定的机制读取项目指令；交接应指向实际适用规则。文中的流程、阈值和合成数据属于工程示例，不能代替当前账号、文件或运行环境的验收。