---
name: bug-fixer
version: "1.0.0"
category: workflow
description: "当用户报告Bug、错误、功能异常或需要调试时使用。不要用于功能开发或代码重构。Use when user reports bugs, errors, broken functionality, or needs debugging. Do NOT use for feature development or refactoring."
triggers:
  zh: ["修复Bug", "线上问题", "改一下", "报错", "不对", "显示异常", "接口404", "数据不对", "页面空白", "debug", "调试"]
  en: ["fix bug", "bug", "error", "broken", "not working", "debug", "crash"]
license: MIT
compatibility: Node.js >= 18, Java 11+
config: workflow-config.yaml
dependencies: debugging
metadata:
  author: "neuqik@hotmail.com"
  created: "2026-06-16"
  updated: "2026-06-24"
  status: "stable"
---

# Bug修复 / Bug Fixer

## Changelog / 版本履历
| 日期 | 版本 | 变更摘要 |
|------|------|---------|
| 2026-06-16 | 1.0.0 | 规范化调整 |
| 2026-06-24 | 1.1.0 | 重构至LangChain标准，提取前端Bug模式至references |

## Description / 描述
系统化的Bug修复技能，遵循六步流程：精确的Bug定位与假设验证（置信度≥40%）、全面的影响分析（纵向/横向/深度维度）、多方案评估与风险预判、最小范围实施、结构化变更文档、案例归档以持续改进。

## Triggers / 触发词
- English: 'fix bug', 'bug', 'error', 'broken', 'not working', 'debug', 'crash'
- 中文: '修复Bug', '线上问题', '改一下', '报错', '不对', '显示异常', '接口404', '数据不对', '页面空白', 'debug', '调试'

## Capabilities / 能力
- 六步修复SOP - 遵循定位复现、影响分析、精准修复、变更清单、案例归档、复盘优化的完整流程
- 根因假设验证 - 提出Top 3假设并进行置信度评分（≥40%才可采纳）
- 多维度影响分析 - 分析纵向（前后端影响）、横向（模块间影响）、深度（日志/事务影响）、约束（框架约定）
- 多方案评估 - 对比复杂度、兼容性、副作用、可回滚性、测试覆盖等维度
- 最小修改原则 - 严格限定修改范围，只改必要的代码行
- 标准输出格式 - 生成修改文件列表、Diff、部署指引、回滚方案

## Dependencies / 依赖
- debugging - 提供底层调试能力和假设验证方法
- workflow-config.yaml - 配置置信度阈值、影响分析维度、输出格式等参数

## References / 参考资料
- `references/frontend-bug-patterns.md` - 前端常见Bug模式库（CSS选择器不匹配、事件未绑定、多点击累积、图表重叠、抽屉不可见、数据可视化静默失败）

## Usage / 使用方式

### Invocation / 调用方式
通过工作流路由器检测到Bug相关触发词时调用，或通过专家直接调用进行系统化Bug修复。

### Parameters / 参数
| 参数 | 类型 | 必填 | 说明 |
|------|------|------|------|
| bug_description | string | ✅ | Bug描述，包含功能、期望行为、实际行为三要素 |
| error_logs | string | ❌ | 错误日志或堆栈追踪信息 |
| affected_files | array | ❌ | 已知受影响的文件列表 |

### Example / 示例
```
/bug-fixer bug_description="用户登录页面空白，期望显示登录表单，实际显示空白页面"
```

## Output Format / 输出格式
结构化Bug修复报告，包含：Bug分类摘要、根因假设及置信度评分、影响分析矩阵、方案评估对比、已实施变更（Diff格式）、部署指引、回滚方案、归档案例记录。

## Configuration / 配置
技能读取workflow-config.yaml获取Bug修复设置：
- confidence_threshold: number (默认40，假设采纳的最低置信度百分比)
- impact_analysis_dimensions: array (默认["vertical", "horizontal", "depth", "constraints"])
- max_solution_candidates: number (默认3)

## Workflow / 工作流程
1. **定位与复现** - 提取Bug分类要素，定位涉及文件，提出并验证根因假设
2. **影响分析** - 分析纵向（前后端）、横向（跨模块）、深度（日志/事务）、约束（框架）影响
3. **精准修复** - 设计2-3候选方案，全面评估，选择最优方案，严格范围内实施
4. **变更清单** - 生成修改文件列表、Diff、部署指引和回滚方案
5. **案例归档** - 记录case_id、根因分析、解决方案、失败尝试、经验教训
6. **复盘优化** - 每修复5个Bug后分析准确率、尝试次数、高频根因、低效模式

## Auto-Review / 自检清单
| # | 检查项 |
|---|--------|
| 1 | 根因假设置信度是否≥40% |
| 2 | 是否完成多维度影响分析 |
| 3 | 是否提供多个候选方案并进行评估 |
| 4 | 修复范围是否严格限定在必要范围内 |
| 5 | 是否输出标准格式的变更清单 |
| 6 | 是否完成案例归档 |
| 7 | 修复是否不包含新功能添加 |

> Adapted from expert-bug-fixer v2.1 by wonderslife/pdd-skills-v3

## Core Concept / 核心概念

六大核心原则 / Six Core Principles:

| 原则 | 说明 |
|------|------|
| **精准定位** | 系统化排查，非盲目猜测 |
| **假设验证** | 每个根因假设必须经过验证（置信度<40%禁止采纳） |
| **影响控制** | 严格限定修改范围，不扩散 |
| **风险预判** | 多方案量化评估，选最优 |
| **最小修改** | 只改必要的行，不重写文件 |
| **标准输出** | 修复代码变更 + 影响范围声明 |

## Iron Law / 核心铁律

1. **影响声明先行** - 修改前必须输出影响范围
2. **假设必须验证** - 禁止基于未验证假设修复
3. **修复不扩张** - 范围严格限定于消除Bug本身
4. **Diff不重写** - 代码变更必须Diff格式
5. **案例必归档** - 每次修复必须记录

## Guardrails / 安全护栏

- [ ] 修改前必须输出影响范围声明
- [ ] 禁止在Bug修复中添加新功能
- [ ] 修改涉及3+文件时提醒先测试环境验证
- [ ] 每个根因假设必须经过验证（置信度<40%禁止采纳）
- [ ] 修复完成后必须对照checklist自检