适用条件与准备

适合在开发、自动化或数据任务开始前，与协作者对齐范围。需要一份允许使用的脱敏输入，以及可以判断对错的期望输出。本文不需要安装插件；CSV可用表格软件查看，Markdown可用文本编辑器填写。

按这个顺序填写

  1. 下载字段样例，先保留列名：任务、输入字段、类型、样例值、校验规则、期望输出。复制一行，替换为自己的脱敏样本。
  2. 不要只写“检查图层”。示例可以写 layer_name、text、建筑-墙体；再写出允许的命名规则和异常图层CSV。原样例中的“符合团队图层规则”仍需替换成具体规则。
  3. 打开验收模板，补充软件与系统版本、当前人工流程、样本数量、输出格式和不支持的情况。
  4. 各准备一个正常样本和一个缺失字段样本，分别写下期望结果；尚未运行时让“实际”和“结论”留空。
  5. 补上重复执行的要求：允许覆盖、生成新版本，还是遇到重复任务应停止。开发完成后按相同样本记录实际结果。

一个具体判断

原CSV里 element_id = DEMO-001、material = 演示材料，都是合成值。若真实任务要求材料不能为空，应另加一个材料为空的输入，并明确是输出待补全清单还是直接停止。只有“不能为空”而没有失败结果，开发和验收很容易各自理解。

常见误区

  1. 把工具名称当成需求：先说明要处理什么输入、得到什么输出。
  2. 把成功样例当成全部范围：缺失字段、错误版本、重复执行也要写。
  3. 把未运行的样例写成已验证结果：保留空白，运行后再填写。
  4. 直接提供生产密码或客户数据：改用最少必要的脱敏样本，并确认有权使用。

输出与边界

最终得到一份字段约定和一份待执行的验收清单。它们帮助讨论范围，不会自动生成软件、自动验证结果或替代实际环境中的测试。继续查看相关工作流可以直接取得两个文件。