智能体执行十几步的长任务时，常见问题是：中途偏离目标、失败后不知道做到哪一步、人类想接手却看不懂过程。一个简单有效的做法是要求智能体在开始前写出计划文件，每完成一步就在检查点日志中记录“做了什么、结果、下一步”，失败或中断后从日志恢复。

适用场景

  • 代码智能体做跨多个文件的重构或迁移
  • 研究类智能体整理大量资料
  • 数据处理流程（下载、清洗、汇总）分多个阶段
  • 任何可能运行很久、需要人类中途查看的任务

第一步：先写计划

在任务指令中要求：

开始执行前，请先在 PLAN.md 中写出计划：
- 目标（一句话）
- 完成标准（可验证的条件）
- 步骤列表（每步一行，带编号）
- 已知风险和需要人类确认的点
写完计划后停下，等我确认再开始执行。

人类审阅计划的成本很低，却能在最早的阶段纠正方向。

第二步：检查点日志格式

每完成一步，追加一条记录到 CHECKPOINTS.md：

## 步骤 3：迁移用户模块的数据访问层
- 状态：完成 / 失败 / 跳过
- 做了什么：修改了哪些文件、执行了什么命令
- 结果：测试是否通过、输出摘要
- 偏离计划：无 / 有（说明原因）
- 下一步：步骤 4

要点是可验证：写“测试通过”时附上执行的命令，而不是只写“看起来没问题”。

第三步：从检查点恢复

任务中断或新开会话时，用这样的提示词：

请先阅读 PLAN.md 和 CHECKPOINTS.md，总结当前进度：
已完成哪些步骤、最后一步的状态、是否有未解决的问题。
确认后从下一个未完成步骤继续，不要重复已完成的步骤。

这比把之前所有对话重新贴给智能体更省上下文，也更可靠。

什么时候让人类介入

在计划里预先标出这些检查点：

  • 删除数据、修改生产配置、发送外部消息之前
  • 连续两步失败时
  • 发现需要偏离原计划时

智能体在这些点停下来等待确认，而不是自行决定。

常见问题

  • 日志写得太简略：在指令中给出格式示例，并要求每条包含命令和结果。
  • 智能体忘记更新日志：把“更新 CHECKPOINTS.md”写进每一步的完成标准。
  • 计划过细：步骤控制在 5–15 个，太细会让计划本身难以维护。
  • 日志中包含敏感信息：提醒智能体不要记录密钥和个人数据。

延伸阅读：智能体人工审批检查点、团队智能体记忆交接，以及示例 智能体任务委派清单。