Plan Mode
基於 Cursor 官方 Plan Mode 文件解釋先研究、提問、生成計劃、審查編輯，再批准構建的流程。
Plan Mode 是 Cursor 處理複雜任務前的剎車。官方文件說明，它會在寫程式碼之前建立詳細 implementation plan：Agent 先研究程式碼庫、提出澄清問題、生成可審查計劃，你可以編輯計劃後再讓它構建。
閱讀目標：讀完本章，你應該能判斷什麼任務必須先 Plan，並能審查計劃的範圍、檔案、風險、驗證和儲存位置。
1. 怎麼進入 Plan Mode
官方文件列出兩種切換方式：
| 方式 | 說明 |
|---|---|
Shift+Tab | 在 chat input 中迴圈切換到 Plan Mode |
| Mode picker dropdown | 在 Agent 中用模式選擇器切換 |
Cursor 也會在你輸入複雜任務相關關鍵詞時自動建議 Plan Mode。
2. Plan Mode 的官方流程
官方流程可以拆成五步：
flowchart TD
Task["複雜任務"] --> Questions["Agent asks clarifying questions"]
Questions --> Research["Researches codebase"]
Research --> Plan["Creates implementation plan"]
Plan --> Review["User reviews / edits plan"]
Review --> Build["Click to build when ready"]這和普通 Agent 最大區別是：它不是立刻寫程式碼，而是先把“準備怎麼做”暴露出來。
3. 什麼時候用 Plan Mode
官方文件說 Plan Mode 最適合：
| 場景 | 原因 |
|---|---|
| 有多種實現路徑的複雜功能 | 需要先比較方案 |
| 觸碰很多檔案或系統的任務 | diff 風險大，需要先定範圍 |
| 需求不清晰 | 需要先提問和探索 |
| 架構決策 | 需要先審查 approach |
不一定需要 Plan Mode：
- 很小的文案修復。
- 你已經做過很多次的重複小任務。
- 單檔案、低風險、容易回退的改動。
4. Plan 儲存位置
官方文件說明，plans 預設儲存到 home directory。你可以點選 Save to workspace，把計劃移到 workspace，用於未來參考、團隊共享和文件化。
判斷方式：
| 情況 | 建議 |
|---|---|
| 個人臨時探索 | 預設 home 即可 |
| 團隊需要複用方案 | Save to workspace |
| 計劃涉及產品、架構、遷移 | Save to workspace 並納入文件 |
| 計劃包含敏感資訊 | 不儲存進儲存庫，先脫敏 |
Save to workspace 之前先確認計劃裡沒有金鑰、私人路徑、客戶資料或未脫敏日誌。
5. 計劃沒對齊時，回到 plan
官方文件特別提醒：如果 Agent 構建出來的東西不符合預期，不要只靠 follow-up prompts 修補。更穩的是：
- Revert changes。
- 回到 plan。
- 把計劃寫得更具體。
- 再執行一次。
深讀：為什麼重寫 plan 往往比修補 in-progress agent 更快
複雜任務失敗時，問題通常不是“少補一句提示詞”，而是初始方案就不夠精確。繼續在已經偏離的實現上修補，會讓 diff 越來越亂。
回到 plan 等於回到任務邊界：重新定義目標、檔案範圍、技術路線、驗證命令和停止點。對較大的任務，這通常比追著已有錯誤改更乾淨。
6. Plan 審查清單
點 Build 前至少檢查：
- 是否列出相關檔案和模組。
- 是否回答了澄清問題。
- 是否給出明確實現路徑。
- 是否說明測試、lint、build 或瀏覽器驗證。
- 是否有回退策略。
- 是否擴大到未授權範圍。
- 是否包含敏感資訊。
本章自檢
完成本章後，用這 3 個問題檢查自己是否真正理解：
- Plan Mode 和普通 Agent mode 的核心差異是什麼？
- 哪些任務必須先用 Plan Mode？
- 為什麼構建結果不對時，應該考慮回到 plan 而不是繼續追問修補？
透過標準：你能審查一份 Cursor implementation plan，並決定是否 build、修改、儲存到 workspace 或放棄。
官方來源
- Cursor Plan Mode —— 官方說明 Plan Mode 流程、切換方式、適用場景、儲存位置和重新從 plan 開始。
- Cursor Agent Help —— Help Center 說明 Ask / Agent / Plan / Debug 模式選擇。