kpi-dashboard-design

kpi-dashboard-design 技能總覽

kpi-dashboard-design 技能能做什麼

kpi-dashboard-design 技能可協助你設計以決策為導向、而不只是資料很多的 KPI 儀表板。它適合用來規劃儀表板架構、挑選合適指標、將視覺化形式對應到不同 KPI 類型，以及依高階主管、管理者或營運團隊需求整理檢視畫面。若你的實際工作是「把商業問題轉成一個讓人願意相信、也能據此行動的儀表板」，這個技能會非常合適。

誰適合使用這個技能

最適合的使用者包括：

• 負責規劃利害關係人儀表板的分析師
• 需要定義應追蹤內容的產品與營運團隊
• 建立高階 KPI 檢視畫面的創辦人或管理者
• 在實作前需要更完整指標框架的設計師或開發者
• 想得到比泛泛一句「幫我做個儀表板」更好建議的 AI 使用者

這個技能主要解決的工作

多數儀表板專案在畫出任何圖表前就已經失敗：團隊尚未對 KPI 定義、受眾、更新頻率，或儀表板究竟要支援哪些決策達成共識。kpi-dashboard-design 技能特別適合用在你需要以下協助時：

• KPI 的挑選與排序
• 高階、戰術、營運三種儀表板結構的區分
• 趨勢、目標、比較與警示的視覺化選擇
• 指標治理，避免不同數字彼此打架
• 即時監控儀表板的版面模式

為什麼要用它，而不是一般提示詞

一般提示詞可能會產出看起來漂亮的圖表建議。kpi-dashboard-design skill 則提供更有紀律的分析框架：KPI 階層、SMART KPI 思維、依受眾區分的儀表板設計，以及監控模式。這通常會帶來更好的指標選擇，也比較能避免「儀表板很好看，但決策方向錯了」的結果。

這個技能做不到什麼

這不是資料連接器、BI 工具外掛，也不是自動產生儀表板的工具。它不會抓取即時資料、不會驗證 SQL，也無法取代 Tableau、Power BI、Looker、Grafana 或客製化應用中的實作工作。請把它用在儀表板建置前或建置中的設計判斷優化，而不是把它當成端到端分析平台。

如何使用 kpi-dashboard-design 技能

kpi-dashboard-design 的安裝背景

這個技能位於 wshobson/agents repository 的 plugins/business-analytics/skills/kpi-dashboard-design。如果你的 skill runner 支援遠端安裝，請依照你的環境慣用的 GitHub 技能安裝流程操作。常見方式如下：

npx skills add https://github.com/wshobson/agents --skill kpi-dashboard-design

如果你的環境不支援直接安裝，可直接查看原始碼：
https://github.com/wshobson/agents/tree/main/plugins/business-analytics/skills/kpi-dashboard-design

就目前 repository 可見內容來看，這個技能的核心幾乎都集中在 SKILL.md，因此一開始不需要先額外檢查其他輔助檔案。

先讀這個檔案

先從這裡開始：

• plugins/business-analytics/skills/kpi-dashboard-design/SKILL.md

由於這個技能沒有 resources/、rules/ 或其他參考檔案，大多數可直接使用的指引都在這一份文件裡。建議你在開始下提示前先完整讀過一次，了解它如何界定 KPI 層級、SMART KPI、儀表板階層與監控模式。

這個技能需要你提供哪些輸入

kpi-dashboard-design usage 的品質，高度取決於你提供的需求說明。建議至少提供：

• 受眾：executive、manager、team lead、operator
• 業務領域：SaaS、ecommerce、support、finance、product、operations
• 儀表板用途：監控、策略檢視、問題診斷、團隊管理
• 儀表板要支援的決策
• 候選指標及其定義
• 更新頻率：real-time、daily、weekly、monthly
• 限制條件：螢幕尺寸、工具、資料新鮮度、利害關係人偏好
• 已知痛點：數字互相矛盾、圖表過多、權責不清、警示疲勞

缺少這些輸入，輸出通常就會停留在很泛的層次。

把模糊目標變成可用提示

弱提示：

• 「幫我的公司設計一個 KPI 儀表板。」

較強的提示：

• 「Use the kpi-dashboard-design skill to propose an executive SaaS dashboard for a B2B subscription business. Audience is CEO and VP Finance. The dashboard should support monthly planning and early risk detection. Core metrics available are MRR, net revenue retention, gross churn, CAC payback, pipeline coverage, burn multiple, and logo churn. We want one summary page plus drill-down ideas. Highlight which 5 KPIs deserve headline placement, what visual should be used for each, what targets and comparisons to show, and what definitions must be standardized to avoid contradictions.”

之所以這個版本更好，是因為它明確提供了受眾、節奏、決策情境、指標清單與輸出範圍。

適合 Data Visualization 的 kpi-dashboard-design 提示結構

如果你要使用 kpi-dashboard-design for Data Visualization，建議採用以下結構：

1. Context：公司／團隊／職能背景
2. Audience：誰會閱讀這個儀表板
3. Decisions：它應該驅動哪些行動
4. Metrics：可用 KPI，以及已知公式
5. Cadence：real-time、daily、weekly、monthly
6. Output request：版面配置、KPI 排序、圖表建議、drill-down、alerts
7. Constraints：工具限制、畫面空間、資料品質、利害關係人使用習慣

這種寫法，比只要求圖表建議，更能得到高品質的設計輸出。

實務上行得通的使用流程

一個可靠的 kpi-dashboard-design skill 使用方式如下：

1. 先請它判定你的儀表板屬於 strategic、tactical 還是 operational。
2. 請它把 KPI 集合收斂成最小但仍可信的 headline set。
3. 再請它指出各指標定義與治理風險。
4. 接著請它提出頁面階層：summary、drill-downs、exceptions、detail views。
5. 然後請它建議圖表類型與視覺編碼方式。
6. 再問哪些內容應該是 real-time、哪些應該週期性更新。
7. 最後請它批判性檢視你現有的儀表板或 wireframe。

這個順序有助於避免第一次回覆就混進太多不同目標，導致答案失焦。

好的輸出應該長什麼樣子

有用的 kpi-dashboard-design guide 輸出，通常會包含：

• 清楚的儀表板受眾與用途
• 高階檢視只保留 4 到 6 個頂層 KPI，而不是 15 個以上
• 每個 KPI 的納入理由
• 建議的版面階層
• 與指標類型對應的圖表建議
• 目標值、趨勢、基準與差異的呈現方式
• 對指標定義衝突的警告
• 在適合時加入 alerts 或 thresholds 的建議

如果輸出只有一串圖表清單，代表你需要補更多商業背景再問一次。

這個技能最強的使用情境

這個技能特別適合：

• 高階 KPI 儀表板設計
• SaaS 健康度儀表板
• 營運監控看板
• 產品留存或 cohort 檢視
• 重新設計指標衝突或過載的儀表板
• 在 BI 實作前先建立儀表板治理框架

若你要做的是純裝飾性的 UI，或非常技術導向的 BI 建模工作，它的差異化價值就沒那麼高。

常見導入阻礙

在你安裝或正式依賴 kpi-dashboard-design 之前，先留意幾個常見阻礙：

• 團隊尚未定義 KPI 公式
• 利害關係人想用同一個儀表板服務所有受眾
• 沒有人對更新頻率達成共識
• 使用者想把所有能拿到的指標都放上去
• 你期待這個技能能自動產出特定工具可直接使用的儀表板

這個技能能幫你把儀表板思路整理清楚，但無法單靠自己補齊組織內部缺乏對齊的問題。

kpi-dashboard-design 技能 FAQ

kpi-dashboard-design 適合初學者嗎？

適合，尤其是你已經理解自己的商業情境，但還不確定儀表板該怎麼架構時。它提供的框架會比從空白提示開始更好。不過初學者仍然需要提供商業目標與指標定義，否則建議仍會偏高層次。

什麼時候 kpi-dashboard-design 會比一般提示更好用？

當真正困難的點在於 KPI 選擇與儀表板結構，而不是文案措辭時，它就更有優勢。如果你的難題是決定哪些內容該放在主頁、哪些應該做成 headline、哪些該放到 drill-down，或要如何分開高階檢視與營運檢視，那麼這個技能會比單純一句「設計一個儀表板」更有幫助。

這個技能能幫忙改善既有儀表板嗎？

可以。很好的使用場景就是拿來做批判與改版。你可以提供目前的 KPI 清單、受眾，以及像是指標互相矛盾、版面雜亂、無法引導行動等問題，請它指出哪些該刪除、重組、重定義，或提升為更高層級的指標。

它適用於即時監控儀表板嗎？

可以，原始內容明確涵蓋了 real-time monitoring patterns。它很適合用於營運、服務健康度或即時商業監控等場景，尤其在訊號清晰度與門檻設計很重要時更有價值。請務必明確說明你的 alerting needs 與 refresh cadence。

這個技能有綁定特定 BI 工具嗎？

沒有。從目前 repository 結構來看，只有 SKILL.md，沒有任何工具專屬的 scripts 或 assets。這讓技能本身有較高可攜性，但也代表如果你需要可直接落地的實作建議，就應明確要求輸出符合你的目標工具格式。

什麼時候不該使用 kpi-dashboard-design？

若你需要的是以下內容，就不建議單獨使用它：

• SQL generation 或 metric pipeline debugging
• pixel-perfect 的產品 UI 規格
• BI 平台內的自動化儀表板建置
• 比起儀表板結構更偏重深度統計分析

這些情況下，應搭配其他技能或工作流程一起使用。

如何改善 kpi-dashboard-design 技能的使用效果

提供定義，不要只給指標名稱

一個很常見的失敗模式，是以為只給指標名稱就夠了。像是「Churn」、「active users」或「conversion rate」，在不同團隊裡可能代表完全不同的意思。若想提升 kpi-dashboard-design usage，請提供：

• 公式或商業定義
• 分子與分母
• 時間區間
• 分群範圍
• 指標 owner

這樣有助於技能找出衝突，並提出更乾淨的儀表板階層。

要它針對決策最佳化

不要只問「哪些是最佳 KPI」。請改問：

• 每個 KPI 支援哪個決策
• 重要的 threshold 或 target 是什麼
• KPI 發生變化時應採取什麼行動
• 哪些指標是 lead indicators、哪些是 lag indicators

這會讓儀表板更偏向行動導向，而不只是描述現況。

及早區分受眾

儀表板最常見的錯誤之一，就是把高階主管、管理者與一線操作人員的需求混在同一個畫面。若想改善 kpi-dashboard-design 的輸出效果，請一開始就明確指定主要受眾；除非你本來就想要一整套 dashboard suite，否則不要接受混合範圍的輸出。

強迫它做優先排序

如果你一次給 20 個指標，模型很可能會想保留太多。你可以要求它：

• 為所有候選 KPI 排名
• 主頁只保留前 5 名
• 其餘移到 drill-downs
• 說明哪些不適合當 headline KPI，以及原因

這通常會產出更貼近現實的設計方案。

第一版之後要求它做批判性檢討

很有效的迭代模式是：

1. 先拿到第一版儀表板提案
2. 再請它指出弱點、盲點與治理風險
3. 問它哪些地方可能誤導高階主管
4. 問它哪些內容應該刪除
5. 再請它提出修正版版面

很多時候，第二輪才是 kpi-dashboard-design skill 真正開始發揮價值的地方。

提供真實環境限制

越具體的限制，越容易得到更好的輸出，例如：

• 「單一 laptop 螢幕，用於每週高階會議檢視」
• 「wallboard 需能從 10 feet 外看清楚」
• 「必須在 Power BI 中實作，而且 custom visuals 能力有限」
• 「每天更新，不是即時」
• 「利害關係人不信任只有 ratio、沒有 raw counts 的呈現」

這些條件都會實際影響版面與視覺化建議。

把 headline KPI 和診斷型指標分開

如果第一版回答把 summary 和 diagnostics 混在一起，請要求技能拆成：

• headline KPIs：領導層第一眼要看的內容
• diagnostic metrics：用來解釋變動原因的內容
• operational monitors：需要即時回應的內容

這個收斂步驟，能大幅強化儀表板階層。

在提示中使用具體例子

改善版提示範例：

• 「Use kpi-dashboard-design to redesign our customer support dashboard. Audience is support leadership. The current dashboard has 18 charts and users ignore it. Available metrics are first response time, backlog, reopened tickets, CSAT, SLA breach rate, ticket volume by channel, and staffing coverage. We need one summary page for daily review and one drill-down page for queue diagnosis. Recommend what to keep, remove, and group, plus the best chart type for each surviving KPI.”

之所以這個版本更有效，是因為它清楚定義了受眾、痛點、指標清單與需要的輸出。

了解原始資料的限制

這個技能的概念覆蓋面相當實用，但從 repository 的證據來看，它比較像是文件型技能，而不是由 scripts、references 或明確決策規則支撐。因此，最好把它視為強而有力的規劃與框架工具；真正的實作選擇，仍應回到你的 BI stack、data model 與利害關係人驗證。

搭配真實使用者回饋一起檢查 kpi-dashboard-design

想要最快提升輸出品質，最有效的方法就是讓真正會使用儀表板的人來測試提案。你可以請技能產出一份 review checklist，涵蓋：

• 儀表板支援哪些決策
• 每個 KPI 是否值得信任
• 是否有任何圖表難以解讀
• 為了採取行動還缺少什麼
• 哪些內容應該移出主頁

這最後一步，能有效補上「AI 給出不錯的設計建議」與「團隊真的願意使用這個儀表板」之間的落差。