Bug 分析工作流

Skill 标识
bug-analysis-skill

把“支付成功但订单没更新”拆成可验证的问题。八步工作流串起现象、模块、日志、SQL、历史缺陷与回归范围,让 Bug 报告带上排查路径,而不只是一句“请开发查看”。

扫码添加辅导员,发送 Skill 名称领取源码
本文目录
  1. Skill 概览
  2. 适合谁、用在什么场景
  3. 需要准备什么、能得到什么
  4. 核心能力与使用边界
  5. 实战教程与使用说明
  6. 零、开始之前:你需要准备什么
  7. 一、先理解:为什么 Bug 分析必须工作流化?
  8. 1.1 常见误区(对照自检)
  9. 1.2 Bug 分析的本质:问题收敛流程
  10. 二、八步工作流总览(先记全貌,再逐节实操)
  11. 三、动手实操:从零搭建 Bug 分析 Skill 工作流
  12. 3.1 第一步:设计结构化 Bug 输入(决定 AI 分析上限)
  13. 3.2 第二步:提取问题现象(禁止一上来猜根因)
  14. 3.3 第三步:判断影响模块(业务链路识别)
  15. 3.4 第四步:推荐日志方向
  16. 3.5 第五步:推荐 SQL 方向
  17. 3.6 第六步:关联历史 Bug
  18. 3.7 第七步:输出回归范围
  19. 3.8 第八步:判断风险等级
  20. 四、完整 Skill 工作流模板(可直接复制)
  21. 4.1 验证步骤(照着做 5 步)
  22. 五、综合案例:支付成功但订单未支付(端到端)
  23. 5.1 输入(可以用这个粘贴即用测试)
  24. 5.2 期望输出摘要(你对照检查)
  25. 六、四类场景速查(课堂可选用)
  26. 七、常见错误与排错
  27. 八、课堂练习(必做)
  28. 九、本节总结
  29. 附录 A:学习资料与附件准备清单
  30. A.1 建议准备的附件(按优先级)
  31. A.2 推荐目录结构(本地 Skill)
  32. A.3 课前自检(学员)

Skill 概览

适合谁、用在什么场景

希望提升缺陷分析、问题收敛及跨团队沟通能力的测试工程师。

需要准备什么、能得到什么

  • 输入材料:结构化 Bug 描述、复现条件及可选的日志、模块图、历史缺陷与数据结构。
  • 交付产物:影响模块、日志与 SQL 排查方向、关联历史缺陷、回归范围和风险等级。

核心能力与使用边界

  • 核心能力:按八步收敛现象到验证路径,提供工作流模板和支付状态异常的完整案例。
  • 使用边界:推荐方向不等于确认根因;缺少日志或数据证据时须保留假设及人工复核点。

实战教程与使用说明

本教程目标:把「会提 Bug」升级为「会拆 Bug」。学完你能设计一套可执行的 Bug 分析工作流,并写进 Skill,让 AI 按步骤收敛问题、推荐排查方向、输出回归范围。

零、开始之前:你需要准备什么

准备项

说明

是否必须

Cursor / Agent 环境

能创建、编辑 Skill

必须

1~2 个真实 Bug 案例

可脱敏的生产/测试缺陷

必须

业务架构简图或模块清单

支付/订单/MQ 等链路

建议

历史 Bug 库(5~20 条)

含现象、根因、模块标签

建议

日志样例(.log)

含 callback、timeout 等关键词

建议

表结构或 SQL 查询权限

用于验证 SQL 推荐是否合理

可选

预计耗时:阅读 25 分钟 + 动手搭建工作流 45~60 分钟。


一、先理解:为什么 Bug 分析必须工作流化?

1.1 常见误区(对照自检)

很多测试人提 Bug 没问题,但一到「分析 Bug」就暴露短板:

plain
Bug:支付成功,但订单状态未更新。

常见反应:
  「可能是网络问题」
  「让研发查一下」

缺失的是:
  分析路径、排查方向、影响范围、回归思维

核心结论:高级测试不是「发现 Bug」,而是会拆 Bug——把模糊问题拆成可验证、可排查、可回归的结构化输出。

1.2 Bug 分析的本质:问题收敛流程

真实排查从来不是「看一眼就知道原因」,而是按步骤收敛:

plain
看问题现象 → 判断影响模块 → 查日志 → 查 SQL
→ 分析调用链 → 关联历史 Bug → 判断风险等级 → 输出回归范围

工作流解决的四类问题:

  • AI 乱猜根因

  • 测试乱查、无方向

  • 排查效率低

  • 修复后回归范围遗漏


二、八步工作流总览(先记全貌,再逐节实操)

步骤

名称

输出物

①

结构化 Bug 输入

标准 Bug 描述模板

②

提取问题现象

现象列表(不猜原因)

③

判断影响模块

模块/服务清单

④

推荐日志方向

关键词 + 日志路径

⑤

推荐 SQL 方向

可执行查询语句

⑥

关联历史 Bug

相似案例 + 曾用根因

⑦

输出回归范围

功能/接口/场景列表

⑧

判断风险等级

P0~P3 + 理由

可选第九步:人工复核——对 AI 输出逐项打勾,标注「已验证 / 待验证」。


三、动手实操:从零搭建 Bug 分析 Skill 工作流

3.1 第一步:设计结构化 Bug 输入(决定 AI 分析上限)

错误输入(AI 无法分析):

plain
订单有问题

正确输入(复制下面模板使用):

markdown
## Bug 标题
支付成功但订单状态仍显示未支付

## 环境信息
- 环境:生产 / 预发 / 测试
- 版本:App 3.2.1 / 服务端 build xxx
- 用户/订单 ID:(脱敏)

## 复现步骤
1. 提交订单 order_id=xxx
2. 微信支付成功
3. 返回订单详情页

## 实际结果
订单状态仍为「待支付」

## 预期结果
订单应显示「已支付」

## 接口信息(如有)
- 请求:POST /api/pay/callback ...
- 响应:{ "code": 0, "payStatus": "SUCCESS" }
- 错误码:

## 日志片段(如有)
粘贴相关 ERROR/WARN 行

## 附件
截图 / 录屏 / traceId

操作:在 Skill 的 references/bug-input-template.md 中保存上述模板,并在 SKILL.md 写明「用户未按模板提供时,先追问缺失字段」。

3.2 第二步:提取问题现象(禁止一上来猜根因)

规则:只描述「观察到什么」,不写「因为什么」。

输入:支付成功,订单未支付

应拆成现象:

markdown
## 问题现象
- 第三方支付渠道返回支付成功
- 订单表状态字段仍为「未支付」
- 用户端页面展示与后台状态一致(未支付)
- 存在「支付态 vs 订单态」不一致

在 Skill 工作流中可写死输出格式:

markdown
### Step 2:提取问题现象
- 仅列出可观测事实,每条以「-」开头
- 禁止出现「可能」「应该是」「大概」
- 若输入含推测性语句,改写为现象或标注「待验证假设」

3.3 第三步:判断影响模块(业务链路识别)

案例「支付成功、订单未更新」应覆盖:

plain
支付服务 | 订单服务 | MQ/消息 | 库存 | 优惠券 | 对账/流水

在 Skill 中维护模块映射表(可按业务扩展):

markdown
| 现象关键词 | 关联模块 |
|------------|----------|
| 支付成功、订单未更新 | 支付、订单、MQ、库存、优惠券 |
| 库存为0仍可下单 | 库存、订单、购物车、支付 |
| Token失效、401 | 登录、网关鉴权、用户中心、权限 |
| 接口超时 | 网关、下游服务、DB连接池、慢SQL |

3.4 第四步:推荐日志方向

支付类 Bug 推荐检索:

plain
payment callback / order update / mq consume / transaction rollback
关键词:callback success, update order failed, mq send failed

接口超时类:

plain
timeout / connection refused / pool exhausted

Skill 输出格式示例:

markdown
## 日志排查建议
| 优先级 | 服务/路径 | 关键词 | 关注点 |
|--------|-----------|--------|--------|
| P0 | payment-service | callback, notify | 回调是否收到、签名校验 |
| P0 | order-service | update status | 更新订单是否执行 |
| P1 | mq-consumer | consume, retry | 是否消费失败、重试堆积 |

3.5 第五步:推荐 SQL 方向

订单未更新场景——给出可直接改参数执行的 SQL:

sql
-- 1. 查订单当前状态
SELECT order_id, pay_status, order_status, updated_at
FROM order_info
WHERE order_id = '替换为实际ID';

-- 2. 查支付流水
SELECT pay_id, trade_no, pay_status, callback_time
FROM pay_record
WHERE order_id = '替换为实际ID';

-- 3. 查 MQ 消费或补偿记录(表名按实际库调整)
SELECT * FROM mq_consume_log
WHERE biz_id = '替换为实际ID'
ORDER BY created_at DESC LIMIT 20;

注意:Skill 中应提醒「生产库只读、脱敏」,SQL 仅作方向参考,执行前需 DBA/研发确认。

3.6 第六步:关联历史 Bug

准备 references/history-bugs.md,每条包含:现象标签、模块、根因、修复方式。

markdown
## BUG-2024-088
- 标签:支付成功、订单未更新、MQ
- 模块:支付、订单、MQ
- 根因:MQ 消费失败,订单状态未更新
- 修复:补偿任务 + 消费重试告警
- 日志特征:update order failed, mq consume error

AI 关联时按:关键词 + 模块 + 日志特征 匹配,输出:

markdown
## 历史 Bug 关联
- [高相似] BUG-2024-088:MQ 消费失败导致订单未更新
- [中相似] BUG-2023-041:支付回调重复,幂等未拦住

3.7 第七步:输出回归范围

支付问题回归范围示例:

plain
支付下单 | 支付回调 | 订单状态查询 | 库存扣减
优惠券核销/回退 | 支付流水 | 退款全链路 | 对账任务

要求 Skill 输出时区分:

  • 必测(P0 链路)

  • 建议测(关联模块)

  • 抽测(低关联)

3.8 第八步:判断风险等级

等级

典型场景

处理要求

P0

重复扣款、资金不一致、大面积不可用

立即升级,阻断发布

P1

订单状态错误、核心流程受阻

24h 内修复验证

P2

部分用户、可绕行

排期修复

P3

UI 文案、非核心展示

常规排期

「支付成功订单未支付」→ 通常 P0/P1(资金链路 + 用户无法完成交易)。


四、完整 Skill 工作流模板(可直接复制)

将以下内容写入 SKILL.md 或 references/bug-analysis-workflow.md:

markdown
---
name: bug-analysis-workflow
description: 按八步工作流分析 Bug,输出结构化排查报告。输入不完整时先追问。
---

# Bug 分析工作流

## 执行顺序(必须逐步输出,禁止跳步)

1. **校验输入**:对照 bug-input-template,缺项则列出待补充问题
2. **问题现象**:仅事实,列表输出
3. **影响模块**:结合 module-map,列出服务/模块
4. **日志方向**:表格(优先级、服务、关键词、关注点)
5. **SQL 方向**:给出可改参数的 SELECT(标注只读)
6. **历史 Bug**:匹配 history-bugs,标注相似度
7. **回归范围**:必测 / 建议测 / 抽测
8. **风险等级**:P0-P3 + 1-2 句理由
9. **人工复核清单**:供测试打勾

## 输出格式(固定)

```markdown
# Bug 分析报告

## 1. 输入摘要
## 2. 问题现象
## 3. 影响模块
## 4. 日志排查建议
## 5. SQL 排查建议
## 6. 历史 Bug 关联
## 7. 回归范围
## 8. 风险等级
## 9. 待验证假设(若有)
## 10. 人工复核清单
```

## 禁止行为
- 无日志/无数据时断言根因
- 跳过现象直接给「修复方案」
- 回归范围仅写「相关功能」等模糊表述

4.1 验证步骤(照着做 5 步)

  1. 创建 Skill 目录,放入模板 + module-map + history-bugs

  2. 用「支付成功订单未支付」标准输入调用 Agent

  3. 检查是否 8 步齐全、现象无「可能」、SQL 可改 ID 执行

  4. 故意只输入「订单有问题」,看 Agent 是否追问

  5. 对照真实日志/SQL 结果,在报告中标注「已验证/未验证」


五、综合案例:支付成功但订单未支付(端到端)

5.1 输入(可以用这个粘贴即用测试)

markdown
标题:支付成功但订单仍显示未支付
环境:生产,App 3.2.0,order_id=ORD***123
步骤:下单 → 微信支付成功 → 回订单页
实际:状态「待支付」;预期:「已支付」
接口:回调返回 payStatus=SUCCESS
日志:order-service ERROR update status failed traceId=abc123

5.2 期望输出摘要(你对照检查)

  • 现象:支付成功 vs 订单未更新、状态不一致

  • 模块:支付、订单、MQ、库存、优惠券

  • 日志:callback、update order failed、mq consume

  • SQL:order_info、pay_record、mq 相关表

  • 历史:关联 MQ 消费失败类 Bug

  • 回归:支付回调、订单查询、退款、对账

  • 风险:P0 或 P1


六、四类场景速查(课堂可选用)

场景

重点模块

日志关键词

风险参考

支付成功订单未支付

支付、订单、MQ

callback, update failed

P0/P1

库存超卖

库存、订单、购物车

stock, oversell, lock

P0

登录 Token 失效

登录、鉴权、网关

token, 401, refresh

P1

接口超时

网关、下游、DB

timeout, pool exhausted

P1/P2


七、常见错误与排错

错误

现象

改法

输入太简略

AI 泛泛而谈

强制使用 bug-input-template,缺项追问

跳过现象猜根因

「可能是缓存」

工作流写明「Step2 禁止推测」

无 module-map

漏模块

维护 references 映射表

无 history-bugs

无法关联经验

持续沉淀历史案例

回归范围模糊

「测一下支付」

要求必测/建议测/抽测三级


八、课堂练习(必做)

任务:从下面选一个场景,独立完成「输入模板 + 八步工作流输出」。

  • 支付成功但订单未支付

  • 库存超卖

  • 登录 Token 失效

  • 接口超时

交付物:

  1. 一份结构化 Bug 输入

  2. 一份完整 Bug 分析报告(10 个小节)

  3. 人工复核清单打勾结果


九、本节总结

完整 Bug 分析 = 输入结构化 + 现象 + 模块 + 日志 + SQL + 历史关联 + 回归范围 + 风险等级。

未来高级测试的核心竞争力,不是「会不会提 Bug」,而是能不能把 Bug 分析流程 AI 化、工作流化。


附录 A:学习资料与附件准备清单

备注:以下资料建议开课前准备,作为 Skill 的 references 附件,分析质量会明显提升。

A.1 建议准备的附件(按优先级)

附件名称

格式

用途

优先级

Bug 输入标准模板

.md

统一输入,减少 AI 乱猜

P0

业务模块/架构简图

.png / .md

影响模块识别

P0

历史 Bug 库(5~20 条)

.md / .xlsx

历史关联、经验检索

P0

模块-现象映射表

module-map.md

自动关联服务

P0

典型错误日志样例

.log / .txt

日志关键词训练

P1

核心表结构说明

.md / DDL 片段

SQL 推荐校验

P1

接口文档 / Swagger

URL / JSON

接口类 Bug 输入

P1

风险等级定义表

.md

P0~P3 判定一致

P1

回归用例清单模板

.xlsx

回归范围落地

P2

A.2 推荐目录结构(本地 Skill)

plain
bug-analysis-skill/
├── SKILL.md
└── references/
    ├── bug-input-template.md    # Bug 输入模板
    ├── bug-analysis-workflow.md # 八步工作流规则
    ├── module-map.md            # 现象→模块映射
    ├── history-bugs.md          # 历史 Bug 库
    ├── log-keywords.md          # 常见日志关键词
    ├── sql-snippets.md          # 常用排查 SQL
    └── risk-levels.md           # P0-P3 定义
└── examples/
    ├── payment-order-mismatch-report.md  # 样例输出
    └── sample-error.log                  # 样例日志

A.3 课前自检(学员)

  • 已准备至少 1 个可脱敏的真实 Bug

  • 已安装 Cursor 或同类 Agent 工具

  • 已能创建 .cursor/skills/ 或项目 skills 目录

  • 已阅读本文第三节并完成一次试跑

问题反馈:若 AI 仍乱猜根因,检查工作流是否写明「禁止跳步」及是否挂载 history-bugs、module-map。仍有问题可附上完整对话记录联系辅导员。

本节课对应的skill全文档:

开始使用 bug-analysis-skill

扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。

同类 Skills