AI Agent / 系统课时

编写可验证的验收标准

编写可验证的验收标准

需求描述如果只有“体验流畅”“支持管理”“方便使用”等模糊表达,开发完成后很难判断是否达标。本节将学习如何把想法转换为可观察、可执行、可检查的验收条件。

学习目标

  • 理解验收标准与普通需求描述的区别
  • 学会编写可观察的功能完成条件
  • 能够通过测试步骤验证 AI 生成结果是否符合预期

从模糊需求到可验证条件

验收标准的核心是回答三个问题:完成什么操作、产生什么结果、如何确认结果正确。

例如“用户可以登录”不是完整验收标准,因为它没有说明输入、流程和结果。“输入正确账号密码后,用户进入首页并显示用户名”才具备验证条件。

好的验收标准应该避免主观词汇,尽量使用可以观察的行为、页面状态、数据变化或系统响应描述。

使用场景化方式编写标准

常见写法可以采用“条件-操作-结果”结构:

  • 条件:说明开始测试时系统处于什么状态
  • 操作:说明用户或系统执行什么动作
  • 结果:说明应该看到什么变化

例如一个任务管理功能可以定义为:创建任务后,列表中出现该任务,并且刷新页面后数据仍然存在。下面是一个简单的验收清单示例:

yaml
feature: create-task
acceptanceCriteria:
  - given: 用户已登录
    when: 输入任务标题并提交
    then: 列表新增对应任务
  - given: 任务已经存在
    when: 刷新页面
    then: 任务仍然显示

预期结果

text
验收条件包含前置状态、执行动作和可观察结果,可用于测试检查。

让验收标准服务于 AI 开发

在 Vibe Coding 中,验收标准不仅用于最终测试,也用于指导 AI 生成代码。越明确的判断条件,AI 越容易理解目标范围,减少生成与修改之间的偏差。

例如,不要只告诉 AI “优化登录页面”,而应说明“登录失败时显示错误提示,成功后跳转首页,按钮在请求期间不可重复点击”。这些条件能够直接转化为实现任务。

常见错误与改进方式

一个常见问题是把实现方案写进验收标准。例如“必须使用某个组件库完成按钮”通常属于技术方案,而不是用户验收条件。

另一个问题是标准数量过多。第一版应该优先覆盖核心流程,避免用大量边缘条件阻碍快速验证。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

编写可验证的验收标准

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通