缺陷报告

当发现了一个 Bug 需要提交、自己提的 Bug 被开发打回来了、或者团队 Bug 质量参差不齐需要统一规范时使用此技能。一个高质量的 Bug 报告应该让开发看一遍就能复现并定位，不需要来回追问。包含清晰的复现步骤（从环境准备到操作序列到预期/实际结果）、根因推测、影响范围评估和必要附件。 ⚠️ 本技能示例可能调用外部抓包/日志工具，请在受控环境执行。 本技能属于 QA Test Skills 技能集（49 个技能之一），完整工作流体验需安装全套：npx skills add Kokxi/qa-test-skills

⚠️ 本技能单独使用效果有限，建议配合完整技能集（12 步工作流）使用。安装：npx skills add Kokxi/qa-test-skills

⚠️ 安全警告：本技能的示例可能涉及订单号、支付金额、截图、身份证、手机号等敏感数据。 实际使用时请勿粘贴真实生产数据、客户信息或财务凭证；测试前应脱敏/掩码处理。 本技能仅在 workspace/ 输出评估文件，不持久化、不外传、不跨会话复用。

Bug报告艺术

核心原则

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

Bug报告黄金结构

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

text

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

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

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

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

text

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

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

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

text

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

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

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

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

text

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

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

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

text

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

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

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

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

text

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

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

结构7：影响范围评估

text

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

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

Bug报告模板

📌 本节与 qa-bug-lifecycle「缺陷报告模板」为同一概念的两个版本。本技能模板侧重执行（含前置条件、影响评估），lifecycle 模板侧重管理（含状态、优先级字段）。修改字段时请同步更新两个模板。

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报告结构生成：

• 标题：[登录] 输入正确密码后提示"密码错误"（Chrome浏览器）
• 前置条件：已注册用户testuser001，Chrome 120.0
• 复现步骤和预期vs实际结果

用户需要提交支付Bug → 自动组装Bug报告7个结构部分，生成标准格式的Bug报告

开发打回Bug报告说"无法复现" → 触发本技能补充复现步骤细节和环境信息

检查清单

Bug报告完成后检查：

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