数据口径说明须明确字段定义、校验动作与责任主体:如“用户活跃天数”由BI组王磊每周三用Doris表跑SQL校验波动;“订单GMV(含运费)”在支付成功但物流单号为空时曾漏计2.3%,7月1日补录;“退款率(按支付成功时间归因)”由数据中台刘芳在Airflow任务data_standardize_dau_v3维护,最近修改6月28日14:17。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

写数据口径说明时,印象AI容易输出“确保统计口径统一”“强化数据一致性”这类空转表述,读者看不出字段到底怎么算、边界在哪、谁来维护。
用真实校验动作替代抽象要求
第一步:在提示词开头直接写明本次说明要覆盖的3个具体字段,例如“用户活跃天数”“订单GMV(含运费)”“退款率(按支付成功时间归因)”。【不写“核心指标”“关键维度”这种虚词,只列真实字段名】
第二步:对每个字段,强制要求写出“谁在什么系统里、用哪条SQL或配置项、在哪个环节校验过”。比如“用户活跃天数:BI组王磊每周三上午用Doris表user_login_log跑check_active_days_v2.sql,比对前一日结果波动是否超5%”。
第三步:删掉所有“应”“须”“务必”字眼。把“应由数据中台统一管理”改成“当前由数据中台刘芳在Airflow任务data_standardize_dau_v3里维护,最近一次修改是6月28日14:17,commit ID 9a3f2c1”。
禁用套话词+塞入调试痕迹
方法一:在提示词末尾加一句硬性指令——“禁止出现‘口径一致’‘逻辑闭环’‘颗粒度’‘赋能’‘沉淀’这五个词,出现即重写”。
方法二:插入一条真实报错记录作为锚点。例如:“当订单GMV字段遇到‘支付成功但物流单号为空’的订单时,原口径漏计了2.3%,我们在7月1日10:22上线了补录逻辑,SQL片段见附件log_20260701_fix_gmv.txt第47–51行”。
这一步操作起来很简单,直接把文件拖进去就行。
用主语+动词钉住每句话
① 每段第一句必须出现具体人名/角色/系统名,禁用“本口径”“该字段”“平台侧”等虚主语。错误示范:“本口径支持多端归因”;正确写法:“安卓端埋点工程师张薇在v4.2.1版本里把$event_time字段从客户端本地时间改为服务端返回时间”。
② 所有动词必须可验证。“优化计算逻辑”→“把原来用COUNT(DISTINCT user_id)改成SUM(case when is_first_order=1 then 1 else 0 end),避免新老用户混算”。
③ 删除“进行”“开展”“实施”类万能动词。不写“开展了口径对齐工作”,写“6月22日15:00在数据治理群@全部成员发了对比表,销售侧确认接受订单状态为‘已发货’才计入GMV”。

















