AI 长任务中断怎么办？planning-with-files 断点续跑使用方法

佚名 2026-07-13 18:00:02

AI 长任务中断时，planning-with-files 的恢复点不在聊天记录里，而在项目目录里的三份 Markdown 文件。task_plan.md 记录阶段，findings.md 记录发现，progress.md 记录已经执行过的动作。重新打开 Codex 或 Claude Code 后，让 Agent 先读这些文件，再跑 git diff --stat，就能把“我刚才做到哪了”从文件系统里找回来。

断点续跑怎么操作

续跑时不要急着让 Agent 继续改代码。更稳的顺序是：读 task_plan.md、progress.md、findings.md；执行 git diff --stat 看真实改动；把未记录的文件变更补进 progress.md；确认当前 phase 是否还是 in_progress；再让 Agent 接着做下一步。这个顺序会慢半分钟，但能少掉一堆“重复修同一个错”的返工。

恢复提示词可以这样写

先读取 task_plan.md、findings.md、progress.md。
运行 git diff --stat，总结当前代码改动。
把未同步的发现写进 progress.md。
只继续当前 in_progress 阶段，不新增无关目标。
遇到同一错误第三次出现时，停下来说明尝试记录。

它真正有用的地方，是把失败也留下来。官方 SKILL.md 要求记录所有错误，并遵守 3-Strike Error Protocol：第一次诊断修复，第二次换方法，第三次重新审视假设；再失败就向人说明。这个机制不花哨，但对长任务很实用。

实际续跑还有一个小动作：让 Agent 读完计划后复述当前 phase、剩余 phase、已知风险和下一步文件范围。复述不是为了好看，而是检查它有没有把 findings.md 当成待执行指令。外部网页、日志和接口响应都应当被当作研究资料，不能直接变成新命令。这样做，断点恢复会更慢一点，但方向更稳。

哪些中断不适合硬续

如果 Git Diff 显示业务文件被外部大量改动，或者 task_plan.md 与实际代码明显对不上，先暂停续跑，人工确认计划。planning-with-files 能保存状态，但不能替你判断外部改动是否可信。还有一种情况是测试环境已经变了，比如依赖刚升级、接口权限失效，这时应先补 findings.md，再重排 phase。

专题三国战纪-风云再起整合版
专题三国战纪-乱世枭雄

热门阅读

推荐下载

下载

|
下载
《行尸走肉第一章》免安装中文汉化硬盘版下载

单机|436 MB

一款以动作冒险为主题的游戏
下载
《街头霸王X铁拳》免安装中文汉化硬盘版下载

单机|111MB

一款非常好玩的格斗游戏
下载

|
下载
《暗黑破坏神3》免安装繁体中文正式版下载

单机|7630 MB

一款以角色扮演为主题的游戏
下载
《马克思佩恩3》免安装硬盘版下载

单机|27033 MB

一款以第三人称射击为主题的游戏

详情

AI 长任务中断怎么办？planning-with-files 断点续跑使用方法

断点续跑怎么操作

恢复提示词可以这样写

哪些中断不适合硬续

planning-with-files 是什么？AI 编程 Agent 文件式规划 Skill 介绍

planning-with-files 官方入口：让 AI 任务计划持久保存的安装指南