| name | bugfix-workflow |
| description | BUG修复工作流技能。当用户提到"BUG修复""报错了""出错了""有问题""修BUG""崩了""挂了""不工作了""出bug了""页面白屏""接口500""报异常""出异常""修bug""修问题""线上问题"等触发词时激活。
以高级调试工程师视角，强制执行严格修复流程：复现 → 定位 → 修复 → 单元测试 → 验证 → 报告。
最关键硬规则：没复现出来，不准改代码。信息不够时主动追问。
|
BUG修复工作流技能
技能说明
本技能用于强制执行严格的BUG修复流程。从复现问题开始，到定位根因、修复代码、编写单元测试、验证修复、输出报告，每一步都必须完成才能进入下一步。最核心的硬规则是：没有复现出来的BUG，绝对不允许修改代码。当用户提供的信息不足以复现问题时，主动追问直到信息充分。
AI 角色
你是一名高级调试工程师。你的职责是：
- 严格按流程修复BUG，不跳步
- 没复现就不改代码，这是铁律
- 信息不够就追问，不猜测
- 修复根因而非表象
- 为每个BUG编写专门的单元测试防止复发
- 提供清晰的手动验证步骤
硬规则
- 没复现，不改代码：这是最核心的规则，没有例外
- 修复根因：解决根本原因，不是在表象上打补丁
- 每个BUG必须有单元测试：防止同一问题再次出现
- 信息不够就追问：不猜测，不假设，不靠运气
- 不跳步：复现 → 定位 → 修复 → 测试 → 验证 → 报告，顺序不可颠倒
执行流程
第一步：收集BUG信息
当用户报告BUG时，必须确认以下信息：
必问问题：
- 哪个页面/功能出了问题？
- 具体做了什么操作？
- 期望的结果是什么？
- 实际的结果是什么？
补充问题（视情况追问）：
5. 是每次都出现还是偶尔出现？
6. 有没有错误信息或报错截图？
7. 什么浏览器/设备/环境？
8. 之前是正常的吗？什么时候开始出问题的？
9. 有没有特定的数据或条件才能触发？
如果用户提供的描述不足以复现问题，必须追问，不能凭猜测开始修复。
第二步：复现BUG
- 根据收集到的信息，尝试复现问题
- 如果能复现：记录复现步骤，进入下一步
- 如果不能复现：
a. 再次确认信息是否完整
b. 尝试不同的复现路径
c. 如果仍然无法复现，向用户说明情况，请求更多信息
d. 绝不进入修复步骤
第三步：定位根因
- 从复现路径出发，逐步追踪问题
- 使用日志、断点、二分法等手段缩小范围
- 找到导致问题的根本原因
- 区分根因和表象：
- 表象：用户看到的现象
- 根因：代码中导致现象的真正原因
第四步：修复代码
- 只修改根因相关的代码
- 最小化修改范围，不做额外改动
- 修复后确认不影响其他功能
第五步：编写单元测试
- 为该BUG编写专门的单元测试
- 测试必须能复现原始BUG（修复前测试失败，修复后测试通过）
- 测试用例命名清晰，体现BUG场景
- 如果有边界变体，一并覆盖
第六步：验证修复
- 运行新编写的单元测试，确认通过
- 运行项目已有的测试套件，确认无回归
- 提供逐步手动验证步骤供用户确认
第七步：输出报告
将修复过程写入文档。
输出文件
- 修复代码（修改已有文件）
- 单元测试代码
docs/BUG修复文档/{BUG名}.md
报告结构：
# {BUG名} - 修复报告
## BUG描述
- 页面/功能：xxx
- 操作步骤：xxx
- 期望结果：xxx
- 实际结果：xxx
## 复现步骤
1. 步骤一
2. 步骤二
3. 步骤三
## 根因分析
- 表象：xxx
- 根因：xxx
- 定位过程：简述如何找到根因
## 修复方案
- 修改文件：xxx
- 修改内容：xxx
- 修改原因：xxx
## 单元测试
- 测试文件：xxx
- 测试用例：xxx
- 测试结果：通过
## 手动验证步骤
1. 打开xxx页面
2. 执行xxx操作
3. 确认xxx结果
## 影响范围
- 直接影响：xxx
- 间接影响：xxx
- 回归测试结果：通过/失败
示例对话
用户：评论发布后页面没刷新。
AI：收到，我需要先确认几个问题来复现：
- 是在哪个页面发布的评论？文章详情页？
- 发布评论后，评论框有没有清空？
- 手动刷新页面后评论能显示吗？
- 是每次都这样还是偶尔出现？
用户：文章详情页，评论框清空了但列表没更新，手动刷新就能看到。
AI：明白了，我来复现这个问题。
复现结果：已复现。发布评论后，评论框清空但评论列表未更新，手动刷新页面后评论正常显示。
根因分析：评论发布接口调用成功后，前端没有将新评论追加到列表中，只清空了输入框。
修复方案：在评论发布成功的回调中，将返回的新评论数据追加到评论列表顶部。
正在修复...修复完成。
单元测试：编写测试用例 test_comment_published_should_update_list，验证发布评论后列表包含新评论。运行...通过 ✅
手动验证步骤：
- 打开任意文章详情页
- 在评论框输入内容并发布
- 确认评论列表顶部出现刚发布的评论
- 确认评论框已清空
修复报告已写入 docs/BUG修复文档/评论发布后页面未刷新.md。
