Skip to main content
开始一个任务

先规划再执行(Plan)

概述

Plan(规划)让 Qoder 在动手改代码之前,先只读地探索代码、分析问题并给出方案。等你确认方案后,再退出 Plan 开始实际修改。它适合影响面较大、涉及多个文件、或你希望在改动前先看清整体思路的任务。 Plan 是一个独立的工作状态,而不是权限策略——它可以和任意权限模式共存。进入 Plan 后,Qoder 的写入被限制,主要产出是一份方案。

进入与退出

/plan 命令进入或退出 Plan(切换式):
/plan
  • 进入后,Qoder 只读探索代码并输出方案,不会直接修改你的代码。
  • 再次执行 /plan 退出。
也可以在启动时进入 Plan 工作状态:
qodercli --permission-mode plan
--permission-mode plan 为兼容旧用法保留。由于 Plan 是一种工作状态、并非权限模式,该取值会被映射为「默认权限模式 + 进入 Plan 状态」。

工作方式

在 Plan 状态下:
  • Qoder 会读取相关文件、搜索代码、分析现状,弄清楚要做什么、怎么做。
  • 它的写入受到限制,产出集中在一份可供你评审的方案上。
  • 你可以对方案提出修改意见,让 Qoder 调整,直到方案符合预期。
这套"先看清、再动手"的方式,能在复杂任务上减少返工——先把方向定对,再让 Qoder 执行。

配合 Goal 执行

Plan 常和 Goal 搭配使用:先在 Plan 中确认方案,退出 Plan 后用 /goal set 进入 Goal,让 Qoder 按既定方案持续自主执行到完成。这样既保证了方向正确,又能放手让 Qoder 完成后续的实现工作。 Goal 的详细说明见 持续完成目标(Goal)。如果 Goal 执行前 Plan 处于激活状态,Qoder 在跨进程恢复目标时会一并恢复 Plan 状态。

何时使用

  • 影响面大的改动:跨多个文件、涉及公共接口或核心逻辑的修改。
  • 方向不确定:存在多种实现方案,需要先比较再决定。
  • 希望先评审:你想在改动前先看清 Qoder 打算怎么做。
对于简单、明确的小改动,直接在交互模式下让 Qoder 动手通常更快,不必进入 Plan。