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