# Plan Mode (/zh-Hant/docs/verdent-manager/advanced-features/plan-mode)

> 透過智慧需求釐清，將想法轉化為穩健的實作計畫



在 Plan Mode 中，Verdent 透過結構化的需求釐清，將非正式的想法轉化為實作計畫。協作對話與反覆精修，確保在開始實作前先達成共識。

## 你將學到什麼 [#你將學到什麼]

* 何時使用 Plan Mode
* 協作式規劃工作流程
* 智慧需求釐清
* 計畫生成

***

## Plan Mode 的適用時機 [#plan-mode-的適用時機]

在以下情境中，Plan Mode 特別有價值：

| 情境         | 狀況                                              | Verdent 如何協助                                        |
| ---------- | ----------------------------------------------- | --------------------------------------------------- |
| **不完整的想法** | 你有一個想法，但還沒理清路徑。你不確定要花多久，也不知從何開始。                | 你不需要在開始前就想清楚所有事。把模糊的想法變成可執行的計畫。即使只是一句話或不完整的念頭也足以開始。 |
| **計畫驗證**   | 你心中已有計畫，但不確定是否涵蓋了所有面向。你有經驗也有大致做法，但不確定是否涵蓋了所有情況。 | Verdent 檢查缺口並穩定計畫。把「這應該行得通」變成可靠的結果。主動補上缺失的部分並驗證風險。  |

***

## Plan Mode 工作流程 [#plan-mode-工作流程]

<Steps>
  <Step title="切換到 Plan Mode">
    按下 `Shift+Tab`（macOS：`Cmd+.`；Windows：`Ctrl+.`）即可切換。描述你的想法，不完整也完全沒問題。
  </Step>

  <Step title="主動釐清">
    一起腦力激盪，釐清目標，揭示缺口與風險。Verdent 協助你把問題清楚地表達出來。
  </Step>

  <Step title="掌握主導權">
    接受、修改或略過建議，不會被僵化的工作流程卡住。
  </Step>

  <Step title="生成可執行計畫">
    零散的想法被整理成清晰、結構化的步驟，並搭配工作流程圖。
  </Step>

  <Step title="一鍵執行">
    每個步驟都可見、可暫停、可編輯。全程完全透明。
  </Step>

  <Step title="清晰交付">
    完成後提供完整摘要，並清楚說明程式碼變更。
  </Step>
</Steps>

***

## 主要功能 [#主要功能]

| 功能        | 說明                          |
| --------- | --------------------------- |
| **模式選擇**  | Plan Mode 與你協作定義計畫，達成共識後再執行 |
| **互動式釐清** | Verdent 主動提問，消除任務中的模糊之處     |
| **結構化規劃** | 零散的思緒被整理成清晰的計畫，並搭配工作流程圖     |

***

## 智慧需求釐清 [#智慧需求釐清]

Verdent 以技術夥伴的身分參與其中：

<Tabs>
  <Tab title="探索式對話">
    透過多輪對話挖掘隱含的需求：

    * 邊界情況識別與技術限制發現
    * 在實作前主動解決模糊之處
    * 透過協作討論反覆精修
  </Tab>

  <Tab title="領域專業">
    運用軟體工程最佳實務：

    * 建議最佳做法、設計模式與技術選擇
    * 提供利弊權衡分析，協助做出明智決策
    * 推薦業界標準的解決方案與框架
  </Tab>

  <Tab title="便利互動">
    支援便利的釐清互動：

    * 修改釐清選項
    * 補充資訊與上下文
    * 略過釐清
    * 回退變更並重新提交
  </Tab>
</Tabs>

***

## 釐清循環 [#釐清循環]

在 Plan Mode 中，Verdent 透過互動式問卷提出釐清問題，讓你在實作前協作確認需求。

* **多選題** - 從預先定義的答案選項中選擇
* **自訂答案** - 當選項都不適合時，自行撰寫答案
* **混合方式** - 選擇一個選項並補充自訂說明

### 精修控制項 [#精修控制項]

釐清循環過程中可用的互動：

* **修改選項** - 調整呈現的多選選項，使其更符合你的情境
* **略過釐清** - 當需求已足夠清楚時，依 Verdent 的最佳判斷繼續
* **回退變更** - 還原至先前的釐清狀態並重新提交不同的答案

***

## 計畫生成 [#計畫生成]

Verdent 生成可供開發者直接使用的計畫，內容包含：

* 目標、範圍與成功標準的高層摘要
* 元件結構與相互關係
* 資料模型與 API 合約
* 技術堆疊的考量

***

## 常見問題 [#常見問題]

<AccordionGroup>
  <Accordion title="如何切換到 Plan Mode？">
    按下 `Shift+Tab`（macOS：`Cmd+.`；Windows：`Ctrl+.`）即可在 Plan Mode 與 Agent Mode 之間切換。你也可以點擊輸入框中的 Switch Mode 按鈕。
  </Accordion>

  <Accordion title="我應該在什麼時候使用 Plan Mode 而非 Agent Mode？">
    對於複雜功能、架構決策，或當你想在實作前先審視做法時，請使用 Plan Mode。對於簡單明瞭的任務，則使用 Agent Mode。
  </Accordion>

  <Accordion title="我可以略過釐清問題嗎？">
    可以。當需求已足夠清楚時，使用「略過釐清」選項，依 Verdent 的最佳判斷繼續。
  </Accordion>

  <Accordion title="我的計畫會被儲存嗎？">
    請 Verdent 將計畫儲存為 markdown 檔案，以供日後參考。
  </Accordion>

  <Accordion title="我可以在執行前修改計畫嗎？">
    你可以在 Plan Mode 中請 Verdent 修訂計畫。滿意後，切換到 Agent Mode 來執行。
  </Accordion>

  <Accordion title="Plan Mode 會消耗點數嗎？">
    會。Plan Mode 的操作會根據所使用的模型與處理的 token 消耗點數，與 Agent Mode 相同。
  </Accordion>
</AccordionGroup>