把功能要求写成验收项,核心做法是:不要写“支持会员登录”,而要写“会员能用邮箱和密码登录;密码错误时提示错误;登录成功后进入个人中心;未登录访问个人中心会跳转到登录页”。验收项必须包含可观察的动作、可判断的结果和明确的通过条件。对网站建设新手来说,最稳妥的方式是先写“操作步骤”,再补“预期结果”,最后加“不通过的情形”。
功能要求回答“要做什么”,验收项回答“做到什么程度算完成”。例如“要有搜索功能”是功能要求,验收项则要写成:在搜索框输入一个已存在的标题关键词,点击搜索后,结果列表中出现对应内容;输入不存在的关键词,页面显示“没有找到相关内容”。
判断一个条目能不能当验收项,可以问三个问题:谁来操作、操作后看到什么、看到什么才算通过。三个问题有一个答不上来,它就还停留在功能要求阶段。
按页面写,适合功能边界清楚、页面数量不多的网站。每个页面列一组检查项,例如首页、列表页、详情页、表单页分别写清楚显示什么、点击什么、提交后发生什么。优点是容易对照页面逐项检查,缺点是跨页面流程容易被漏掉。
按流程写,适合注册、下单、预约、投稿这类需要多个页面配合的功能。写法是从起点到终点走一遍,每一步都写清操作和结果。优点是能发现页面之间的衔接问题,缺点是单个页面的细节可能被忽略。
两种写法可以混用:主体功能按流程写,零散展示和静态内容按页面写。判断标准很简单,如果这个功能需要用户连续做三个以上动作才能完成,就优先按流程写。
以“图片上传”为例,改写后可以写成:在发布页面选择一张小于 2MB 的 JPG 图片,点击上传后,页面出现缩略图,提交后后台能查看原图;选择超过 2MB 的图片时,页面提示文件过大且不执行上传。这里的大小限制只是示例,实际数值应按项目约定填写,不能凭空假设。
复查时不要只看文字,要按验收项逐条走一遍。重点检查四类问题:
复查后仍然模糊的条目,不要留在验收清单里当装饰。把它拆成两条更小的验收项,通常比继续补充形容词更有效。
第一个坑是把技术实现当成验收标准,例如“用 AJAX 提交表单”。用户看不到 AJAX,验收应该看提交后页面是否刷新、是否提示成功、数据是否进入后台。第二个坑是把“做好看点”写进验收项,这类要求应转成具体检查,例如标题字号、图片宽度、按钮位置,而不是留在功能验收里。
第三个坑是只写正常流程。真正容易出问题的是边界情况:输入为空、输入超长、重复点击、没有权限、数据不存在。每写一条正常流程,至少补一条对应的异常检查,验收项才算完整。
下一步,挑出你手上最模糊的一条功能要求,按“操作—预期结果—不通过情形”改写成一条验收项,再拿给不参与开发的人读一遍。如果对方能照着操作并判断通过与否,这条验收项就可以进入清单了。