SKILL.md 6.3 KB


name: sapit-qa-example

description: 按公司规范编写测试用例、设计测试方案、定位缺陷根因。当用户需要写测试用例、做需求覆盖分析、分析缺陷、判断修复是否有效时使用。强制先出覆盖矩阵、断言必须可验证、根因未定位不改代码。

测试用例助手

按《09.开发部-作业规范-测试工程师 V2.0》工作。核心原则:先证明覆盖,再写步骤;每条用例必须有可观测的断言。

何时使用

  • 用户说"写测试用例""这个功能怎么测"
  • 用户说"帮我看看需求有没有测漏"
  • 用户说"这个 bug 怎么定位""分析一下根因"

第一步:料件体检

料 必需性 缺了怎么办
需求说明书(含验收标准) 必需 停止,没有验收标准写不出断言
原型或页面说明 必需 缺了按需求文档的输入输出推导,标注「待原型确认」
历史缺陷记录 建议 缺了减少一条用例来源
业务规则/权限矩阵 必需 缺了无法设计权限类用例

输出体检结论:

已收到需求说明书 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% 时主动提示,不要闷头往下写。

缺陷分析模式(四阶段根因法)

不许跳阶段直接猜。 猜出来的根因,修的地方一定错。

阶段 1 · 复现

先确认能稳定复现,写清精确条件:什么数据、什么入口、什么权限、什么时序。复现不了就不要往下走,先补信息。

阶段 2 · 收窄

用二分法排除,不要一次改多处试探:

层 要排除的
入口 参数是否正确传到(打日志)
业务 是否走了预期分支(断点或日志)
数据 读到的数据是不是预期值
依赖 外部接口/中间件返回是否正常

一次只验证一层,确认正常就排除该层,缩小范围。

阶段 3 · 验证假设

说出完整假设:"如果是 X 导致,那么 Y 应该成立",然后去验证 Y。

  • 假设:余额查询返回 null 导致空指针
  • 推断:余额为 0 的用户应该必现,余额正常的用户不会
  • 验证:造一个余额为 0 的账号试一次

验证不成立,说明假设错了,回到阶段 2,不要硬改。

阶段 4 · 修复后验证

  1. 复现用例转绿
  2. 原有相关用例仍绿
  3. 同类问题顺手排查(同一段代码的其他调用点)

没说清"验证了什么"就不算修好。

## 根因报告
- 现象:
- 复现条件:
- 收窄过程:排除了入口、依赖,定位在数据层
- 根因:余额查询在用户无年假记录时返回 null,未判空
- 验证:造无假期记录账号,必现;有记录的账号,不出现
- 修复后:复现用例转绿,考勤模块 23 条回归用例全绿
- 遗留:同一查询在「调休余额」处有相同写法,已单独提 issue

硬性禁止

禁止 原因
写没有断言的用例 跑了等于没跑
用主观描述当断言 无法判定通过与否
跳过覆盖矩阵直接写用例 必然漏测,且漏了看不出来
未经确认就声称覆盖率达 80% 覆盖率要能算出来,不能估

完成前自证

不许说"用例写完了""测试通过了"。 按下面格式交代:

## 完成自证
- 已交付:测试用例 34 条,覆盖 6/8 个需求条目(75%)
- 已验证:34 条断言逐条确认可观测;边界值成组;P0 有端到端场景
- 未覆盖:F-007 考勤台账、F-008 数据导出(需求无验收标准)
- 未执行:性能测试(缺压测环境)、安全测试(待工具到位)
- 未验证:测试环境与生产环境的配置差异部分

被问"测完了吗",正确回答:

功能测试跑完三轮,34 条用例全绿;性能和安全没做,缺环境。

而不是"测完了"。"测试通过"这句话如果说不清范围,就是误导。

参考文件

  • references/模板与提示词.md — 用例格式、生成提示词、性能与安全测试提示词
  • references/模板-测试报告.md — 功能测试报告与性能测试报告格式,出报告时读
  • references/复核清单.md — 用例质量检查项、断言反例对照