LoopForge Local 的 Codex Classic 任务通过 task_slug 和 artifacts 目录内的 workflow-state.json 保存交接状态。回到同一项目后,先核对安装、任务标识与工作区,再在 Codex 会话中发送 devflow-codex 的 status 和 resume 指令。
回到原项目确认使用同一种工作流
开始恢复之前,先确认之前跑的任务用的是 codex classic 版本。安装入口是 install codex,portable 版本的技能名称和安装内容有单独说明。恢复全程别换 edition,不然会读到不一样的工作流定义直接出错。
pwd git status --short npx -y loopforge-cli@0.2.2 status codex npx -y loopforge-cli@0.2.2 doctor
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果工作区里有之前任务生成的没提交的文件,先看diff,分清楚之前自动生成的进度内容和你后来手动改的部分,两边的记录都别删,这样恢复后的会话才能准确识别哪些文件要接着处理。
从实际产物找到 task_slug
find artifacts -name workflow-state.json -print find artifacts -name workflow-summary.md -print
artifacts/对应目录/workflow-state.json 这个路径里的目录名,就是你要找的 task_slug。如果搜出来好几个结果,挨个核对对应的需求文件、更新时间和任务总结,挑出和你要恢复的任务匹配的那一个。任务从来没启动过的话,哪怕装完软件也不会自动生成这些文件。
确认好 task_slug 之后,在 Codex 会话里输入“$devflow-codex status 你刚才查到的实际task_slug”,把后面占位的部分换成你从目录里拿到的真实值就行。状态读出来之后,核对下当前阶段、最近触发的事件和下一步目标,和本地存的报告对得上再往下走。

恢复前说明中断位置和手动改动
输入“$devflow-codex resume 你查到的实际task_slug”,同时备注清楚之前任务中断的原因,比如“实现报告已经存好了,独立审查还没跑完,我手动改了配置文件里的端口”。这样恢复后的会话会先读完已有的状态和产出文件,自动判断该从哪个阶段接着跑。
发完指令先检查下,Agent 是不是沿用了原来的任务目录,是不是读取了旧的 workflow-state.json,而不是新生成了一套完全重复的任务。已经跑完的阶段都要有对应的报告,下一阶段的运行依据必须可追溯。
怎样确认恢复结果,怎样处理损坏状态
任务接着跑之后,看新生成的阶段文件、测试结果和 workflow-summary.md,比对 Git 的差异记录,确认所有改动都符合原来的需求。如果测试没跑通或者直接失败了,先保留完整结果,排查完原因再做后续验收。
要是找不到状态文件,先核对项目路径、任务目录和版本控制记录。如果文件解析失败,千万别删原文件,先检查文件是不是没存完整,试着从之前的备份恢复。要是只有代码改动记录、找不到阶段状态,直接让 Agent 读取现有所有产出文件重建当前进度,同时把重建的依据写下来留底。


















