指标定义工作流
建立业务指标定义知识库
把获准的 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