指标定义卡

指标口径为什么总对不齐

同一个「激活用户数」或「有效订单」，产品、分析和数仓往往各有一套说法：计入规则不同、表名各说各的、负责人和刷新节奏没人写进文档。看板上线前或口径争议时，缺的不是再画一张图，而是一张可对齐、可引用的指标元数据。

技能如何产出定义卡

本技能扮演指标元数据参谋，把口述或碎片讨论收成固定结构的定义卡，模板见 references/kpi-template.md，通常包含：

• 名称与用途 — 指标名与要回答的业务问题
• 口径 — 用「计入 / 排除」条列，多口径冲突时并列选项供你选定主口径
• 公式或计算说明 — 伪代码或文字；未知系数标「待数据确认」
• 数据源与粒度 — 表、事件、维度；缺则进待确认，禁止编造表名与字段
• 负责人与刷新 — 维护人与更新频率
• 已知歧义 — 待拍板项

流程上先澄清最少必要项（缺指标名称会先追问），再写口径与公式；页脚固定说明：本卡不修改数仓或看板，以数据负责人确认的正式口径为准。

适用边界

适合新指标立项、口径对齐、看板上线前定义固化。不适合单次实验/灰度结果读出（那是实验读出类技能）、要求 Agent 自动改 SQL/数仓，以及财务审计或监管报送的正式认定。与实验读出的差异在于：本技能只固化定义，不写假设、结论与下一步决策。