需求文档里，每个字段都要能找到妈

写需求文档最容易被一句带过的，是数据来源。我以前写过「对接现有系统」四个字，评审会上被开发当场问住：哪个系统？接口文档呢？负责人是谁？我一条都答不上来，那次返工花了三周。

后来我在文档里固定加了一张数据来源与责任人表，六列，照抄就能用。

第一列，字段名加业务含义。甲方嘴里的词和系统里的词经常不是一回事，先对上。

第二列，来源系统。写全到哪个模块，不能只写系统名。

第三列，接口负责人，写具体人名。我当年一张源系统一张确认单，补了8张，又拉着5个负责人逐个签字。签字这个动作很关键——签了字，接口出问题就有人认领，不用开会互相指。

第四列，更新频率。每天更新还是月底更新，直接决定下游怎么对账，必须问清楚。

第五列和第六列，缺数怎么办、影响有多大。源系统坏了能不能手动录入、多久补录、缺数期间审批还走不走——这些必须在设计期定死，不能等故障当天再吵。

这张表加上之后最明显的变化：开发拿到文档不用再追着我问数据的事，测试也知道数据异常该找谁，会上「数据从哪来」这个话题基本消失了。

我的体会是：需求文档不是写给开发看的作文，是契约。每个字段都能找到妈，协作才不会扯皮。