用途:让智能体围绕一个长期、持久的目标跨多轮迭代,直到满足可验证的停止条件,而不是一轮对话后就停下。
主要能力与流程:目标包含四部分——目标(一句话)、停止条件(可观察可验证的信号,如命令退出码为 0、文件符合规格、测试通过、对齐检查通过)、验证方式(具体命令或产物,如测试/构建/lint/与参考 diff)、约束(不可改动的范围)。任何一项缺失或模糊时,需先询问用户。目标以 goal.md 保存在会话存储中,作为跨轮可读的唯一事实来源;保存后调用 setArtifacts 将其标记为 plan artifact,以便在 UI 中看到实时目标状态。不要把 goal.md 写入工作区,也不要仅依赖 artifact(artifact 仅供 UI 显示,工具无法读回)。
子命令:/goal <objective> 设置目标并开始循环;/goal(无参数)只读取并报告目标、停止条件、状态、检查点数量及最近进度;/goal pause 暂停;/goal resume 恢复;/goal clear 清除状态并停止,但保留文件以便查看历史。
循环:状态为 active 时,每轮读取 goal.md、检查停止条件并运行验证,满足则置为 done 并退出;否则规划下一个小的检查点、执行、验证、在进度日志追加一行并递增检查点计数。max_checkpoints 是安全预算,达到后必须停止并询问用户。
适用场景:有明确可验证终态、跨多轮但进度可衡量、用户希望离开后由智能体继续推进的工作。
限制与纪律:约束包含不可改动内容或需扩大范围时必须暂停并告知;不得虚构停止条件;进度日志必须真实,未运行不得写测试通过;同一时间只能有一个 active 目标。不适合零散无关任务、主观性工作(设计打磨、文案)以及无回滚的破坏性操作(生产部署、强推)。具体要求使用的会话存储等能力,资料中未给出更多安装或配置细节。