怎么写字段说明？

02-02 怎么写字段说明？

课程定位

这一课讲“字段说明就是数据世界的词典”。

一张表能不能被别人看懂，很大程度取决于字段说明。字段说明要写清字段名、字段含义、示例值、格式要求、是否必填和备注。AI 可以帮忙起草字段说明，但字段含义和业务规则必须由人确认。

这一课的成果是一份「字段说明表」。

本课目标

能理解字段说明的价值。
能为一张表写字段名、含义、示例值和格式要求。
能区分 AI 推测和人工确认。
能把字段说明作为团队共享的数据词典。
能完成字段说明表。

录制建议

建议时长：25 到 35 分钟。
延续上一课的表格理解卡。
重点展示字段说明表的字段设计。
强调字段说明要让后来的人看懂。
收尾让学员完成一份最小字段说明表。

课前准备

表格理解卡。
一张样例表。
字段说明表。

讲稿正文

可以这样开场：

“字段说明，就是数据世界的词典。没有字段说明，一张表只能靠猜；有了字段说明，后面的人才能知道这列到底代表什么。”

很多表格最开始只有表头，表头又经常写得很短，比如“状态”“来源”“金额”“类型”。当时做表的人心里明白，过两周换个人看，就开始猜。字段说明的价值，就是把这种“只有我懂”的隐性知识写出来。

这一课要告诉学员，字段说明不是给专家看的，是给后来的人、给 AI、给未来的自己看的。写得越清楚，后面做统计、清洗、报告时越轻松。

字段说明表通常包含六项。

第一，字段名。

保持和原表一致，不要随手改名。

第二，字段含义。

用人话解释这一列代表什么。比如“报名状态”可以写成“学员是否完成报名流程的状态”，不要只写“状态”。

第三，示例值。

给 1 到 3 个真实格式的脱敏示例。示例要脱敏，但格式要真实。比如手机号可以写成“138****1234”，客户名可以写成“客户 A”。

第四，格式要求。

比如日期格式、手机号格式、金额单位、分类取值范围。格式要求越清楚，后面越容易让 AI 发现异常。

第五，是否必填。

哪些字段缺失会影响后续统计，要标清楚。比如订单编号、支付状态、成交金额通常很关键；备注字段缺失，可能影响不大。

第六，备注。

写清容易误解的地方，比如“成交金额为税前金额”“状态只统计已支付订单”。

演示时要特别强调“AI 推测”和“人工确认”。AI 可以根据表头和样例猜字段含义，但猜出来的东西要标注为待确认。比如 AI 看到“source”，可能猜成客户来源，也可能猜成数据来源。这里必须让业务人员确认。

可以让 AI 输出一列“确认问题”。比如“成交金额是否包含退款”“报名时间是否为首次提交时间”“渠道来源是否允许多选”。这一列非常重要，它会把字段背后的业务规则问出来。

最后让学员把字段说明表保存到数据资料库里。以后每次整理这类表，不用重新解释一遍。字段说明会慢慢变成团队自己的数据词典。

示范表达：

请根据下面的表头和样例数据，帮我起草字段说明表。

表格来源：
表格用途：
表头：
样例数据：
已确认字段含义：

请输出字段说明表，字段包括：
1. 字段名
2. 字段含义
3. 示例值
4. 格式要求
5. 是否必填
6. 备注
7. 是否需要人工确认

最后收束：

“字段说明写得越清楚，数据协作越轻松。它是让事实能被共享的词典。”

屏幕演示流程

打开上一课的表格理解卡。
建立字段说明表。
让 AI 根据表头和样例数据起草字段说明。
标出需要人工确认的字段。
让 AI 生成每个字段的确认问题。
人工修正字段含义和格式要求。
保存字段说明表。

给 AI 的协作卡

请帮我起草字段说明表。

表格来源：
表格用途：
表头：
样例数据：

请输出：
- 字段名
- 字段含义
- 示例值
- 格式要求
- 是否必填
- 备注
- 需要人工确认的问题

请不要把不确定内容写成确定结论。

字段说明表

字段名：
字段含义：
示例值：
格式要求：
是否必填：
备注：
是否人工确认：
确认人：

课堂练习

让学员为一张真实表格写字段说明。

要求：

至少选择 8 个字段。
每个字段写含义和示例值。
每个字段写格式要求。
标出需要人工确认的字段。
人工确认至少 3 个关键字段。

常见卡点

字段名太简写：备注里写清完整含义。
示例值暴露隐私：使用脱敏示例。
AI 编字段含义：加“需要人工确认”标记。
格式要求缺失：补日期、金额、分类、手机号等规则。

课后作业

完成一份字段说明表。

提交内容：

至少 8 个字段。
每个字段的含义、示例值和格式要求。
待确认字段。
人工确认记录。

课件页建议

第 1 页：字段说明是数据词典
第 2 页：字段说明六项
第 3 页：示例值和格式要求
第 4 页：AI 起草，人来确认
第 5 页：字段说明表