# 規劃規則 (/zh-Hant/docs/verdent-for-vscode/core-features/plan-rules)

> 根據你的角色與專業背景，自訂釐清與規劃的呈現方式



規劃規則為 **Plan** 階段提供支援，能個人化調整 Verdent 呈現需求、釐清內容與實作計畫的方式。你可以使用內建的角色範本作為起點，或建立完全符合你思考風格與工作習慣的自訂規則。

### 你將學到 [#你將學到]

* 規劃規則如何自訂計畫呈現方式
* 內建角色範本（前端、測試、產品經理）
* 建立自訂規劃規則
* 規劃規則何時套用

***

## 規劃規則可自訂的內容 [#規劃規則可自訂的內容]

規劃規則控制 Verdent 在 Plan Mode 中呈現計畫的方式：

<Tabs>
  <Tab title="呈現格式">
    * **摘要—細節—摘要** - 開頭放執行摘要，中間放詳細步驟，結尾放影響摘要
    * **圖表優先** - 以視覺化呈現為主，文字提供輔助說明
    * **表格 vs 敘述** - 結構化表格適合快速瀏覽資料，散文適合脈絡說明
    * **段落排序** - 自訂哪些段落優先出現，並定義階層

    <Tip>
      在著重快速理解的利害關係人審查中，使用摘要—細節—摘要。當深入實作前必須先理解架構時，使用圖表優先。
    </Tip>
  </Tab>

  <Tab title="內容深度">
    * **高層策略** - 著重「做什麼」與「為什麼」，技術細節最少
    * **詳細技術** - 包含實作細節、程式碼模式、架構決策
    * **程式碼範例** - 控制是否出現程式碼（包含/排除、完整 vs 片段、diff 格式）
    * **測試內容** - QA 工作流程預設包含，PM 導向的計畫則省略

    <Tip>
      讓內容深度符合你的受眾。跨團隊協作時使用高層策略，獨自實作或與資深開發者合作時使用詳細技術。
    </Tip>
  </Tab>

  <Tab title="視覺元素">
    * **Mermaid 圖表** - 流程圖、序列圖、狀態機（自動產生或明確指定）
    * **DOM 階層樹** - 以樹狀資料夾格式呈現元件結構
    * **線框圖** - UI 草圖與版面草稿
    * **樣式表** - 含合併儲存格的 CSS 規格，依元件組織

    <Tip>
      Mermaid 圖表會在要求時根據計畫內容自動產生。若你想預設包含，請在規劃規則中明確要求特定圖表類型。
    </Tip>
  </Tab>

  <Tab title="預設行為">
    * **預設省略** - 測試、樣式、向後相容性（縮短計畫長度）
    * **必要元素** - 驗收標準、邊界案例、KPI（確保可上線品質）
    * **釐清偏好** - 多輪釐清 vs 單次確認 vs 不確認

    <Tip>
      先從省略開始讓計畫精簡，再僅針對你實際需要的內容加入必要元素。你隨時可以在特定計畫工作階段中要求省略的內容。
    </Tip>
  </Tab>

  <Tab title="角色專屬">
    * **前端** - 含圖表、DOM 樹、樣式表的視覺架構，預設省略測試
    * **QA/測試** - 含涵蓋率矩陣的測試案例表、邊界值分析、可追溯性
    * **產品經理** - 僅商業需求、圖表/線框圖、無程式碼片段

    <Tip>
      先從角色範本開始，再從中自訂。多數開發者以前端或 QA 範本為基礎，再調整特定段落以符合自己的工作流程。
    </Tip>
  </Tab>
</Tabs>

***

## 角色導向計畫範本 [#角色導向計畫範本]

Verdent 提供專業角色範本，能自動調整計畫結構、內容深度與呈現風格：

<Tabs>
  <Tab title="前端">
    **重點：** 具視覺結構的技術實作計畫

    **主要特性：**

    * 規劃前進行全面的程式碼庫研究
    * 用於互動流程的 Mermaid 流程圖與狀態圖
    * 以樹狀資料夾格式呈現 DOM 階層
    * 用於 CSS 屬性、含合併儲存格的樣式表
    * **省略：** 預設省略測試內容與樣式（除非要求）
    * **提供：** 明確的解決方案，不提供多種選項

    **最適合：** 需要視覺架構與清晰實作路徑的前端開發者
  </Tab>

  <Tab title="測試">
    **重點：** 全面的測試案例產生與品質保證

    **主要特性：**

    * 目標導向的測試設計（商業邏輯、安全性、穩定性）
    * 含 9 欄 Markdown 表格的結構化測試案例
    * 等價類別、邊界值與關鍵參數
    * 完整涵蓋：正常、替代、例外與邊界案例
    * 著重可執行性並支援自動化
    * 可追溯至需求點

    **最適合：** 需要系統化測試涵蓋率的 QA 工程師與測試自動化專家
  </Tab>

  <Tab title="產品經理（PM）">
    **重點：** 從商業角度出發的產品需求

    **主要特性：**

    * **無程式碼片段或技術實作**
    * 著重於**做什麼**與**為什麼**，而非**如何做**
    * 序列圖、流程圖與線框圖
    * 含優先級與 Before/After 比較的需求清單
    * 含處理策略的邊界案例
    * 含 KPI 與事件追蹤的資料規格

    **最適合：** 定義商業需求且不希望摻雜技術內容的產品經理
  </Tab>
</Tabs>

***

## 自訂規劃規則 [#自訂規劃規則]

透過定義以下項目來建立個人化的規劃規則：

**規則組成：**

* **呈現風格** - 摘要—細節—摘要、圖表優先或表格格式
* **內容深度** - 高層概覽 vs 詳細實作
* **省略項目** - 預設要排除的內容（測試、樣式、向後相容性）
* **必要元素** - 必須包含的段落（圖表、驗收標準、資料規格）
* **互動偏好** - 釐清方式、確認需求

<Tip>
  在 Plan Mode 中，點擊輸入框內的 **Plan Rules** 按鈕，即可快速存取並修改你的規劃規則。
</Tip>

**規則套用：**

* 套用於所有 Plan Mode 工作階段
* 跨工作區工作階段持續保留
* 可透過行內指令覆寫
* 可與自訂子代理搭配運作

**了解更多：** 在你的工作區中建立或編輯 `Plan.md`，使用 Markdown 格式定義自訂規劃規則。

***

## 另請參閱 [#另請參閱]

<CardGroup cols="3">
  <Card title="專業規劃" icon="diagram-project" href="/docs/verdent-for-vscode/core-features/professional-plan">
    將想法轉化為實作計畫
  </Card>

  <Card title="釐清循環" icon="message-dots" href="/docs/verdent-for-vscode/core-features/clarification-loop">
    互動式需求精煉
  </Card>
</CardGroup>