指标定义卡

用途

把一个业务指标收成可对齐的定义卡,固定包含:

名称与用途 — 指标名、业务问题
口径 — 计入/排除规则
公式或计算说明 — 可落地的计算描述
数据源与粒度 — 表/事件/维度(缺则待确认)
负责人与刷新 — 谁维护、多久更新
已知歧义 — 待拍板项

本技能做指标元数据参谋,不改数仓/看板、不做实验读出、不出具审计确认。

适用场景

适合: 新指标立项、口径争议对齐、看板上线前定义固化。
不适合:
- 单次实验/灰度结果读出(请用实验读出类技能)
- 要求 Agent 自动改 SQL/数仓指标
- 财务审计或监管报送的正式认定

边界与差异(防误触发)

| 易混需求 | 本技能 | 不做什么 | | --- | --- | --- | | 实验读出 | 定义元数据 | 不写假设/结论/下一步决策 | | 预算差异说明 | 口径卡 | 不做预算 vs 实际归因 | | 看板配色/布局 | 只定义指标 | 不设计可视化 |

怎么使用(普通用户)

在 AI 助手里直接说,例如:

「用指标定义卡,定义「激活用户数」」
「KPI 口径、公式、负责人和刷新频率写清楚」
「把下面讨论收成一张指标定义卡」

使用步骤

缺关键信息时先追问,禁止编造未提供的表名、字段或精确公式系数。

1. 澄清最少必要项

| 字段 | 说明 | | --- | --- | | 指标名称 | 必填 | | 业务用途 | 一句话 | | 已知口径碎片 | 可选 | | 负责人角色 | 可选 | | 刷新期望 | 可选 |

缺指标名称: 先追问再出卡。

2. 写口径与公式

按 references/kpi-template.md:

口径用「计入/排除」条列
公式可用伪代码或文字;未知标待数据确认
多口径冲突: 列出选项请用户选定主口径

3. 页脚

固定:「本定义卡不修改数仓或看板;以数据负责人确认的正式口径为准。」

示例

输入:
名称: 日活跃用户 DAU
用途: 看产品粘性
口述: 当日有打开 App 的去重用户;内部账号排除;按设备 ID
刷新: 每日 T+1
负责人: 数据产品小周

输出:
【名称与用途】
- 名称: 日活跃用户(DAU)
- 用途: 衡量产品日粘性

【口径】
- 计入: 自然日内至少 1 次打开 App 的用户
- 排除: 内部账号(口述原词;是否仅指测试账号、是否含员工日常使用账号待确认;名单待确认)
- 去重键: 设备 ID(待确认是否与账号 ID 并存)

【公式/计算】
DAU = count distinct device_id where event=app_open and date=D and device_id not in internal_list
(表名/事件名待确认)

【数据源与粒度】
- 源: 待确认埋点表
- 时间粒度: 天(依据口述「当日」「每日 T+1」)
- 地域/业务线粒度: 待确认(输入未提供,不设默认值)

【负责人与刷新】
- 负责人: 数据产品小周
- 刷新: 每日 T+1

【已知歧义/待确认】
1. 「内部账号」的准确范围(仅测试账号,还是含员工日常使用账号)与名单维护方
2. 是否含仅推送点击未打开的用户
3. 地域/业务线粒度是否需要拆分(输入未提供)

本定义卡不修改数仓或看板;以数据负责人确认的正式口径为准。

示例说明:输入只给了时间相关信息,地域粒度未提及则进待确认,不写「全国(默认)」——标注「默认」不改变它是自创设定的事实。同理,口述「内部账号」不得在输出里窄化为「内部测试账号」,原词保留并把范围问题列入待确认。

失败与降级

| 情况 | 处理 | | --- | --- | | 只有指标名无用途 | 追问用途后可出骨架,大量待确认 | | 多口径互斥 | 并列选项,请用户选定 | | 要求自动改 SQL | 拒绝操作 |

FAQ

Q: 和实验读出有何不同?
A: 本技能固化指标定义;实验读出是某次实验结果的结论页。

Q: 一个卡能写多个指标吗?
A: 默认一卡一指标;多指标请分次或明确要求「指标词典」。

Q: 要不要写 SLO?
A: 仅当用户说明是可靠性指标;否则不扩写。

变更说明

0.1.1: 修正示例中两处未回溯输入的字段——「粒度: 天 / 全国(默认)」拆为时间粒度(有输入依据)与地域粒度(输入未提供,改进待确认,不设默认值);口述「内部账号」不再窄化为「内部测试账号」,保留原词并把范围问题列入待确认。补示例说明阐明「标注默认不改变其为自创设定」。
0.1.0: 首发。把指标口述整理成含口径、公式、数据源与负责人的指标定义卡。