功能

Plan Mode

在 plan 模式中,Agent 会先探索 codebase 并起草 plan,等你批准后才进行编辑。

适用场景

适合架构含糊、需求不明确或影响较大的重构
跳过路径明确的更改、明显的 bug fix、重命名、格式化、纯研究(改用 explore

进入 Plan 模式

  • /plan — 进入 plan 模式(对下一条 prompt 生效)。/plan <description> 会进入并开始 turn。

  • Shift+Tab — 循环切换模式。从 Normal 开始,按一次进入 Plan(之后依次为 Auto(可用时)和 Always-approve)。

当任务看起来含糊时,Agent 可以自行进入 plan 模式。这不是 permission prompt。空闲时使用 Shift+Tab 离开,或在 approval 界面按 q 离开。

审阅与批准

规划完成后,TUI 会打开 plan preview。Auto 和 always-approve 不会跳过此审阅。使用 /view-plan(别名 /show-plan/plan-view)重新打开已保存的 preview。

快捷键操作
a批准并开始构建(或连同待处理 comments 一起批准)
s请求更改(输入 notes,然后按 Enter)
c对所选行或范围添加 comment
q退出 plan 并关闭 plan 模式
Tab在 plan preview 与 prompt 之间切换焦点

即使 plan 为空,也会打开此界面。Plan 模式会保持开启,直到你批准或退出。

注意事项

  • 在你批准之前,只能编辑 session plan 文件。其他编辑工具会被拒绝,即使处于 auto 或 always-approve 模式。Read、bash 和 MCP 仍遵循权限模式。Plan 模式限制的是 edit tools,而不是 shell,因此 bash 仍可通过重定向写入。

  • Subagents 不受父 Agent plan 模式的编辑门禁约束;它们会继承 permission 模式,包括 auto 和 always-approve。

  • 规划时状态显示 plan,审阅界面显示 plan approval。Plan 模式结束时会恢复 auto 或 always-approve 标记。