技术 · 熟练
同一个「活跃用户」，三个部门三个数
不是数据不准，是同名的两个东西
指标口径不是数据问题，是定义问题：财务的「收入」是含税确认，运营的「收入」是到账金额，销售的「收入」是签约额 —— 三个都对，但只要没人把定义钉在一次，agent 查出来的数就永远是「某一个部门的数」。这一页给一条四步做法：先把指标写成「定义卡」（算什么 · 不含什么 · 用什么字段 · 谁负责）· 再让 agent 查数前必须先取卡 · 对不上时按卡去追而不是去争 · 最后把每次口径变更记在卡的版本上。关键动作只有一个：让「口径」变成一份能被读出来的文件，而不是一个人脑子里的默认值。
方法 · 一图看懂
1
把指标写成一张卡 — 一个指标一张卡：算什么、不含什么、用什么字段算、谁签字负责，四栏缺一不可
2
查数前先取卡 — agent 拿问题先问「你说的是哪张卡」，取不到卡就不许直接生成 SQL
3
对不上先追卡，不追人 — 两个数不一致时按卡逐栏比：口径不同 / 时点不同 / 过滤条件不同
4
改口径＝改版本 — 任何口径变更都新建一版并写生效日与影响面，旧版保留不删
原理 · 为什么有效
指标口径之争之所以永远争不完，是因为它长得像数据问题，实质是定义问题：同一个词在不同部门手里指的是不同的事，而「谁的数对」这个问题在没有定义的前提下无解。把定义写成卡，等于把隐式默契变成显式约定 —— 争论的落点从「你不懂业务」变成「第三栏的字段不一样」。而 agent 恰恰只认显式约定：你给它一张卡，它就有据可依；你不给，它就会用一个看起来最合理的默认值把数算出来 —— 而且算得很自信。
适用场景
适合：
1. 公司里同一个指标被两个以上团队各算一遍
2. 已经把「问数」交给 agent，但回答经常和报表对不上
3. 要做跨部门合并报表或对外披露
不适合：
1. 只有你一个人在用数据、口径从未分叉
2. 数据本身还没接入（先把源接上，再谈口径）
3. 想用它解决「数据质量差」—— 口径卡管定义，不管脏数据。
自测 · 5 问
我能说出最常被问的三个指标各自的四栏（算什么 / 不含什么 / 用什么字段 / 谁负责），而不是只说名字
每个指标卡都有唯一编号与版本，卡片存在能被 agent 读到的位置（文件或元数据服务），不是在某个人的聊天记录里
我知道上次口径变更发生在什么时候、影响了哪些历史报表
被问「为什么这个数和报表不一样」时，我的第一反应是打开两张卡比第三栏，而不是打电话问人
我有一个「取不到卡就不出数」的约定，并且 agent 侧真的会因此停下
怎么上手 · 验证步骤
1. 先挑被问得最多的三个指标（不是最复杂的三个），各写一张卡；四栏写不满就说明这个指标还没定义清楚，写「待定」比编一个更安全。
2. 把卡放在 agent 能读到的地方（一份文件 / 一个元数据接口都行），并在提示词里写死一句：回答数字前必须先给出所用卡的编号与版本。
3. 找一次已知的分歧（两个部门各报一个数），用两张卡逐栏比，把差异落到具体一栏 —— 这一栏就是你要修的地方。
4. 改口径时新建版本、写生效日、标影响面；旧版留着，因为历史报表要能解释。
拿一个你上周报过的数，问 agent 三句：① 你用的是哪张卡的哪一版 ② 这张卡「不含什么」 ③ 如果换一版口径，这个数会往哪个方向变。三句里有一句答不上来，就说明这个指标还没被真正定义过。