Verboo Code：如何用 /goal 让智能体专注一个目标

你交代了一个大任务，中途回答了两个问题，批准了一条命令，回过神来却发现智能体正在打磨一个和需求毫无关系的细节。Verboo Code 在 0.15.35 版本（2026 年 9 月 30 日）加入的 /goal 解决的就是这个问题：你为会话记录一个目标，在你关闭它之前，它会在每一轮都重新交给智能体。本指南介绍相关命令、背后的机制，以及目标卡住时该怎么办。

Verboo Code 的 /goal 是做什么的？

它为当前会话记录一个持久目标，并在目标处于激活状态时，每一轮都把它重新注入智能体的上下文。智能体会立即开始执行，你不需要再发一条消息。

源码中的描述原文是："Set and track a persistent goal for this session"。目标激活期间，CLI 底栏会以绿色显示 Goal active:，后面跟着你所提需求的摘要，最多 54 个字符。

如何设定目标？

在命令后面直接写目标。要具体说明怎样才算完成，因为智能体每一轮重读的就是这段文字。

/goal 把支付模块从回调迁移到 async/await，并让 src/payments 下的所有测试通过

CLI 会回复 Goal set: 和记录下来的文字，智能体随即开始工作。如果已经存在一个内容不同且未完成的目标，回复会是 Goal replaced:：新目标替换旧目标，而不是叠加。

/goal 有哪些命令？

一共七种写法，全部来自 CLI 自带的帮助（/goal help）：

命令	作用
/goal <objective>	设定或替换目标，并开始执行
/goal 或 /goal status	显示当前目标及其状态
/goal pause	暂停：目标不再被注入，底栏变为黄色
/goal resume	恢复已暂停或受阻的目标，智能体重新开始工作
/goal complete	标记为完成，底栏消失
/goal clear	删除目标（也接受 stop、off、reset、cancel）

如何知道目标进展到哪一步？

看底栏，或者运行 /goal status。状态共有四种，每种对应一种颜色：

/goal status

状态	底栏	智能体是否收到目标？
active	绿色	是，每一轮都会收到
paused	黄色	否
blocked	红色	是，并附带停止重试、向你求助的指示
completed	隐藏	否

智能体能自己关闭目标吗？

可以标记为完成，但只能在目标真正达成之后。为此，Verboo Code 为智能体提供了一个内部工具 GoalUpdate，它接受三种状态：complete、paused 和 blocked。

随目标一起发送的提醒会告诉智能体：除非你要求，否则不要暂停。而且只有主会话能改动目标：子智能体收不到提醒，如果尝试更新，会收到 "Only the main session can update its persistent goal."。想自己关闭，运行 /goal complete 即可。

目标变成 blocked 时怎么办？

修复原因，然后运行 /goal resume。只有当同一个阻碍在你连续 3 轮中反复出现时，才会进入 blocked 状态，此后智能体会停止硬试，转而询问还缺什么。

这条规则写在源码里：智能体第一次和第二次遇到同一个问题时（缺少凭据、服务宕机、测试依赖只有你才有的东西），只会记录这个阻碍，并继续尝试其他办法。连续第三次时，目标变为 blocked，原因会显示在 /goal status 的 Blocker: 一行。

/goal status
/goal resume

resume 会清除已记录的阻碍，并把目标恢复为 active。如果目标已经完成，则不会重新打开：CLI 会回复 "This goal is already complete. Set a new goal with /goal <objective>."。

目标保存在哪里？

每个会话一个 JSON 文件，位于 ~/.verboo/goals/<session-id>.json，权限仅限你的用户（600）。如果设置了 VERBOO_CONFIG_DIR，goals/ 文件夹就在它下面。

实际意义是：目标不只存在于进程内存中，你可以直接在磁盘上查看记录的内容。

cat ~/.verboo/goals/*.json

什么时候该用 /goal，什么时候不用？

适合需要中途交互的多步骤任务：迁移、带测试的重构、批量修复 issue。只需一次回答的请求则不必使用：目标只会占用上下文空间。

它和 /compact 搭配很好。压缩后的摘要可能丢失原始需求的细节，而 /goal 的目标之后仍会持续注入。如果智能体在途中做了一次糟糕的修改，/rewind 可以撤销它，而不必放弃目标。