Community影像github.com

dataviz

將資料列轉換為一張誠實的圖表。根據問題選擇圖表類型,以內嵌 SVG 或 CSS 建構,無需任何圖表函式庫,並保持可讀性:一個強調色、柔和的網格、等寬表格數字、零基線、真實單位以及每個數值的比較。

dataviz 是什麼?

Dataviz 是一個 AI 代理技能,專門將原始資料轉換為語義清晰、視覺上誠實的圖表。它的核心原則是「一個圖表回答一個問題」,因此技能會根據使用者想要回答的具體問題(例如趨勢、比較、佔比)來決定圖表類型(如折線圖、長條圖、堆疊圖、進度條等)。所有圖表均以內嵌 SVG 或純 CSS 建構,不依賴任何 JavaScript 圖表函式庫,從而保持輕量、無障礙,且易於整合到現代前端框架或靜態頁面中。 此技能支援多種平台與情境,包括但不限於 Claude Code、Cursor 以及任何能執行 Node.js 腳本的開發環境。它可以透過 CLI 命令快速生成 SVG 檔案,也提供手動建構的內部元件配方。除了技術實現,Dataviz 還強調一系列嚴格的視覺與倫理規則:使用單一強調色、零基線、等寬數字排版、真實單位與比較,並明確禁止使用虛假資料、彩虹色盤、雙軸或 3D 圖表。它要求每個圖表都包含 accessible 屬性(role、title、desc),並確保在 375px 寬度和 200% 縮放下仍然可讀。總之,Dataviz 不僅是一個工具,更是一套資料視覺化的最佳實踐指南,適合用於報告、儀表板、KPI 磁貼或任何需要將佔位圖表轉化為真實數據視覺化的場合。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsdanylol/claude-sitecraft/tree/HEAD/skills/dataviz

Installed? Explore more 影像 skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

dataviz 是做什麼的?

一張圖表就是一個問題的答案。如果你無法用一句話說出那個問題,你就無法選對圖表,而一張不回答任何問題的圖表,只是上面寫著數字的裝飾品。

好的圖表長怎樣

  • 一張圖表只回答一個問題。 標題就是那個問題,或是它的答案。「每月跑步次數」,而不是「分析總覽」。
  • 圖表類型跟隨問題。 趨勢用折線圖,比較用長條圖,佔比用一個堆疊長條圖,單一目標用進度條,排名用帶有細長條的清單。
  • 一個強調色。 只有重要的東西使用強調色。其他所有東西都是同一色階的中性色調。絕不在一個數列中使用彩虹色盤。
  • 任何帶面積的圖表都從零開始。 長條圖和堆疊長條圖一律從零開始。如果折線圖的起點非零,則必須讓截斷處可見並標明。
  • 柔和的裝飾。 網格、座標軸和標籤都是低調的。資料是唯一醒目的東西,而且其中只有一個數列是醒目的。
  • 可讀的數字。 標籤中帶單位、使用統一格式、tabular-nums(等寬數字)、沒有誇大精度的尾隨小數。

執行程式

  1. 寫下問題。 一句話:這張圖表能幫助某人做出什麼決定。如果是「顯示資料」,那就砍掉它,或改成一個表格。
  2. 選擇圖表類型:參考 references/charts.md。該文件也會指出那些看起來對但其實是錯的圖表,通常是指甜甜圈圖。
  3. 整理資料列。 一個表格,每種類別一行,每個數列一列,數字已經是你想顯示的單位。CSV 或 JSON 格式,不要做兩次預彙總。
  4. 建構圖表。
    • 快速路徑:node <skill folder>/scripts/chart.mjs data.csv --type line --title "Runs per month" --unit runs --accent "#e0a458" --out chart.svg
    • 支援類型:line, bar, stacked, sparkline, progress。選項:--width --height --theme dark|light --subtitle --xlabel --ylabel --decimals --max。
    • 它會輸出獨立的 SVG,包含 role="img"、<title>、<desc>、等寬表格數字和柔和的網格。可以直接放入頁面使用,或內嵌以用頁面的 token 來設定樣式。
    • 當圖表需要放在元件內部時,可以手動建構:references/charts.md 中的配方是純 SVG 和 CSS,無任何依賴。
  5. 檢查圖表:對照下面的檢查清單,並以實際將被觀看的大小來檢查。在 720 寬度下可讀的圖表,在 280 寬度下不見得可讀。

這不只是品味問題,而是規則

  • 簡單的圖表不要用圖表函式庫。 四個長條加上一條折線只需要 30 行 SVG。一個函式庫佔用 40 到 120 KB,帶來需要覆寫的預設樣式,而且通常會輸出螢幕閱讀器無法讀取的 canvas。
  • 不要用多種顏色來表示同一個數列。 一個強調色,一個主導的數列。一張圖表中超過三個數列,就應該拆成兩張圖表或改成一個表格。
  • 顏色絕不能是唯一的信號。 使用直接標籤、位置或形狀差異。一張在灰階模式下失效的圖表,對每十二位男性中就有一位(色盲)是失效的。
  • 文字是真實的文字。 使用 SVG <text>,而不是路徑,這樣才能隨著讀者的設定縮放。不要將標籤嵌入圖片中。
  • 尊重容器。 使用 viewBox 加上 width:100%、height:auto、max-width,以及一個當標籤無法容納時的 min-width。在 375 寬度下,使用更少的刻度與更少的長條,而不是縮小整張圖表。
  • 不要使用假資料。 如果數字只是佔位符,請在標題旁邊標明,並在報告中列出。[需要:真實跑步次數] 勝過一個看似合理的虛構數字。
  • 單位與比較。 「47 次跑步」或「$48,210」,而不是「47」。任何變化都必須帶有比較對象:「+12% 與上個月相比」。
  • 圖表有層級。 每張畫面只有一張主要的圖表,且明顯是最大的。如果出現另一張相同大小的圖表,代表兩者都不是重點。

檢查清單

  • 圖表回答了一個明確的問題,且標題說明了該問題
  • 圖表類型與問題匹配;沒有甜甜圈圖、沒有六塊的圓餅圖、沒有 3D、沒有雙 Y 軸
  • 長條圖和堆疊長條圖從零開始;任何截斷的折線圖都有標明
  • 重要的數列或數據點使用一個強調色;其他一切都是中性色
  • 超過三個數列時,拆分為兩張圖表或一個表格
  • 網格和座標軸低調,無圖表邊框,無陰影
  • 標籤使用等寬數字,統一的數字格式,帶有單位
  • 當有多個數列時提供圖例;只有一個數列時則不需要圖例
  • 每個顯示變化的數值都帶有其比較對象
  • role="img"、<title> 和 <desc> 以文字描述圖表顯示的內容
  • 在 375 寬度和 200% 縮放下可讀;無任何元素被裁切,無標籤重疊
  • 在灰階模式下可辨識;顏色不是區分數列的唯一方式
  • 佔位資料在頁面中標明,並在報告中列出
  • 數字可以追溯到一個可命名的來源

圖表類型對照表、常見但錯誤的圖表選擇,以及手動建構的 SVG 和 CSS 配方:references/charts.md。

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

相關技能