Plan as Agent Checkpoint(计划即 Agent 检查点)

定义

Plan as Agent Checkpoint 是把任务思考和执行状态写入结构化计划文件,使 Agent 能在上下文耗尽、会话切换、模型切换或人机交接后继续工作。计划不是一次性说明,而是可恢复、可审查、可执行的任务状态。

核心机制

模糊输入
  -> 并行读取代码库、历史经验和外部资料
  -> 形成结构化计划
  -> Agent 按计划执行
  -> 用验收标准验证
  -> 将新经验沉淀回计划、规则或 Skill

一个有效的 Agent 计划至少应包含:

组成作用
问题与目标防止 Agent 只解决表面请求
代码库或工作环境模式让方案服从本地约定,而不是生成通用建议
实施路径与目标文件限定执行范围,降低无关修改
验收标准把“完成”转成可验证条件
风险与边界提前暴露需要人类判断的部分
状态与下一步支持跨会话恢复和交接

为什么是检查点

LLM 上下文是易失的。长任务中,Agent 会遗忘早期判断、重新探索已知信息,或在会话切换后失去执行方向。

计划文件把易失上下文变成持久状态:

  • 新会话可以直接读取计划继续工作。
  • 不同模型可以围绕同一目标分工。
  • 人类可以只审查目标、风险和验收标准,不必跟踪每个执行步骤。
  • 团队成员可以对计划评论,再把反馈送回 Agent 循环。

这使计划同时连接 上下文工程机器可读流程可验证性

与普通计划文档的区别

普通计划主要用于沟通意图;Agent 检查点还必须能驱动执行和恢复。

维度普通计划文档Agent 检查点
主要读者人类Agent + 人类
粒度方向和里程碑方向、文件、约束、验收和状态
生命周期启动时撰写,执行中可能失效执行中持续校正
核心价值对齐认知对齐认知 + 恢复执行

关键数据点

  • Matt Van Horn 的规则是:除非变更只有一行,否则先生成 plan.md
  • 他的规划流程会并行读取代码库模式、过去方案和必要的外部资料,再合并为目标文件、实施路径和验收清单。
  • 作者明确把计划作为上下文耗尽后的恢复点:新会话读取计划后可以继续执行。
  • 计划也可以成为团队协作接口;作者使用 Proof 让非终端同事阅读、评论计划,再把反馈送回 Agent 循环。

前提与局限性

  • 计划只能外化已识别的问题;错误假设被写进计划后,也会被 Agent 更稳定地执行。
  • “有计划”不等于“计划正确”。人类仍需审查目标、风险、权限和验收标准。
  • 开放探索、研究发现和创意任务可能无法提前列出完整实施路径,计划应允许更新,而不是变成僵硬脚本。
  • 计划过长或过细会增加维护成本,使 Agent 把更新文档当成工作本身。
  • 计划不能替代测试、运行证据、代码审查和责任承担。

关联概念