指標定義工作流
建立商業指標定義知識庫
把核准的 KPI 規格整理成有來源的資料字典，保留公式文字、粒度、維度、排除條件、負責人、來源修訂與複核狀態。
文章封包
Workflows
需要為人員與 AI agent 解決 KPI 定義衝突的資料、分析、產品、財務與營運團隊
8 分鐘閱讀
01
從核准的指標規格開始，不從儀表板或推測公式開始。
02
把公式文字、粒度、維度、排除條件、負責人與來源修訂放在同一筆紀錄。
03
明確取代過期定義，不讓 AI agent 把衝突版本混成一個答案。
信任指標前，先檢查來源修訂與複核狀態
這是 Wenlan App 確定性測試資料的真實桌面畫面，不是公司的分析或財務工作區。畫面顯示帶有來源數量的 Pages 與複核佇列，可用同一產品介面讓衝突或修訂後的指標證據保持可見。
- 01
固定核准規格
選定一組指標、允許的定義檔、排除系統、具名負責人與複核人。
- 02
整理一筆定義
把定義、公式文字、粒度、維度、排除條件、引用、來源修訂與衝突放在同一頁。
- 03
複核後再取代
打開引用來源，檢查矛盾與過期狀態，再標記目前定義並保留被取代版本。
商業指標紀錄示例
這個中立範本不會計算 KPI。請用核准規格與具名領域複核人替換每個欄位。
- 意義與公式文字
- 商業定義、不可執行公式、粒度、維度、納入、排除與例外。
- 負責人與來源
- 負責人、確切 source ID 與位置、來源修訂和生效日期。
- 複核與取代
- 目前有效、過期、矛盾或未解，附複核人、被取代版本與下次複核條件。
01
先說結論：一個指標配一筆有來源、可取代的定義紀錄
每個商業指標維護一筆可複核紀錄：商業定義、不可執行的公式文字、粒度、維度、納入與排除條件、負責人、確切來源與來源修訂、複核狀態，以及它取代的舊定義。兩份核准來源互相衝突時，先保留衝突並交給具名負責人判斷，不讓 AI 自動調和。
Wenlan 可以讀取核准的 Markdown、文字與可擷取文字 PDF，建立有來源 Pages、保留引用與來源修訂、執行 provenance lint 並留下可審查版本。它不會導入 CSV 或 YAML、不會執行 SQL、不會連接資料倉儲或 BI、不會計算指標、不會提供血緣、不會監控資料品質、不會管理權限、不會自動核准，也不會自動調和衝突。
02
為什麼同名 KPI 仍可能不是同一件事
活躍客戶、淨收入或轉換率可能同時出現在財務備忘錄、分析規格、產品儀表板說明與營運手冊，但公式、粒度、時間窗、排除條件或負責人各不相同。把它們整理成一段流暢摘要，反而會隱藏真正需要決策的差異。
可維護的資料字典應該讓每個版本回到確切來源，清楚標記目前有效、過期、矛盾或未解，並在新版核准後保留舊版本與取代關係。即使不用 Wenlan，這也是可獨立採用的指標治理基本紀錄。
03
建立核准規格到指標紀錄的閉環
先選一組指標與少量核准檔案。這個工作流只負責定義查找與衝突處理，不建立所有資料表、儀表板或即時運算的目錄。
- 先記錄指標名稱、商業問題、核准來源、排除系統、具名負責人與複核人。
- 只加入核准的 Markdown、文字或可擷取文字 PDF；CSV、YAML、SQL、資料倉儲 metadata 與 API 不在這個流程。
- 把公式寫成可複核文字，並記錄粒度、維度、時間窗、納入、排除與例外。
- 每個重要欄位連回 source ID、確切標題或頁碼、來源修訂與生效日期。
- 來源衝突時保留兩個版本，標成矛盾或未解，不自行平均或合併。
- 負責人選定目前版本後，記錄取代的舊定義、保留歷史版本並設定下次複核條件。
完成 Wenlan 與 AI 用戶端設定後
wenlan status
wenlan sources add ~/Metrics/approved-specifications
# 在 Wenlan plugin client 中：
/distill <指標定義>
/pages <指標名稱>
/lint
/curate
metric: activated customer
business_definition: <核准來源真正定義的意義>
formula_text: <不可執行的公式文字>
grain: <帳戶 | workspace | 使用者 | 事件>
dimensions: <允許的拆分維度>
inclusions: <納入狀態或事件>
exclusions: <排除狀態、事件或時間窗>
owner: <負責團隊或複核人>
sources: <source ID 與確切位置>
source_revision: <版本或生效日期>
review_state: <目前有效 | 過期 | 矛盾 | 未解>
supersedes: <舊定義或無>
next_review: <來源變更條件或日期>04
指標紀錄應該保留什麼
一筆可用紀錄不只是一句定義。它要讓讀者知道公式文字在什麼粒度成立、哪些狀態被排除、誰有權決定目前版本，以及這個版本依據哪份來源。
05
知道這不是資料目錄、BI 或計算引擎
Wenlan 不會導入 CSV、不會執行 SQL、不會連接資料倉儲、不會同步 BI 或 semantic layer、不會計算 KPI、不會提供欄位血緣、不會監控資料品質、不會管理權限、不會自動核准定義，也不會自動調和衝突公式。具名領域負責人仍要做商業判斷與最終複核。
讓一個指標定義可檢查
從核准規格開始，保留衝突與確切來源，只在具名負責人複核後取代舊定義。
FAQ