Product Acceptance(产品功能验收)
目标
为普通产品功能(Web / App / 桌面 / 小程序 / API)生成可直接执行的验收交付物:范围与目标、DoD、Given/When/Then 用例表、回归清单、账号与数据准备、结果记录模板、待确认/风险清单。
两条铁律:
- 不编造:业务规则、验收标准、文案、阈值,凡对照物(PRD/原型/工单/口头约定)中未写明的,一律进「待确认」,不得臆造进用例的 Then。
- 不做模型评估:本技能只覆盖确定性功能验收。若涉及模型效果、Agent 行为、red-team,明确告知超出本技能范围。
工作流程
第 1 步:开始前确认
未知则询问用户,一次最多 4 项:
- 范围:本版本 In scope / Out of scope
- 对照物:PRD、原型、工单、口头约定——以哪份为准(有冲突时按用户指定优先级)
- 形态:Web / App / 桌面 / 小程序 / API-only(决定检查维度取舍)
- 角色与环境:有哪些角色;测本地还是测试/预发环境
若用户信息不足:先输出「待确认」清单,再写已能确定的用例,继续推进而不是卡死。
第 2 步:选择检查维度
按相关性选用以下维度,不适用的写 N/A 并简述原因(一句话即可):
- 主路径(happy path)
- 空态 / 首用 / 无数据
- 边界:超长、极值、可选未填、分页末页
- 异常:失败提示、重试、超时、重复提交
- 权限:未登录、无权限、越权、仅读
- 状态流转:创建→更新→完成/关闭;不可逆操作二次确认
- 数据:列表筛选排序、刷新后一致、删除后不可见
- 多端/响应式(若相关):关键断点下可完成主路径
- 文案与基础可用性:关键按钮可发现、错误可理解
- 非功能(仅当需求写明才测):性能阈值、埋点、多语言、无障碍
第 3 步:按固定模板输出
输出顺序(严格遵守)
范围与目标 → DoD → 用例表 → 回归清单 → 账号数据 → 结果模板 → 待确认
# XX 功能验收清单
## 1. 验收目标与范围
- 验收目标:(一句话)
- In scope:……
- Out of scope:……
- 对照物:以《XX》为准
## 2. DoD(通过标准)
- 全部 P0 用例通过
- P1 无未说明的失败
- 无阻塞缺陷;纯文案/样式默认不挡上线(除非对照物明确要求)
## 3. 用例表
| ID | 场景 | Given | When | Then | 优先级 | 维度 | 期望结果可观察点 |
|----|------|-------|------|------|--------|------|------------------|
| TC-001 | | | | | P0 | 主路径 | |
规则:
- ID 连续编号(TC-001 起)
- Given/When/Then 写可执行的前置、动作、断言;Then 必须有可观察点(页面变化/接口返回/数据状态),不写"正常""合理"这类模糊词
- 优先级:P0 主路径与资损/权限/数据安全;P1 常用分支与异常;P2 低频边界
- 每个维度至少覆盖一条;N/A 的维度在表后单独列出
## 4. 回归清单(5–15 条)
相邻功能的短句检查项,如:"删除 A 后,引用 A 的列表页不再显示该条目"
## 5. 账号与数据准备
- 角色:各角色测试账号及权限
- 种子数据:需要预置的数据
- 清理注意:测试后需恢复/清理的状态
## 6. 结果记录模板
| ID | 结果(通过/失败/阻塞) | 实际结果 | 复现步骤 | 证据(截图/日志位置) |
|----|------------------------|----------|----------|------------------------|
## 7. 待确认 / 风险
- 待确认:对照物未写明、无法编造的事项(附建议默认值,供用户拍板)
- 风险:可能影响验收结论的环境/依赖/数据问题
反例(禁止)
- ❌ 编造 Then:PRD 未写超长输入的限制,却写 Then "提示'最多 50 字'"——应写进待确认
- ❌ 写模型 eval 用例:如 "生成内容相关性 ≥ 4 分"
- ❌ Then 用模糊词:"系统正常处理""体验良好"
- ❌ 信息不足时停下不产出:应先给待确认清单 + 已确定用例
- ❌ 非功能指标无出处:需求未写响应时间,却定 P0 "接口 < 500ms"
交付形式
- 默认直接在对话中输出 Markdown
- 用户要求文件时,保存为
.md;要求 Word 版则转.docx - 用例表保持 Markdown 表格,方便贴进 TAPD/Jira/飞书表格