你让智能体改动六个文件，它直接开始编辑，改到第三个文件时你才发现它选了一种你不想要的方案。Verboo Code 的 /plan 可以避免这种情况：智能体先阅读项目并把计划写入文件，等你批准之后才开始编辑。本文介绍相关命令、计划的保存位置，以及批准对话框中的选项。
Verboo Code 的 /plan 是做什么的？
它会在当前会话中开启规划模式。在这个模式下，智能体会先探索代码、设计方案，并把计划保存为 Markdown 文件，而不是直接编辑你的项目。源码中的描述原文是："Enable plan mode or view the current session plan"。
/planCLI 会返回 Enabled plan mode。之后像平时一样描述任务即可。该模式只对开启它的那个会话有效。
如何查看智能体写的计划？
在已处于该模式时再次运行 /plan，CLI 会显示当前计划和文件路径。如果智能体还没写任何内容，返回的是 Already in plan mode. No plan written yet.
/plan想手动修改，使用 /plan open：它会在你的外部编辑器中打开计划文件。前提是已经写出了计划。改完文字、保存、关闭，智能体就会以磁盘上的版本为准继续工作。
/plan open计划保存在哪里？
保存在 ~/.verboo/plans/ 下的一个 .md 文件中，文件名由随机的三个单词组成（形容词、动词和名词）。如果你设置了 VERBOO_CONFIG_DIR，plans/ 文件夹就位于该目录内。
| 配置 | 计划的存放位置 |
|---|---|
| 默认 | ~/.verboo/plans/<随机名称>.md |
设置了 VERBOO_CONFIG_DIR | $VERBOO_CONFIG_DIR/plans/ |
settings.json 中的 plansDirectory | 你指定的文件夹，相对于项目根目录 |
plansDirectory 配置适合把计划和代码一起纳入版本管理。它必须指向项目内部：如果路径超出项目根目录，CLI 会忽略它并退回默认文件夹。
{
"plansDirectory": "docs/plans"
}如何批准计划并让智能体开始编码？
计划完成后，智能体会调用内部工具 ExitPlanMode，弹出批准对话框并显示计划内容。只有涉及编写代码的任务才会请求批准：如果你只是让它在项目里做调研，智能体会直接回答，不会弹出对话框。
对话框中的选项，按源码原样列出（CLI 中的标签是英文）：
| 选项 | 效果 |
|---|---|
Yes, clear context ... and auto-accept edits | 清空上下文（会显示已用比例），批准并让编辑无需逐条确认 |
Yes, auto-accept edits | 保留上下文，编辑无需逐条确认 |
Yes, manually approve edits | 保留上下文，每次编辑仍需你确认 |
No, keep planning | 拒绝计划，你写下要改的地方，智能体重新规划 |
根据你的安装中启用的功能，放行选项的标签会有所不同：auto-accept edits 的位置可能显示为 use auto mode 或 bypass permissions。清空上下文的选项只在有必要时出现。对话框里有两个实用快捷键：Ctrl+G 在编辑器中打开计划，方便你批准前调整；Shift+Tab 直接以 auto-accept edits 批准。
不输入 /plan，如何进入规划模式？
有两种方式。第一种是 Shift+Tab，它会在会话的权限模式之间循环切换。按源码中的顺序，从默认模式开始依次是 default、acceptEdits、plan；在 plan 之后，会根据可用情况进入其他模式或回到默认模式。
第二种是用 --permission-mode 参数，让会话一开始就处于规划模式：
verboo --permission-mode plan你也可以在 settings.json 中用 defaultMode 设为默认，但对多数任务来说，按需开启更实用。当任务看起来很大时，智能体自己也有一个工具可以建议进入规划模式，这时由你批准或拒绝。
关闭后再恢复会话，计划还在吗？
多数情况下在。恢复会话时，Verboo Code 会把同一个计划文件重新关联到该会话。如果文件已从磁盘上消失，它会尝试从快照和对话历史中恢复内容。
这与 /resume 很搭：今天做计划，关掉，明天接着同一份计划继续。如果执行过程中对话变长，/compact 会压缩历史，而保存在磁盘上的计划文件不会丢。
什么时候用 /plan，什么时候不用？
当改动涉及多个文件、有不止一种可行方案，或需求比较模糊时使用：新功能、重构、架构调整。对重命名变量、修改拼写这类小改动就不必了，计划只会多绕一圈。
- 当走错方向意味着要撤销好几个文件时，使用
/plan。 - 计划批准后的长时间执行，可以搭配 /goal。
- 如果仍然跑偏，/rewind 可以撤销编辑。
- 想控制智能体能运行什么，请看 /permissions。
先规划再编辑意味着要多读代码，而读代码就是消耗 token。在 Verboo Code 上，套餐的 token 不限量，所以你可以放心要求一份详细计划，不用盯着计数器：在 verboo.ai 创建账号，更新 CLI，下次大改动时运行 /plan。
