Bug 分析工作流
- Skill 标识
bug-analysis-skill- 所属分类
- 软件测试 / 缺陷与故障分析
把“支付成功但订单没更新”拆成可验证的问题。八步工作流串起现象、模块、日志、SQL、历史缺陷与回归范围,让 Bug 报告带上排查路径,而不只是一句“请开发查看”。
本文目录
- Skill 概览
- 适合谁、用在什么场景
- 需要准备什么、能得到什么
- 核心能力与使用边界
- 实战教程与使用说明
- 零、开始之前:你需要准备什么
- 一、先理解:为什么 Bug 分析必须工作流化?
- 1.1 常见误区(对照自检)
- 1.2 Bug 分析的本质:问题收敛流程
- 二、八步工作流总览(先记全貌,再逐节实操)
- 三、动手实操:从零搭建 Bug 分析 Skill 工作流
- 3.1 第一步:设计结构化 Bug 输入(决定 AI 分析上限)
- 3.2 第二步:提取问题现象(禁止一上来猜根因)
- 3.3 第三步:判断影响模块(业务链路识别)
- 3.4 第四步:推荐日志方向
- 3.5 第五步:推荐 SQL 方向
- 3.6 第六步:关联历史 Bug
- 3.7 第七步:输出回归范围
- 3.8 第八步:判断风险等级
- 四、完整 Skill 工作流模板(可直接复制)
- 4.1 验证步骤(照着做 5 步)
- 五、综合案例:支付成功但订单未支付(端到端)
- 5.1 输入(可以用这个粘贴即用测试)
- 5.2 期望输出摘要(你对照检查)
- 六、四类场景速查(课堂可选用)
- 七、常见错误与排错
- 八、课堂练习(必做)
- 九、本节总结
- 附录 A:学习资料与附件准备清单
- A.1 建议准备的附件(按优先级)
- A.2 推荐目录结构(本地 Skill)
- 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」就暴露短板:
Bug:支付成功,但订单状态未更新。
常见反应:
「可能是网络问题」
「让研发查一下」
缺失的是:
分析路径、排查方向、影响范围、回归思维
核心结论:高级测试不是「发现 Bug」,而是会拆 Bug——把模糊问题拆成可验证、可排查、可回归的结构化输出。
1.2 Bug 分析的本质:问题收敛流程
真实排查从来不是「看一眼就知道原因」,而是按步骤收敛:
看问题现象 → 判断影响模块 → 查日志 → 查 SQL
→ 分析调用链 → 关联历史 Bug → 判断风险等级 → 输出回归范围
工作流解决的四类问题:
AI 乱猜根因
测试乱查、无方向
排查效率低
修复后回归范围遗漏
二、八步工作流总览(先记全貌,再逐节实操)
步骤 | 名称 | 输出物 |
|---|---|---|
① | 结构化 Bug 输入 | 标准 Bug 描述模板 |
② | 提取问题现象 | 现象列表(不猜原因) |
③ | 判断影响模块 | 模块/服务清单 |
④ | 推荐日志方向 | 关键词 + 日志路径 |
⑤ | 推荐 SQL 方向 | 可执行查询语句 |
⑥ | 关联历史 Bug | 相似案例 + 曾用根因 |
⑦ | 输出回归范围 | 功能/接口/场景列表 |
⑧ | 判断风险等级 | P0~P3 + 理由 |
可选第九步:人工复核——对 AI 输出逐项打勾,标注「已验证 / 待验证」。
三、动手实操:从零搭建 Bug 分析 Skill 工作流
3.1 第一步:设计结构化 Bug 输入(决定 AI 分析上限)
错误输入(AI 无法分析):
订单有问题
正确输入(复制下面模板使用):
## 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 第二步:提取问题现象(禁止一上来猜根因)
规则:只描述「观察到什么」,不写「因为什么」。
输入:支付成功,订单未支付
应拆成现象:
## 问题现象
- 第三方支付渠道返回支付成功
- 订单表状态字段仍为「未支付」
- 用户端页面展示与后台状态一致(未支付)
- 存在「支付态 vs 订单态」不一致
在 Skill 工作流中可写死输出格式:
### Step 2:提取问题现象
- 仅列出可观测事实,每条以「-」开头
- 禁止出现「可能」「应该是」「大概」
- 若输入含推测性语句,改写为现象或标注「待验证假设」
3.3 第三步:判断影响模块(业务链路识别)
案例「支付成功、订单未更新」应覆盖:
支付服务 | 订单服务 | MQ/消息 | 库存 | 优惠券 | 对账/流水
在 Skill 中维护模块映射表(可按业务扩展):
| 现象关键词 | 关联模块 |
|------------|----------|
| 支付成功、订单未更新 | 支付、订单、MQ、库存、优惠券 |
| 库存为0仍可下单 | 库存、订单、购物车、支付 |
| Token失效、401 | 登录、网关鉴权、用户中心、权限 |
| 接口超时 | 网关、下游服务、DB连接池、慢SQL |
3.4 第四步:推荐日志方向
支付类 Bug 推荐检索:
payment callback / order update / mq consume / transaction rollback
关键词:callback success, update order failed, mq send failed
接口超时类:
timeout / connection refused / pool exhausted
Skill 输出格式示例:
## 日志排查建议
| 优先级 | 服务/路径 | 关键词 | 关注点 |
|--------|-----------|--------|--------|
| P0 | payment-service | callback, notify | 回调是否收到、签名校验 |
| P0 | order-service | update status | 更新订单是否执行 |
| P1 | mq-consumer | consume, retry | 是否消费失败、重试堆积 |
3.5 第五步:推荐 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,每条包含:现象标签、模块、根因、修复方式。
## BUG-2024-088
- 标签:支付成功、订单未更新、MQ
- 模块:支付、订单、MQ
- 根因:MQ 消费失败,订单状态未更新
- 修复:补偿任务 + 消费重试告警
- 日志特征:update order failed, mq consume error
AI 关联时按:关键词 + 模块 + 日志特征 匹配,输出:
## 历史 Bug 关联
- [高相似] BUG-2024-088:MQ 消费失败导致订单未更新
- [中相似] BUG-2023-041:支付回调重复,幂等未拦住
3.7 第七步:输出回归范围
支付问题回归范围示例:
支付下单 | 支付回调 | 订单状态查询 | 库存扣减
优惠券核销/回退 | 支付流水 | 退款全链路 | 对账任务
要求 Skill 输出时区分:
必测(P0 链路)
建议测(关联模块)
抽测(低关联)
3.8 第八步:判断风险等级
等级 | 典型场景 | 处理要求 |
|---|---|---|
P0 | 重复扣款、资金不一致、大面积不可用 | 立即升级,阻断发布 |
P1 | 订单状态错误、核心流程受阻 | 24h 内修复验证 |
P2 | 部分用户、可绕行 | 排期修复 |
P3 | UI 文案、非核心展示 | 常规排期 |
「支付成功订单未支付」→ 通常 P0/P1(资金链路 + 用户无法完成交易)。
四、完整 Skill 工作流模板(可直接复制)
将以下内容写入 SKILL.md 或 references/bug-analysis-workflow.md:
---
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 步)
创建 Skill 目录,放入模板 + module-map + history-bugs
用「支付成功订单未支付」标准输入调用 Agent
检查是否 8 步齐全、现象无「可能」、SQL 可改 ID 执行
故意只输入「订单有问题」,看 Agent 是否追问
对照真实日志/SQL 结果,在报告中标注「已验证/未验证」
五、综合案例:支付成功但订单未支付(端到端)
5.1 输入(可以用这个粘贴即用测试)
标题:支付成功但订单仍显示未支付
环境:生产,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 失效
接口超时
交付物:
一份结构化 Bug 输入
一份完整 Bug 分析报告(10 个小节)
人工复核清单打勾结果
九、本节总结
完整 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)
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全文档:
扫码添加辅导员,发送 Skill 名称,领取源码与配套资料。