核心想法
如何记录公式、来源、时间窗口、粒度、排除项和负责人，让团队、看板与智能体一致、无歧义地理解每个 KPI。
从 KPI 要支持的决策出发
指标的存在，是为了回答问题并改变行动。写公式之前，应记录谁使用、使用频率，以及哪项决策依赖它。转化可能指表单、有效线索、预约或销售；缺少目的时，每个团队都会选择有利于自身解读的版本。指标契约让指标与决策之间的关系明确可见。
数据契约将指标名称转化为可执行的定义。它说明用途、公式、来源、粒度、时间窗口、排除项、质量要求、负责人和依赖该指标的行动。当仪表盘、报告和智能体使用同一份契约时，差异便可调查，更新也不会悄然改变业务事实。
记录完整定义
指标契约包括标准名称、描述、公式、分子、分母、单位、来源、事件、粒度、时区、时间窗口、归因、筛选、排除项和负责人，还应包含纳入与排除的示例。定义必须让业务团队看得懂，也要精确到足以实施。如果使用派生字段，应链接其契约，以便重建整个计算链路。
明确质量、延迟和故障时的行为
同一个指标可能实时更新，也可能数日后才结算。契约应规定更新频率、预期延迟、完整性阈值、允许的重复程度，以及来源缺失时的处理方式。仪表盘应展示数据不完整，而不是用零填补空白。告警应交给能够调查问题并说明影响的负责人。
对变更进行版本管理，保护可比性
更改时间窗口、事件或筛选条件，可能改变历史序列。每次变更都应记录日期、原因、审批人、影响和处理策略：重新计算、保留两个版本，或开始新的序列。报告和智能体必须知道生效日期，避免混用定义。链接到数据契约后，人们便能理解两个平台为何显示不同数值，无需人为强行对齐。
将契约连接到报告与人工智能
Wiwo.MetriQ 可用共享定义解读来源并准备交付物，由人工审核验证原因与建议。智能体在解释收入或 CAC 的变化前，需要知道定义、周期和边界。指标契约无法消除平台差异，但能为差异提供背景、负责人和处理程序。当每个数字都能从决策追溯到来源，信任便会形成。
