Bug自动分类与优先级判定

1. 这个数字员工做什么

测试人员在简道云提交 Bug（填写描述 + 上传截图），悟帆自动收到通知，分析 Bug 文本和截图内容，判断 Bug 类别（功能/性能/UI）和建议优先级（P0-P3），再自动写回同一条 Bug 记录中。

以前是"测试提 Bug → 测试主管逐条阅读 → 人工判断分类 → 人工评估优先级 → 手动改表单"。现在是"测试只管提 Bug → 悟帆自动分类+定级"。中间全部跳过，测试主管只需要审核 AI 的判定结果就行。

2. 适用角色

测试工程师、测试主管、QA 负责人、项目经理、研发组长。

3. 效果预览

4. 简道云侧准备

4.1 表单设计：Bug 管理表

这张表是整个场景的数据载体，测试人员在这里提交 Bug，悟帆的分析结果也写回到同一条记录中。

4.2 智能助手 Pro 配置

在简道云中配置一条智能助手，用于在 Bug 新增时自动通知悟帆：

4.3 Webhook 配置

在智能助手的 Webhook 节点中配置：

提示：app_id 和 entry_id 可以在简道云表单的 URL 中找到，也可以写成固定值。

5. 悟帆侧准备

5.1 知识库：Bug 分类与优先级判定规范

这份规范文档是悟帆做判断的"大脑"。不放在简道云的知识库里也行——悟帆自己能保存和引用。重点是写清楚判定逻辑，不要笼统。

好的写法（具体可执行）：

## Bug 分类规则

### 功能类
- 某个功能无法正常使用（如按钮点击无反应、数据保存失败、流程无法流转）
- 功能逻辑与需求不符（如计算结果错误、状态流转异常）
- 数据丢失或数据不一致

### 性能类
- 页面加载时间超过 5 秒
- 操作响应时间超过 3 秒
- 系统资源占用异常（CPU > 90%、内存溢出）
- 并发场景下系统崩溃或响应显著变慢

### UI 类
- 界面元素错位、重叠、截断
- 字体/颜色/间距与设计稿不符
- 不同浏览器/设备下显示不一致
- 文案错误（错别字、翻译错误）

## 优先级判定规则

### P0 - 紧急（4小时内修复）
- 系统崩溃或无法访问
- 核心业务流程完全阻断（如无法下单、无法登录）
- 数据丢失或数据泄露风险
- 影响全部用户

### P1 - 高（24小时内修复）
- 核心功能异常但有临时替代方案
- 影响大量用户（>50%）的非核心功能问题
- 性能严重劣化（响应时间 > 30秒）

### P2 - 中（当前迭代内修复）
- 非核心功能异常，不影响主流程
- 影响少量用户的偶发问题
- UI 显示问题但不影响功能使用

### P3 - 低（排入后续迭代）
- 文案/拼写错误
- 美观问题（不影响使用）
- 优化建议类

坏的写法（模糊不可执行）：

功能问题就是功能有bug，性能问题就是速度慢，UI问题就是界面不好看。
优先级根据影响程度来定，影响大就高，影响小就低。

5.2 简道云 API 连接

悟帆需要能调用简道云 API 来写回数据。确保悟帆侧已配置简道云连接（API Key），可通过悟帆内置的简道云工具包直接操作。

6. 悟帆侧配置

6.1 创建 Webhook 自动化管道

在悟帆中创建一条 Webhook 触发的自动化管道，用于接收简道云推送的 Bug 数据并自动分析。

管道名称：Bug 自动分类与优先级判定

触发方式：Webhook（创建后系统会返回一个 Webhook URL，将此 URL 填入简道云智能助手的 Webhook 节点）

6.2 任务指令

以下是悟帆自动化管道的完整任务指令，可直接复制使用：

你是一个专业的 QA 工程师，负责对提交的 Bug 进行自动分类和优先级判定。

## 输入数据

- Bug 编号（data_id）：{{payload.data_id}}
- Bug 标题：{{payload.bug_title}}
- Bug 描述：{{payload.bug_desc}}
- 截图 URL：{{payload.screenshot_urls}}
- 简道云 app_id：{{payload.app_id}}
- 简道云 entry_id：{{payload.entry_id}}

## 执行步骤

1. **分析 Bug 文本**
   仔细阅读 Bug 标题和描述，提取关键信息：
   - 问题现象是什么（崩溃/卡死/显示异常/数据错误...）
   - 影响范围（全部用户/部分用户/特定条件触发）
   - 是否有复现步骤
   - 是否涉及核心业务流程

2. **分析截图内容**（如果有截图）
   查看截图，识别：
   - 错误提示信息（如报错弹窗、控制台错误）
   - 界面异常（错位、白屏、加载失败）
   - 性能指标（如加载时间、资源占用）
   - 如果截图无法识别或为空，仅基于文本分析，并在分析说明中注明"截图未能提供有效信息"

3. **判定 Bug 分类**
   根据以下规则判定分类：
   - **功能**：功能无法使用、逻辑错误、数据异常
   - **性能**：响应慢、卡顿、资源占用异常、超时
   - **UI**：界面显示问题、样式异常、文案错误
   - **兼容性**：特定浏览器/设备/系统下的问题
   - **安全**：权限漏洞、数据泄露、注入攻击相关
   - **其他**：无法归入以上类别

   如果一个 Bug 同时涉及多个分类，选择最核心的那个。例如"性能问题导致功能不可用"归为性能类。

4. **判定建议优先级**
   根据以下规则判定优先级：
   - **P0 - 紧急**：系统崩溃、核心流程完全阻断、数据丢失/泄露、影响全部用户
   - **P1 - 高**：核心功能异常（有替代方案）、大量用户受影响、性能严重劣化（>30秒）
   - **P2 - 中**：非核心功能异常、偶发问题、UI 问题不影响使用
   - **P3 - 低**：文案错误、美观问题、优化建议

5. **写回简道云**
   使用简道云工具，调用"修改单条数据"接口，将分析结果写回同一条记录：
   - data_id：{{payload.data_id}}
   - app_id：{{payload.app_id}}
   - entry_id：{{payload.entry_id}}
   - 写入字段：
     - Bug 分类：[判定的分类]
     - 建议优先级：[判定的优先级]
     - AI 分析说明：[2-3句话说明分类和定级的依据，引用具体的文本和截图证据]

## 注意事项

- 如果 Bug 描述过于简略（少于 10 个字）且无截图，分类为"其他"，优先级为"P2 - 中"，并在分析说明中建议补充描述
- 截图分析失败时不要瞎猜，如实说明"截图无法识别"
- AI 分析说明要具体，不要写"根据描述判断"这种废话，要写清楚"因为描述中提到XX，截图显示XX，所以判定为XX"
- 优先级判定宁可偏高不要偏低——漏掉一个 P0 比多报一个 P1 代价大得多

6.3 配置要点

7. 联调测试

8. 踩坑提醒

Q1：Webhook 触发了但悟帆没有响应，怎么排查？

先检查三个环节：

Q2：悟帆的分类结果不太准，经常把功能问题归为 UI 类，怎么改进？

90% 的情况是知识库写得不够具体。排查思路：

Q3：写回简道云时报错"权限不足"或"数据不存在"？

两个常见原因：