Plan、Goal 与 Loop

Plan

Plan 让 Qoder 在做任何代码改动之前，以只读方式探索代码库、分析问题并提出方案；你批准后再退出 Plan 模式去实际修改。Plan 是独立的工作状态，不是权限策略，可与任何权限模式共存；Plan 状态下写入权限受限，主要产出是供你评审的计划。用 /plan 切换（再运行一次退出），也可以启动时 qoder --permission-mode plan。当 Qoder 自己提议进入或离开 Plan 时，在所有权限模式（包括 YOLO 和 Auto）下都会先请你确认；不想让它打断 YOLO/Auto 会话，可在设置里 general.plan.enabled: false（重启生效，此后 /plan 和 --permission-mode plan 都被拒绝）。适用：影响面大的改动（多文件、公共接口、核心逻辑）、方向不确定需要比较方案、想先看它打算怎么做。Plan 常与 Goal 配合：先在 Plan 里确认方案，退出后用 /goal 让它自主执行。

Goal

Goal 是自主执行模式，适合有明确完成条件、想让 Qoder 持续工作直到达成的场景，如「修复所有失败的测试」「完成重构直到构建通过」。交互会话里 /goal <目标描述> 创建，例如 /goal Fix all failing unit tests until all npm tests pass。Goal 不改变权限模式，执行期间的工具审批仍遵循当前模式，无人值守请先切到 auto 或 yolo；界面显示目标状态指示。用 --turns N（正整数）限制最大对话轮数，达到后停下等你指示：/goal … --turns 30；/goal status 查看进度。

Loop

/loop 让 Qoder 反复运行同一个提示或斜杠命令，适合轮询状态、持续检查、周期性重复动作。两种节奏：固定间隔（给出间隔，如 /loop 5m …，转成周期调度创建定时任务）和动态节奏（省略间隔，如 /loop monitor CI，Qoder 运行后自行决定下次何时运行，60 秒到 3600 秒，不再调度时循环结束）。格式 /loop [interval] [flags] <prompt>，标志含持久化（--durable、--permanent）和预算上限（--max-turns、--max-credits）；省略提示且存在 .qoder/loop.md 时循环该任务清单。创建后立刻执行一次，而不是等第一个间隔。需要精确日历调度（如「每周一上午 9 点」）用定时任务（Scheduled Tasks）。