跳轉到主要內容
計畫模式會將工作階段切換為唯讀狀態,讓代理可以探索程式碼庫並草擬實作計畫,而不會進行任何變更。您可以審查計畫、核准或要求修改,代理核准後才會開始撰寫程式碼。

進入計畫模式

有兩種方式可進入計畫模式:
  • /plan 指令 —在聊天輸入列中輸入 /plan(可選擇性地接上任務描述)。工作階段會在代理回合開始前立即進入計畫模式。空白工作階段的建議區塊中有一個 Plan 快捷按鈕可直接插入。
  • 代理主動進入 —當您明確要求代理先規劃(「先規劃一下」、「在開始寫程式碼前寫個計畫」),代理會自行進入計畫模式。代理不會在一般請求中自行啟動。
/plan 為設定頁面加入深色模式支援

代理可以做什麼

計畫模式啟用時,工作階段為唯讀,但有幾項例外:
動作允許
讀取檔案、glob、grep
產生 explore 子代理
寫入 plan/ 內的檔案
寫入 plan/ 外的檔案
執行 shell 指令唯讀沙箱
MCP 工具封鎖
工作階段異動工具封鎖
計畫模式期間產生的子代理會繼承相同限制。 代理會探索專案,然後將 markdown 計畫儲存至 plan/ —例如 plan/2026-06-12-dark-mode.md。計畫遵循結構化格式,包含標頭(目標、架構、技術棧)、檔案清單,以及使用核取方塊語法(- [ ])的細粒度任務。

審查計畫

當代理完成計畫撰寫後,訊息列下方會出現審查面板。面板顯示:
  • 渲染後的計畫 markdown(可摺疊)
  • 直接開啟計畫檔案的連結
  • Approve planRequest changes 按鈕
Approve 會退出計畫模式,代理隨即開始實作已核准的計畫。 Request changes 會開啟回饋文字區域。描述需要變更的內容並送出—代理會修改計畫檔案並再次請求核准。

實作計畫

核准後,代理會依固定的紀律實作計畫:
  • 依序處理各項任務,逐步精確執行,且不略過該步驟的驗證。
  • 每完成一個步驟,就在計畫檔案中勾選對應的核取方塊(- [ ]- [x])。
  • 當專案為 git 儲存庫時,每完成一項任務便提交一次。
  • 若遇到阻礙—缺少相依套件、指示不明確,或某項驗證持續失敗—代理會停下來詢問您,而非自行猜測。
  • 完成最後一項任務後,代理會針對受影響的範圍執行測試與 lint,並總結已建置的內容。

執行既有計畫

您也可以實作先前儲存的計畫—在其他工作階段中,或在原工作階段已關閉之後。輸入 /plan execute 並接上計畫的路徑(也可使用 run 別名):
/plan execute plan/2026-06-12-dark-mode.md
這會在一般的讀寫工作階段中執行—不會進入計畫模式。代理會先讀取計畫並批判性地審查,在開始前向您提出任何缺口,接著以與已核准計畫相同的紀律進行實作。路徑相對於專案根目錄;若檔案不存在或位於專案之外,CTOR 會顯示通知,且不會開始任何回合。

進度追蹤

核准計畫後—或以 /plan execute 執行計畫時—訊息下方會出現進度列。當代理完成每個步驟時,會在計畫檔案中勾選核取方塊(- [ ]- [x]),進度列會即時更新已完成/總計數。 進度列顯示計畫標題(來自第一個 # 標題)、填充列,以及開啟計畫檔案的連結。按一下 × 可在不需要時關閉它。 進度狀態在工作階段切換與應用程式重新啟動後仍會保留。

退出計畫模式

核准計畫後,計畫模式會自動結束。您也可以手動退出:
  • 輸入 /plan exit(或 /plan off/plan cancel/plan stop/plan quit
  • 按一下指示列上的 Exit plan mode
退出會取消任何待審核的核准請求,並恢復完整的讀寫存取權限。