2、标注需求文档的受众分析：算法工程师、标注团队、项目经理、质检员的不同视角

写标注需求文档，最怕什么？

我最怕的是：文档写完了，算法说看不懂，标注团队说没法干，项目经理说超预算，质检员说标准不统一。

你想想看，一份文档要同时伺候四拨人，这本身就是个技术活。我做了这么多年数据标注项目，踩过的坑比走过的路还多。今天就聊聊，这四类人到底想看什么。

2.1 算法工程师：我要的是「能跑起来」

算法工程师的视角，说白了就一句话：标注结果能不能直接喂进模型。

我有个习惯，写文档前先问算法同事三个问题：

• 你这个任务是什么？分类、检测还是分割？
• 标注格式是什么？COCO、VOC还是自定义？
• 有没有特殊要求？比如要不要忽略遮挡物？

举个例子，我之前做自动驾驶项目。算法工程师说「标注车辆就行」。结果标注团队把远处芝麻大的车也标了，模型训练时全是小目标，精度惨不忍睹。

后来我学乖了，在文档里明确写：「仅标注面积大于50×50像素的车辆」。你看，就这么一句话，省了多少返工。

2.2 标注团队：我要的是「能干活」

标注团队的视角，其实更接地气。他们不关心模型精度，只关心：这个框怎么画？这个标签怎么选？

我记得有一次，文档里写「标注所有交通标志」。标注员懵了：红绿灯算不算？地面箭头算不算？电子屏算不算？

你看，这就是典型的「我以为你知道」。标注团队需要的是可执行的操作指南，不是算法理论。

我建议文档里至少包含：

• 标注工具操作说明：用什么工具、快捷键是什么
• 标注规则示例：好样本长什么样，坏样本长什么样
• 边界情况处理：遮挡了怎么办？模糊了怎么办？
• 标注优先级：先标什么，后标什么

2.3 项目经理：我要的是「能交付」

项目经理的视角，永远是成本、进度、质量三个词。

我遇到过最头疼的事：项目做了一半，发现标注量比预估多了3倍。为什么？因为文档里没写清楚「每张图平均标注目标数」。

项目经理需要从文档里读出：

• 工作量估算：每张图平均标注时间、总标注量
• 质量验收标准：准确率要求多少？怎么抽检？
• 交付物清单：最终给什么文件？格式是什么？
• 风险点：哪些环节容易出问题？有没有备选方案？

我现在的习惯是，在文档里加一个「工作量估算表」：

标注类型	每张图平均目标数	单目标标注时间	每张图总耗时
车辆检测	8-12个	3秒	30秒
行人检测	3-5个	2秒	10秒
交通标志	2-4个	4秒	12秒

有了这个表，项目经理一眼就能算出总工时和预算。嗯，这招真的很好用。

2.4 质检员：我要的是「能检查」

质检员的视角，可能是最容易被忽略的。但说实话，质检环节决定了标注质量的底线。

我曾经犯过一个错：文档里只写了「标注准确率不低于95%」。结果质检员和标注员对「准确」的理解完全不一样。标注员觉得框偏了2像素没问题，质检员觉得必须严丝合缝。

质检员需要的是：

• 明确的检查标准：什么算对，什么算错
• 抽检比例和方式：抽多少？怎么抽？
• 错误分类和扣分规则：漏标扣多少？错标扣多少？
• 返工流程：不合格的怎么处理？

2.5 如何在一份文档里满足所有人？

你可能会问：这么多视角，一份文档怎么写？

我的做法是分层设计：

1. 第一层：概述（给项目经理和算法看）
   • 项目背景、目标、数据规模
   • 标注类别和格式
   • 交付物和时间节点
2. 第二层：标注规则（给标注团队看）
   • 详细的操作步骤和示例
   • 边界情况处理
   • 常见错误和避坑指南
3. 第三层：质检标准（给质检员看）
   • 评分规则和抽检方案
   • 返工流程
   • 质量报告模板

这样设计的好处是：每个人只看自己关心的部分，不用从头读到尾。而且，如果后续有变更，只需要修改对应层级，不会影响其他部分。