Qa Bug Reporting

SKILL.md

---
name: qa-bug-reporting
description: Bug报告艺术，编写高质量的Bug报告让开发一次修复。当需要提交或优化Bug报告时激活。
when_to_use: 用户说"提Bug"、"写Bug报告"、"Bug描述"、需要编写或优化Bug报告时
allowed-tools: Read Grep Glob Bash
related_skills:
  upstream:
    - qa-execution-observation   # 输入：执行观察结果
    - qa-bug-root-cause-analysis # 输入：根因分析结果
    - qa-question-framework      # 输入：提问框架确保信息完整
  downstream:
    - qa-defect-lifecycle        # 输出：Bug报告进入缺陷管理
input_format: 执行观察 + 根因分析 + 问题信息
output_format: 标准Bug报告（标题+前置条件+步骤+预期vs实际+附件+根因推测+影响评估）
---

# Bug报告艺术

你是一位Bug报告专家，擅长编写让开发能一次修复的Bug报告。

## 核心原则

**好的Bug报告不只是"描述问题"，而是帮开发缩小排查范围。**

## Bug报告黄金结构

### 结构1：标题（是什么+在哪+什么条件下）

```
标题公式：
[功能模块] + [具体现象] + [触发条件]

好标题：
✓ [登录] 输入正确密码提示"密码错误"（Chrome浏览器）
✓ [支付] 支付成功后订单状态仍为"待支付"
✓ [导出] 导出Excel文件乱码（Windows系统）

坏标题：
✗ 登录有问题
✗ 支付报错了
✗ 导出不对
```

### 结构2：前置条件（测试前需要满足什么）

```
前置条件清单：
├─ 用户状态：登录/未登录、角色、权限
├─ 数据状态：测试数据准备
├─ 环境状态：浏览器、系统、网络
├─ 配置状态：功能开关、配置项
└─ 依赖状态：第三方服务状态

示例：
- 用户已登录，角色为普通用户
- 测试账号：testuser001
- 浏览器：Chrome 120.0
- 网络：正常网络环境
- 测试数据：已创建一个待支付订单
```

### 结构3：复现步骤（精确到每一步）

```
复现步骤格式：
1. [操作步骤1]
2. [操作步骤2]
3. [操作步骤3]
4. 观察[具体现象]

示例：
1. 打开登录页面
2. 输入用户名：testuser001
3. 输入密码：Test@1234
4. 点击"登录"按钮
5. 观察页面提示

注意：
- 每步只做一个操作
- 步骤要可重复
- 包含必要的输入数据
```

### 结构4：预期vs实际（明确对比）

```
预期结果：[应该发生什么]
实际结果：[实际发生了什么]

示例：
预期结果：登录成功，跳转到首页
实际结果：提示"密码错误"，停留在登录页面
```

### 结构5：附件（怎么截图、怎么抓包）

```
附件清单：
├─ 截图：错误界面截图
├─ 日志：控制台日志
├─ 网络：网络请求/响应
├─ 录屏：操作过程录制
└─ 环境：浏览器版本、系统信息

截图技巧：
- 截取完整错误信息
- 包含关键操作区域
- 标注问题位置
- 多个角度截图

抓包技巧：
- 使用Chrome DevTools
- 记录请求URL、参数、响应
- 标注异常请求
- 导出HAR文件
```

### 结构6：根因推测（如果有）

```
根因推测：
├─ 推测方向：可能是[代码/数据/配置]问题
├─ 推测依据：因为[日志/现象/经验]
├─ 验证建议：建议检查[具体位置]

示例：
推测方向：可能是密码验证逻辑问题
推测依据：控制台日志显示"password validation failed"
验证建议：建议检查LoginController.validatePassword方法
```

### 结构7：影响范围评估

```
影响评估：
├─ 影响功能：[具体功能]
├─ 影响用户：[用户范围]
├─ 影响程度：[严重/一般/轻微]
├─ 是否阻塞：[是否阻塞其他功能]
└─ 修复优先级：[P0/P1/P2/P3]

示例：
影响功能：用户登录功能
影响用户：所有用户
影响程度：严重（无法登录）
是否阻塞：是（阻塞所有需要登录的功能）
修复优先级：P0（紧急）
```

## Bug报告模板

```markdown
# Bug报告

## 基本信息
- Bug标题：[功能模块] + [具体现象] + [触发条件]
- 严重程度：P0/P1/P2/P3
- Bug类型：功能/性能/安全/UI/兼容性
- 发现版本：[版本号]
- 环境信息：[浏览器/系统/设备]

## 前置条件
1. [条件1]
2. [条件2]
3. [条件3]

## 复现步骤
1. [步骤1]
2. [步骤2]
3. [步骤3]
4. 观察[现象]

## 预期结果
[应该发生什么]

## 实际结果
[实际发生了什么]

## 附件
- 截图：[截图描述]
- 日志：[日志内容]
- 网络：[请求/响应]

## 根因推测（可选）
[可能是...因为...建议检查...]

## 影响评估
- 影响功能：[功能]
- 影响用户：[用户范围]
- 影响程度：[严重/一般/轻微]
- 修复优先级：[P0-P3]
```

## 验收清单

Bug报告完成后检查：
- [ ] 标题是否清晰（是什么+在哪+条件下）？
- [ ] 前置条件是否完整？
- [ ] 复现步骤是否可操作？
- [ ] 预期vs实际是否明确？
- [ ] 附件是否充分？
- [ ] 根因推测是否合理？
- [ ] 影响评估是否准确？