需求说明书不是把想要的功能列一遍,而是把“做成什么样算合格”写成可核对的条款。对全包服务来说,它同时约束设计、开发、内容、上线和售后,所以每一条都应包含对象、动作、标准和验收方式。写完后让不参与项目的人读一遍,如果他能判断某项是否完成,这份说明书才算可用。
全包容易产生分歧的地方,往往不是“做不做”,而是“做到什么程度”。建议按下面几类逐项确认,每项都写成一句可判断的话:
判断方法很简单:任意一条如果出现“等”“相关”“适当”这类词,就说明它还不可验收,需要继续拆。
把说明书当成一份排查清单来写,比按功能罗列更清楚。
观察:先描述现状和问题。例如“现有页面在手机端横向溢出,产品图需要左右拖动才能看全”。现状写得越具体,后面越不容易跑偏。
判断:写出期望达到的状态和判断依据。例如“在宽度 360px 的视口下,页面不出现横向滚动条,正文无需缩放即可阅读”。这里给的是可测量的条件,不是“体验要好”。
处理:说明由谁做什么、交付什么。例如“由服务方调整响应式样式,交付可访问的测试地址和改动说明”。
复查:写明怎么确认完成。例如“用浏览器开发者工具切换到 360px、768px、1280px 三档宽度逐一检查,三项均通过即视为完成”。
如果项目是在原有页面上改进,建议对每个改动点都走一遍这四步,避免只写“优化首页”却没人知道优化到什么程度。
下面是一段假设示例,用来说明写法,不代表任何真实项目:
需求:产品列表页支持按分类筛选。验收:选择任一分类后,列表只显示该分类产品;切换分类时页码回到第一页;无结果时显示“暂无相关产品”而不是空白。测试数据由甲方提供至少 3 个分类、每类不少于 2 个产品。
这段文字包含了对象、动作、预期结果和测试条件。对比一下“产品列表页要好看、好用”,后者无法判断是否完成,也无法在验收时作为依据。
适用条件是:需求越靠近交互和数据处理,越要写清输入、输出和边界情况;纯视觉类需求则可以用截图或参考稿辅助说明,但仍要写明适配的屏幕范围和修改轮次。
复查时可以让服务方按条款逐条回复“可做、不可做、需另议”,把回复直接附在说明书后面,作为后续对照的依据。
把上面整理出的页面清单、功能条目、验收标准和变更约定合并成一份文档,标注版本和日期,作为合同附件双方确认。之后每次沟通改动,都回到这份附件上标注新增或修改,而不是只在聊天记录里口头确认。这样做的直接好处是:验收时有据可查,增项时有边界可依。