dashboard-design

dashboard-design 技能是 Vizro 專案的核心架構師。它旨在引導使用者在編寫任何實作程式碼之前，完成需求、佈局與視覺化這三個結構化規劃步驟。此技能專為需要使用 Vizro Python 工具組建立互動式生產級 BI 工具的數據分析師、工程師與產品設計師而設。透過強制執行嚴格的規劃階段，此技能能防止常見的設計反模式，並確保最終產出的儀表板是目標明確、以使用者為中心且在技術上紮實的成果。

• 規劃必經的三步驟工作流程：需求收集（步驟 1）、佈局與互動設計（步驟 2）、以及視覺化選擇（步驟 3）。

• 產出標準的 YAML 規格檔案（spec/1_information_architecture.yaml, spec/2_interaction_ux.yaml, spec/3_visual_design.yaml），便於版本控制與協作。

• 強制執行 Vizro 特有的設計限制，包括 KPI 卡片數量限制、導航層級與基於網格的響應式佈局系統。

• 提供 2-5 個編號選項供使用者選擇，加速決策過程，保持設計流程的輕量與迭代性。

• 與 dashboard-build 等後續技能無縫銜接，確保規劃輸出能直接引導建構階段。

• 使用 ASCII 線框圖驗證 UI 元件、篩選器位置與容器互動，確保在建構前達成共識。

• 若使用者缺乏清晰規劃，務必從步驟 1 開始；切勿直接跳轉至實作建構。

• 利用各步驟提供的檢查清單，確保資料來源的可存取性與 KPI 定義的可執行性。

• 對於單頁或簡單的儀表板，步驟可以精簡但絕不可完全省略，以維持結構的一致性。

• 若使用者提供現有的線框圖或原型，請在進入後續步驟前，根據 Vizro 限制驗證現有設計決策。

• 務必將決策記錄在 spec/ 目錄中，以利於跨 AI 對話階段的專案重啟與延續。

• 優先使用內建元件（如 KPI 卡片），除非業務需求明確要求使用高程式碼擴充。