概述
Plan(规划)让 Qoder 在动手改代码之前,先只读地探索代码、分析问题并给出方案。等你确认方案后,再退出 Plan 开始实际修改。它适合影响面较大、涉及多个文件、或你希望在改动前先看清整体思路的任务。
Plan 是一个独立的工作状态,而不是权限策略——它可以和任意权限模式共存。进入 Plan 后,Qoder 的写入被限制,主要产出是一份方案。
进入与退出
用 /plan 命令进入或退出 Plan(切换式):
- 进入后,Qoder 只读探索代码并输出方案,不会直接修改你的代码。
- 再次执行
/plan退出。
--permission-mode plan 为兼容旧用法保留。由于 Plan 是一种工作状态、并非权限模式,该取值会被映射为「默认权限模式 + 进入 Plan 状态」。
工作方式
在 Plan 状态下:
- Qoder 会读取相关文件、搜索代码、分析现状,弄清楚要做什么、怎么做。
- 它的写入受到限制,产出集中在一份可供你评审的方案上。
- 你可以对方案提出修改意见,让 Qoder 调整,直到方案符合预期。
配合 Goal 执行
Plan 常和 Goal 搭配使用:先在 Plan 中确认方案,退出 Plan 后用 /goal set 进入 Goal,让 Qoder 按既定方案持续自主执行到完成。这样既保证了方向正确,又能放手让 Qoder 完成后续的实现工作。
Goal 的详细说明见 持续完成目标。如果 Goal 执行前 Plan 处于激活状态,Qoder 在跨进程恢复目标时会一并恢复 Plan 状态。
何时使用
- 影响面大的改动:跨多个文件、涉及公共接口或核心逻辑的修改。
- 方向不确定:存在多种实现方案,需要先比较再决定。
- 希望先评审:你想在改动前先看清 Qoder 打算怎么做。