Verdent Docs
Core Features

規劃規則

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

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

你將學到

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

規劃規則可自訂的內容

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

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

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

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

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

  • Mermaid 圖表 - 流程圖、序列圖、狀態機(自動產生或明確指定)
  • DOM 階層樹 - 以樹狀資料夾格式呈現元件結構
  • 線框圖 - UI 草圖與版面草稿
  • 樣式表 - 含合併儲存格的 CSS 規格,依元件組織

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

  • 預設省略 - 測試、樣式、向後相容性(縮短計畫長度)
  • 必要元素 - 驗收標準、邊界案例、KPI(確保可上線品質)
  • 釐清偏好 - 多輪釐清 vs 單次確認 vs 不確認

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

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

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


角色導向計畫範本

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

重點: 具視覺結構的技術實作計畫

主要特性:

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

最適合: 需要視覺架構與清晰實作路徑的前端開發者

重點: 全面的測試案例產生與品質保證

主要特性:

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

最適合: 需要系統化測試涵蓋率的 QA 工程師與測試自動化專家

重點: 從商業角度出發的產品需求

主要特性:

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

最適合: 定義商業需求且不希望摻雜技術內容的產品經理


自訂規劃規則

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

規則組成:

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

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

規則套用:

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

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


另請參閱