---
title: "規劃規則"
description: "根據你的角色與專業背景，自訂釐清與規劃的呈現方式"
---

規劃規則為 **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>