AI Agent / 系统课时
编写可验证的验收标准
编写可验证的验收标准
需求描述如果只有“体验流畅”“支持管理”“方便使用”等模糊表达,开发完成后很难判断是否达标。本节将学习如何把想法转换为可观察、可执行、可检查的验收条件。
学习目标
- 理解验收标准与普通需求描述的区别
- 学会编写可观察的功能完成条件
- 能够通过测试步骤验证 AI 生成结果是否符合预期
从模糊需求到可验证条件
验收标准的核心是回答三个问题:完成什么操作、产生什么结果、如何确认结果正确。
例如“用户可以登录”不是完整验收标准,因为它没有说明输入、流程和结果。“输入正确账号密码后,用户进入首页并显示用户名”才具备验证条件。
好的验收标准应该避免主观词汇,尽量使用可以观察的行为、页面状态、数据变化或系统响应描述。
使用场景化方式编写标准
常见写法可以采用“条件-操作-结果”结构:
- 条件:说明开始测试时系统处于什么状态
- 操作:说明用户或系统执行什么动作
- 结果:说明应该看到什么变化
例如一个任务管理功能可以定义为:创建任务后,列表中出现该任务,并且刷新页面后数据仍然存在。下面是一个简单的验收清单示例:
yaml
feature: create-task
acceptanceCriteria:
- given: 用户已登录
when: 输入任务标题并提交
then: 列表新增对应任务
- given: 任务已经存在
when: 刷新页面
then: 任务仍然显示预期结果
text
验收条件包含前置状态、执行动作和可观察结果,可用于测试检查。让验收标准服务于 AI 开发
在 Vibe Coding 中,验收标准不仅用于最终测试,也用于指导 AI 生成代码。越明确的判断条件,AI 越容易理解目标范围,减少生成与修改之间的偏差。
例如,不要只告诉 AI “优化登录页面”,而应说明“登录失败时显示错误提示,成功后跳转首页,按钮在请求期间不可重复点击”。这些条件能够直接转化为实现任务。
常见错误与改进方式
一个常见问题是把实现方案写进验收标准。例如“必须使用某个组件库完成按钮”通常属于技术方案,而不是用户验收条件。
另一个问题是标准数量过多。第一版应该优先覆盖核心流程,避免用大量边缘条件阻碍快速验证。
按自己的节奏,确认真正理解。