统计了团队3个月的34份需求文档，返工率41%。返工原因前3名：验收标准缺失（11次）、边界条件没写（9次）、字段口径不一致（7次）。补上10个必填项后，返工率降到17%。
10个必填项：1）背景一句话；2）目标用户和规模；3）核心流程步骤编号；4）字段清单含类型和长度；5）异常分支至少3条；6）权限规则；7）验收标准可量化；8）上线时间和依赖方；9）不做什么的说明；10）变更记录。
对比两份文档。A版写“支持用户上传头像”，B版写“支持上传jpg/png，单张不超过2MB，裁切比例1:1，失败提示文案2种，存储路径按用户ID分目录”。开发按B版做，联调1轮通过；按A版做，联调3轮，多花2天。
边界条件最容易被漏。比如“搜索框输入为空时返回全部还是提示”“分页每页20条，超过1000条怎么处理”“并发2人同时修改同一条记录以谁为准”。每条写一行，写10条只要20分钟，省下的是联调时的争吵。
验收标准要能被测试执行。错误写法“页面加载要快”；正确写法“首屏加载在4G网络下不超过2秒，样本10次取中位数”。错误写法“提示要友好”；正确写法“手机号格式错误时提示‘请输入11位手机号’，停留3秒”。
案例：某次活动页需求，文档写了8页，开发做完发现“优惠券能否叠加”没写，上线前1天临时改逻辑，3人加班到晚上11点。补上这一条只需一句话，代价是9个工时。
写作顺序：先写验收标准，再倒推流程和字段。验收写不出来，说明需求没想清。团队现在要求文档评审前先交验收清单，评审时间从60分钟降到35分钟。
文档不是越厚越好。10个必填项填完通常4到6页，超过8页要检查是否混入了方案细节。需求文档回答“做什么、做到什么程度”，方案文档回答“怎么做”，混在一起，读的人找不到重点。
