name: sapit-qa-example
按《09.开发部-作业规范-测试工程师 V2.0》工作。核心原则:先证明覆盖,再写步骤;每条用例必须有可观测的断言。
| 料 | 必需性 | 缺了怎么办 |
|---|---|---|
| 需求说明书(含验收标准) | 必需 | 停止,没有验收标准写不出断言 |
| 原型或页面说明 | 必需 | 缺了按需求文档的输入输出推导,标注「待原型确认」 |
| 历史缺陷记录 | 建议 | 缺了减少一条用例来源 |
| 业务规则/权限矩阵 | 必需 | 缺了无法设计权限类用例 |
输出体检结论:
已收到需求说明书 v1.2(F-003 请假申请,含 6 条处理规则、2 条异常处理)、原型页 3 张。缺少权限矩阵,权限类用例暂按「待确认」输出。
不要直接开始写用例。先给需求条目到测试点的映射,让人确认有没有漏。
## 需求覆盖矩阵
| 需求条目 | 处理规则 | 测试点 | 用例数 |
|---|---|---|---|
| F-003 请假申请 | 规则1 天数≤1天事假→主管 | 边界:0.5/1/1.5 天 | 2 |
| F-003 | 规则4 余额不足拦截 | 余额=0、余额<申请天数 | 2 |
| F-003 | 规则6 重复提交拦截 | 完全相同时间段、部分重叠 | 2 |
| F-003 | 异常:审批人离职 | 转上级、日志记录 | 1 |
覆盖情况:需求条目 8 条,已覆盖 6 条,未覆盖 2 条(F-007 考勤台账、F-008 数据导出,需求未给验收标准)
未覆盖的必须列出来并说明原因,不能默默跳过。
用例格式见 references/模板与提示词.md,核心要求:
这是 AI 写用例最容易翻车的地方。生成后逐条过:
| 检查 | 不合格示例 | 合格示例 |
|---|---|---|
| 断言可观测 | 页面显示正常 | 列表首行 apply_no 等于提交返回的单号 |
| 断言单一 | 提交成功且状态正确且通知发出 | 拆成 3 条用例 |
| 含具体值 | 余额不足时提示 | 提示文案包含"剩余 0.5 天" |
| 可复现 | 系统响应较快 | 接口返回时间 < 800ms(P95) |
发现 1 条不合格,全部用例重检——说明提示词里的断言约束没生效。
## 用例统计
- 总用例数:34
- 覆盖需求条目:6/8(75%)
- P0 需求端到端用例:3 条
- 边界用例:12 条
- 异常用例:9 条
- 断言复核:34 条已逐条确认可观测
需求覆盖率低于 80% 时主动提示,不要闷头往下写。
不许跳阶段直接猜。 猜出来的根因,修的地方一定错。
先确认能稳定复现,写清精确条件:什么数据、什么入口、什么权限、什么时序。复现不了就不要往下走,先补信息。
用二分法排除,不要一次改多处试探:
| 层 | 要排除的 |
|---|---|
| 入口 | 参数是否正确传到(打日志) |
| 业务 | 是否走了预期分支(断点或日志) |
| 数据 | 读到的数据是不是预期值 |
| 依赖 | 外部接口/中间件返回是否正常 |
一次只验证一层,确认正常就排除该层,缩小范围。
说出完整假设:"如果是 X 导致,那么 Y 应该成立",然后去验证 Y。
验证不成立,说明假设错了,回到阶段 2,不要硬改。
没说清"验证了什么"就不算修好。
## 根因报告
- 现象:
- 复现条件:
- 收窄过程:排除了入口、依赖,定位在数据层
- 根因:余额查询在用户无年假记录时返回 null,未判空
- 验证:造无假期记录账号,必现;有记录的账号,不出现
- 修复后:复现用例转绿,考勤模块 23 条回归用例全绿
- 遗留:同一查询在「调休余额」处有相同写法,已单独提 issue
| 禁止 | 原因 |
|---|---|
| 写没有断言的用例 | 跑了等于没跑 |
| 用主观描述当断言 | 无法判定通过与否 |
| 跳过覆盖矩阵直接写用例 | 必然漏测,且漏了看不出来 |
| 未经确认就声称覆盖率达 80% | 覆盖率要能算出来,不能估 |
不许说"用例写完了""测试通过了"。 按下面格式交代:
## 完成自证
- 已交付:测试用例 34 条,覆盖 6/8 个需求条目(75%)
- 已验证:34 条断言逐条确认可观测;边界值成组;P0 有端到端场景
- 未覆盖:F-007 考勤台账、F-008 数据导出(需求无验收标准)
- 未执行:性能测试(缺压测环境)、安全测试(待工具到位)
- 未验证:测试环境与生产环境的配置差异部分
被问"测完了吗",正确回答:
功能测试跑完三轮,34 条用例全绿;性能和安全没做,缺环境。
而不是"测完了"。"测试通过"这句话如果说不清范围,就是误导。
references/模板与提示词.md — 用例格式、生成提示词、性能与安全测试提示词references/模板-测试报告.md — 功能测试报告与性能测试报告格式,出报告时读references/复核清单.md — 用例质量检查项、断言反例对照