---
title: "Plan Mode"
description: "基於 Cursor 官方 Plan Mode 文件解釋先研究、提問、生成計劃、審查編輯，再批准構建的流程。"
verifiedAt: "2026-05-09"
---

Plan Mode 是 Cursor 處理複雜任務前的剎車。官方文件說明，它會在寫程式碼之前建立詳細 implementation plan：Agent 先研究程式碼庫、提出澄清問題、生成可審查計劃，你可以編輯計劃後再讓它構建。

> [!NOTE]
> **閱讀目標**：讀完本章，你應該能判斷什麼任務必須先 Plan，並能審查計劃的範圍、檔案、風險、驗證和儲存位置。

## 1. 怎麼進入 Plan Mode

官方文件列出兩種切換方式：

| 方式 | 說明 |
| --- | --- |
| `Shift+Tab` | 在 chat input 中迴圈切換到 Plan Mode |
| Mode picker dropdown | 在 Agent 中用模式選擇器切換 |

Cursor 也會在你輸入複雜任務相關關鍵詞時自動建議 Plan Mode。

## 2. Plan Mode 的官方流程

官方流程可以拆成五步：

```mermaid
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 並納入文件 |
| 計劃包含敏感資訊 | 不儲存進儲存庫，先脫敏 |

> [!IMPORTANT]
> Save to workspace 之前先確認計劃裡沒有金鑰、私人路徑、客戶資料或未脫敏日誌。

## 5. 計劃沒對齊時，回到 plan

官方文件特別提醒：如果 Agent 構建出來的東西不符合預期，不要只靠 follow-up prompts 修補。更穩的是：

1. Revert changes。
2. 回到 plan。
3. 把計劃寫得更具體。
4. 再執行一次。

<details>
<summary>深讀：為什麼重寫 plan 往往比修補 in-progress agent 更快</summary>

複雜任務失敗時，問題通常不是“少補一句提示詞”，而是初始方案就不夠精確。繼續在已經偏離的實現上修補，會讓 diff 越來越亂。

回到 plan 等於回到任務邊界：重新定義目標、檔案範圍、技術路線、驗證命令和停止點。對較大的任務，這通常比追著已有錯誤改更乾淨。
</details>

## 6. Plan 審查清單

點 Build 前至少檢查：

- 是否列出相關檔案和模組。
- 是否回答了澄清問題。
- 是否給出明確實現路徑。
- 是否說明測試、lint、build 或瀏覽器驗證。
- 是否有回退策略。
- 是否擴大到未授權範圍。
- 是否包含敏感資訊。

## 本章自檢

完成本章後，用這 3 個問題檢查自己是否真正理解：

1. Plan Mode 和普通 Agent mode 的核心差異是什麼？
2. 哪些任務必須先用 Plan Mode？
3. 為什麼構建結果不對時，應該考慮回到 plan 而不是繼續追問修補？

透過標準：你能審查一份 Cursor implementation plan，並決定是否 build、修改、儲存到 workspace 或放棄。

## 官方來源

- [Cursor Plan Mode](https://cursor.com/docs/agent/plan-mode.md) —— 官方說明 Plan Mode 流程、切換方式、適用場景、儲存位置和重新從 plan 開始。
- [Cursor Agent Help](https://cursor.com/help/ai-features/agent.md) —— Help Center 說明 Ask / Agent / Plan / Debug 模式選擇。

## 接下來去哪

<Cards>
  <Card title="Agent Review" description="Plan 執行後，繼續用 Agent Review 檢查本地變更。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/15-agent-review" />
  <Card title="Prompting" description="繼續學習怎樣把任務、上下文、邊界和驗收寫進 prompt。" href="/zh-Hant/docs/cursor/official/01-agent-workflow/13-prompting" />
</Cards>
