用途:在编写管道代码前先编写数据规格,定义业务意图、源与目标预期、质量规则和成功标准,避免让智能体凭空猜测。
适用场景:新建摄取或转换项目;模式或契约变更;数据产品、数据集市或语义模型的重大变更;听起来简单但操作细节不清的请求。不适用于琐碎的拼写修正或非行为性文档编辑。
工作方式:先陈述假设,内容包括业务目标、源系统、目标系统、数据粒度、更新频率、保留预期、安全或隐私约束。规格按必需章节撰写:目标、业务成果、源系统与契约、目标表/文件/流、新鲜度与SLA预期、数据质量规则、安全与访问边界、回填与重放预期、成功标准、待解决问题。
规划前先消除歧义:若规格无法回答频率、粒度、键、缓慢变化行为或空值处理,应暂停并询问。规格应保存在版本控制中,否则数据变更会变成口口相传的知识。
常见辩解及现实:只想快速建表,但错误的粒度或契约会导致昂贵的下游返工;打算以后再推断业务指标,通常会产生同一指标的多个冲突定义;认为目标模式足够,但调度、新鲜度、回填和访问规则与列同样重要。
危险信号:未指定业务负责人;事实来源系统不明确;把成功定义为管道能跑;遗漏回填行为;质量规则只是暗示而未写明。
验证清单:规格说明业务成果与预期用户;源、目标、粒度、频率和归属明确;质量、安全和重放预期已定义;待解决问题列出而非猜测;规格已保存在代码库中。
限制:费用、价格、支持平台等资料暂未提供。