Communitygithub.com

分析儀表板設計

建立、重新設計或審查產品分析儀表板,採用冷靜的 Cloudflare 風格布局——包含顯示變化量與走勢圖的 KPI 列、指標分頁搭配單一圖表、可排序的國家表格、網站到應用程式再到付費的漏斗、買家旅程、留存率群組、應用程式健康狀態、流量來源與事件紀錄——並搭配誠實的數字、隱私優先的追蹤以及螢幕截圖品質檢查。適用於統計頁面、獨立應用程式或 SaaS 分析儀表板、「我的產品表現如何」頁面、管理指標畫面,或當有人問起儀表板數字為何對不起來時。

分析儀表板設計 是什麼?

這個「分析儀表板設計」技能提供了一套結構化方法,用於建立、審查或重新設計產品分析儀表板。其核心哲學是以一個關鍵問題為主軸:產品是否正在成長,以及用戶在哪個環節流失?技能定義了從資料合約定義、頁面布局、元件建構,到誠實性、隱私性與螢幕截圖品質檢查的完整工作流程。它支援多種 JavaScript 框架,但在範例中使用純 HTML/CSS/JavaScript(無依賴關係),確保其可移植性。此技能特別適用於獨立應用程式、SaaS 產品或任何需要數據驅動管理介面的場景。它強調資料的誠實性(例如,正確處理小基數上的百分比變化、明確顯示未知類別)與隱私保護(無 Cookie、無儲存 IP、使用每個安裝隨機 ID),並提供詳細的參考文件(如 metrics.md、layout.md、components.md 等)作為實作指引。透過遵循此技能,開發者可以建立一個不僅美觀,更能建立用戶信任的分析儀表板。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boburjonmavlonov/analytics-dashboard-design-skill/tree/main/skills/analytics-dashboard-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

分析儀表板設計 是做什麼的?

一個產品的儀表板,在初看時要能回答一個問題:它是否在成長,人們在哪裡流失? 頁面上的所有內容都是為了回答這個問題,然後讓擁有者能夠深入探究原因。

此技能源自於建立並執行一款已發行 Mac 應用程式的分析儀表板(網站→下載→安裝→試用→付費)的經驗,以及其擁有者在每次螢幕截圖中發現的每一個錯誤。實際可運作的範例是 examples/product-analytics.html,其中包含固定的範例資料。

如何運作

請按順序執行以下步驟。每個步驟都以一個「完成條件」作為結束,你必須能夠核實該條件。

1. 先撰寫資料合約

在任何 UI 之前,列出頁面上將顯示的每個數字,並針對每個數字記載:它計數的事件、計數時間窗口、是唯一值還是總計值、時區,以及它與哪個「前期」進行比較。將其放入 API 回應的結構中,而非 UI 程式碼中。請參閱 references/metrics.md。

完成條件 當每一個圖塊、欄位和圖表在合約中都有一行對應,並且兩個顯示「相同」數字的位置都從同一個資料欄位讀取時。

2. 佈局頁面

包含區段連結的側邊欄、一個顯示資料新鮮度狀態與期間切換器的固定頂部欄,然後按照使用者旅程順序排列區段:概覽→國家→漏斗→買家→應用程式→留存率→網站→事件。一個內容欄,最大寬度 1280 px。請參閱 references/layout.md。

完成條件 當在 1440 × 900 解析度下,不需要滾動就能從概覽區回答初看的問題時。

3. 從參考資料建構元件

使用 references/components.md 中的模式以及 references/snippets.md 中的程式碼:極細線 KPI 列、帶有「基準線」的變化量、基於圖表時間窗口的走勢圖、單一圖表下方的底線指標分頁搭配表格切換按鈕、可排序的國家表格(排序的欄位中帶有份額長條圖)、帶有步驟轉換率的漏斗長條圖、可展開的買家列(含時間軸)、帶有明確「未回報」區塊的甜甜圈圖、按等級分類的留存率熱力圖。

顏色只能來自 references/tokens.md 中的色票記號;淺色和深色模式都是必需的。

完成條件 當沒有任何元件使用色票記號之外的顏色、圓角半徑或字型大小時。

4. 誠實性檢查

逐節審查 references/metrics.md。常見的陷阱包括:基數為 1 時顯示「−100%」、收入數據落後於支付提供者、將 $0 訂單計為客戶、將每日不重訪客的總和標示為不重訪客、甜甜圈圖的份額默默地排除未回報的人、將猜測的「來源」顯示為事實。

完成條件 當每個數字都說明了其時間窗口,並且每個估計值都明確標示其為估計值時。

5. 隱私檢查

一個人們信賴的產品,其分析功能絕不能變成他們不信任的東西。遵循 references/privacy.md:網站上無 Cookie、不儲存 IP、事件中不包含用戶內容、使用每個安裝的隨機 ID、應用程式中提供退出選項,以及透過每日加鹽雜湊值(而非身份識別)來連結使用者旅程。

完成條件 當你可以直接將事件結構定義貼到產品的隱私權政策中,而無需編輯時。

6. 螢幕截圖品質檢查

執行 references/qa.md 中的程序:在 1440、1024 和 390 px 解析度下,分別拍攝淺色和深色模式的實際螢幕截圖,以及每個期間的截圖,並使用頁面外部計算的數字來核對總數。看圖片,而不是看程式碼。

完成條件 當所有螢幕截圖都清晰無誤,並且已知的總數都匹配時。

適用的規則

  • 旅程順序。 區段應遵循客戶的實際路徑,因此流失情況可以從上到下閱讀。
  • 每個數字都帶有時間窗口,並明確標示。 「期間」、「今天」、「過去 30 天」應顯示在欄位下方或圖塊的提示中。
  • 同類相比。 前期應與當前期間長度相同,並在當前期間開始時結束。
  • 小基數不誇大。 從 0 到 3 應顯示為「新增」,而非「+∞%」;從 1 到 2 的變化量可以顯示,但要低調。
  • 未知是一個類別,而非缺失。 未知的國家、未回報的權限以及無法匹配的來源都應顯示出來,排序在最後,並計入總數。
  • 資料新鮮度必須可見。 在頁面頂部顯示「更新於 09:00 UTC」和「付款同步於 08:57」;當載入失敗時,顯示紅點和通俗易懂的錯誤訊息。
  • 表格始終只需點擊一下即可取得。 每個圖表背後都有精確的每日數值,可透過「表格」切換按鈕查看。
  • 鍵盤與螢幕閱讀器友善。 圖表可以獲得焦點,並使用 ← → 鍵逐步瀏覽資料點;可排序的欄標題是帶有 aria-sort 屬性的按鈕;可展開的列是帶有 aria-expanded 屬性的 role="button" 元素。
  • 無外部依賴。 此處的所有圖表皆可使用 SVG、CSS 圓錐漸層和 Intl API 完成;範例是一個獨立的 HTML 檔案。

風格指南

使用中性灰色,一種藍色作為數列顏色,綠色和紅色僅用於表示好與壞,橙色僅用於品牌標記。基礎文字大小 13.5 px,KPI 數值 24 px,數字與標題使用 600 字重,所有可能變動的數字都使用等寬數字。使用極細線取代陰影。卡片圓角 8 px,控制項圓角 6 px,長條圖圓角 4 px。請參閱 references/tokens.md。

審查格式

當被要求審查一個儀表板(無論是程式碼、URL 還是螢幕截圖)時,請按以下順序回答:

  1. 結論 用一句話說明:它回答了初看的問題嗎?
  2. 不一致的數字 — 同一個指標顯示兩個不同值、總數加不起來、時間窗口不匹配。這些問題應最先提出,因為它們會破壞信任。
  3. 誠實性問題 依據 references/metrics.md。
  4. 隱私問題 依據 references/privacy.md。
  5. 佈局與元件問題,按照它們對擁有者造成困擾的程度排序。
  6. 運作良好的部分 — 簡短說明,但一定要提出來,這樣在重新設計時才不會遺失它們。

每個問題:你看到了什麼,它為何會誤導或造成困擾,以及修正方法。

參考資料

檔案內容涵蓋範圍
metrics.md資料合約、計數時間窗口、變化量、收入、歸因、漏斗、群組
layout.md側邊欄、頂部欄、區段順序、網格、斷點、手機版面
components.md頁面上的每個元件、其狀態及無障礙性
tokens.md淺色與深色模式的色票記號、字體與間距比例
snippets.md變化量、漂亮的軸刻度、區間、走勢圖、甜甜圈圖、長條圖列表、熱力圖分級、複數形式
privacy.md無 Cookie 的訪問、雜湊網路、安裝 ID、退出選項、永不收集的資料
qa.md螢幕截圖協議、已知總數、異常情況檢查表
case-study-typecorrect.md此技能所源自的真實儀表板,以及每條規則所修正的錯誤

相關技能