请为当前 Codex 建立“通用本地任务存档与恢复机制”。目标是在中转延迟、断流、软件重启或切换新窗口后,能够读取已保存的任务状态继续工作,并尽量保持固定提示词稳定。
请实际创建、写入并验证相关文件,不要只回复“已经记住”。
建立长期入口
先读取当前生效的 AGENTS.md 和相关规则,确认当前操作系统、项目目录、Codex 配置目录及写入权限。
将这套通用规则合并到实际生效的用户级 AGENTS.md,保留原有内容,避免重复添加。项目专用要求只保存在项目规则或对应任务卡中。
AGENTS.md 只保存固定的工作规则和恢复入口,不写入不断变化的任务进度、时间戳、报错日志或聊天内容。
本机制适用于不同类型的任务,不绑定任何固定网站、人物、图片、业务或历史项目。
存档目录与任务隔离
优先沿用当前项目已有的恢复目录。
如果没有项目级恢复目录,在当前真实 Codex 配置目录下建立 task-recovery,并按项目真实路径生成独立项目标识,隔离不同项目的任务。
至少建立:
恢复协议:说明目录位置、文件格式与恢复顺序。
当前任务指针:记录项目路径、任务 ID、任务卡路径和更新时间。
独立任务卡:每个新任务使用不同的任务 ID。
对话记录:保存实际可读取的相关消息。
纠错记录:保存用户明确纠正的要求及其适用范围。
仅使用当前环境真实存在或成功创建的路径。不得覆盖其他项目的任务,不得自动上传、云端同步或扫描无关目录。
任务卡保存内容
每个可继续执行的任务至少记录:
任务 ID、名称和用户原始目标。
所属项目及真实工作目录。
当前阶段和状态:进行中、暂停、阻塞、完成。
已完成的内容及验证依据。
正在处理的内容。
未完成事项。
卡点、失败原因、已尝试及已排除的方案。
下一步可直接执行的动作。
用户最新要求、纠错记录和不可擅改的内容。
当前基准文件、基准图片、相关资料和输出路径。
当前使用的技能、MCP、工具及其实际可用情况。
可确认的原会话 ID 或日志位置;无法取得时明确标记。
最后成功保存时间。
不同任务之间不得自动继承图片、提示词、颜色、人物、路径或项目限制。
自动保存时机
在以下节点主动存档:
新任务目标明确后。
用户修改要求或纠正错误后。
开始耗时操作或重要修改前。
完成一个可验证步骤、生成文件或得到工具结果后。
出现错误、权限问题或环境问题后。
任务阶段变化、暂停、阻塞或完成时。
每轮结束前,只要任务状态发生了变化。
长任务分段执行,每完成一段就保存一次,不要等整个任务结束才保存。
重要操作前记录“准备执行”,执行后根据实际结果记录“已完成”或“失败”。请求已经发出但结果不明时,记录“结果待核实”,恢复后先查证,避免重复执行。
不要承诺在突然断流、崩溃或模型停止运行的瞬间仍能保存。能够恢复的范围以最后一次成功写入为准。
保存方式
任务卡维护最新状态,对话记录和纠错记录按顺序追加。
更新任务卡时先写临时文件,校验后替换正式文件,并保留上一份有效备份。任务卡成功写入后,再更新当前任务指针。
写入后回读关键字段,确认内容与路径正确。保存失败时如实说明,不得声称“已存档”。
多窗口同时操作时,更新前核对任务 ID 和文件版本,发现冲突不得直接覆盖。
对话记录的边界
只保存当前实际可读取的用户消息和助手回复,并标注角色与顺序;工具输出保存必要摘要和文件位置。
如果只能取得部分消息或摘要,明确写“部分对话记录”或“任务摘要”,不得声称是完整聊天记录。
不得编造已经不可读取的旧消息,也不得把模型推测写成用户原话。不要将密钥、密码等凭证复制进恢复记录。
如果原会话仍可通过 Codex 自带功能恢复,告知用户优先恢复原会话。任务卡作为跨窗口继续工作和原会话不可用时的补充。
新窗口恢复流程
当用户说“恢复上次记忆,继续上次的”“继续上次任务”“读取恢复卡”“恢复当前任务”等表达时:
先读取适用的 AGENTS.md,再读取恢复协议、当前任务指针、对应任务卡、纠错记录,以及继续任务所需的基准资料和输出文件。
优先匹配当前项目。指针指向其他项目时先说明,不得擅自切换项目或执行其任务。
读取后先用中文简短报告:
当前任务、当前阶段、上次完成点、卡点、基准文件、关键纠错、下一步,以及无法读取或未验证的信息。
报告完成后,如果用户已明确要求继续,则在原授权范围内执行下一步;如果只询问进度,则只报告。
恢复文件不存在、为空、损坏或无法读取时,明确指出具体缺失项,不猜测旧任务,也不因恢复失败自动创建新任务。
缓存与上下文管理
将固定规则和动态状态分开:
AGENTS.md 和通用恢复协议保持稳定。
任务进度、时间戳、纠错细节和日志写入任务文件。
需要时通过工具读取任务文件,不把整份动态记录反复改写到前置规则中。
不为了“刷新记忆”反复重写已有聊天、完整重读所有历史记录或重复粘贴大段背景。
不为增加缓存刻意堆砌无用文字。
没有任务需要时,不主动更换模型、推理设置或增删工具配置。
缓存由客户端请求内容、中转和上游共同决定。不要声称本地存档等于模型缓存,也不要声称已经提高命中率,除非有实际使用数据支持。
首次配置后的验证
报告实际生效的规则文件、恢复目录和指针路径,验证任务文件能够写入并回读。
当前会话已有明确业务任务时,只根据可读取的信息为该任务存档;如果没有,保持空指针并明确说明“当前没有可恢复任务”。
不要将配置恢复系统本身冒充成用户上一个业务任务。不要恢复或执行任何未经确认的历史任务。