"线上/已开发系统的Bug修复专家 v2.1（精简版）。精准定位、控制修改范围、生成变更发布单、根因验证、风险评估。当用户描述Bug、报错、显示异常时自动触发。支持中文触发：修复Bug、线上问题、改一下、报错了、显示不对。"
"线上/已开发系统的Bug修复专家 v2.1（精简版）。精准定位、控制修改范围、生成变更发布单、根因验证、风险评估。当用户描述Bug、报错、显示异常时自动触发。支持中文触发：修复Bug、线上问题、改一下、报错了、显示不对。"
npx skills add https://github.com/wonderslife/pdd-skills-v3 --skill expert-bug-fixer이 명령을 Claude Code에 복사하여 붙여넣어 스킬을 설치하세요
| name | expert-bug-fixer |
| description | "线上/已开发系统的Bug修复专家 v2.1（精简版）。精准定位、控制修改范围、生成变更发布单、根因验证、风险评估。当用户描述Bug、报错、显示异常时自动触发。支持中文触发：修复Bug、线上问题、改一下、报错了、显示不对。" |
v2.1核心改进: 在v2.0全部功能基础上，将SKILL.md从523行精简至370行，详细示例移至config目录按需加载，减少上下文占用。
配置文件结构:
expert-bug-fixer/
├── SKILL.md (本文件 - 精简版流程指引)
├── config/
│ ├── debug-decision-tree.yaml # UI交互Bug调试决策树(6层节点)
│ ├── code-conflict-rules.yaml # 代码冲突检测规则(6大规则)
│ ├── fix-risk-matrix.yaml # 修复方案风险评估矩阵(5维)
│ └── hypothesis-validation.md # 根因假设验证指南(详细示例)
└── templates/
└── case-template.md # Bug案例记录模板
本技能用于已上线或已开发完成的系统的 Bug 修复和小范围功能微调。
六大核心原则:
输入: Bug描述 | 可选: 错误日志、截图
输出: 修复代码(Diff) | 变更发布单 | Bug案例记录
Step 1: 定位与复现
├─ 1.1 Bug三要素提取
├─ 1.2 涉及文件定位
├─ 1.3 🔥 代码冲突检测 [必做]
├─ 1.4 🔥 调试决策树选择 [UI交互类必用]
└─ 1.5 🔥 根因假设与验证 [必做]
│
Step 2: 五维影响分析
│
Step 3: 精准修复 + 风险评估
├─ 3.1 设计候选方案(2-3个)
├─ 3.2 🔥 多方案对比评估 [必做]
└─ 3.3 实施最优方案
│
Step 4: 生成变更发布单
Step 4.5: 自动回归验证
Step 5: 🔥 案例归档 [必做]
Step 6: 🔥 复盘优化 [定期]
Bug定位三要素:
什么功能: [模块名/页面名/接口名]
期望行为: [用户期望看到什么]
实际行为: [实际发生了什么]
Bug类别与策略映射:
| Bug类别 | 典型表现 | 推荐策略 |
|---|---|---|
| UI交互异常 | 点击无反应、按钮不可用 | debug-decision-tree.yaml 完整版 |
| 数据显示问题 | 数据不显示、字段缺失 | debug-decision-tree.yaml 场景B |
| 表单提交失败 | 提交无反应、校验失败 | debug-decision-tree.yaml 场景C |
| 其他(逻辑/接口/数据) | 计算错误、404等 | 传统排查流程 |
定位涉及的代码文件（后端 Controller/Service/Mapper + 前端 Vue/API）
触发条件: 每次修改前必须执行
执行方法:
grep -n "^\s*(async\s+)?(\w+)\s*\(" target-file.vue | sort
6大检测规则（详见 config/code-conflict-rules.yaml）:
| 规则 | 目标 | 级别 | 说明 |
|---|---|---|---|
| DUPLICATE_METHOD | 同名方法 | 🔴高 | JS后定义覆盖先定义 |
| DUPLICATE_VARIABLE | 同名变量 | 🟡中 | Vue优先级覆盖 |
| AMBIGUOUS_CALL | 歧义调用 | 🔴高 | v-for参数传递错误 |
| LIFECYCLE_HOOK | 重复钩子 | 🟡中 | 后者覆盖前者 |
| EVENT_MODIFIER | 修饰符误用 | 🟡中 | .native/.stop误用 |
| CSS_SPECIFICITY | CSS冲突 | 🟢低 | 样式被意外覆盖 |
处理规则:
UI交互类Bug → 加载 config/debug-decision-tree.yaml，按6层Node顺序执行：
Node 1: 控制台错误检查 → Node 2: 元素可访问性 → Node 3: 事件触发验证
→ Node 4: 方法调用验证⭐ → Node 5: 数据变化 → Node 6: 视图更新
特殊场景快速入口: 页面空白(场景A) | 数据不显示(场景B) | 表单提交失败(场景C)
非UI交互类Bug → 传统排查：错误日志→断点调试→数据流追踪
原则: ❌ 禁止未经验证就实施修复
流程:
置信度速算公式:
基础分30 + 证据加分(最多+35) - 扣分(最多-50)
评级: ≥80%强确信 | 60-79%较确信 | 40-59%存疑 | <40%弱假设❌
📖 详细评分规则和验证示例 → 见 config/hypothesis-validation.md
动代码前必须构建"影响范围声明"：
| 维度 | 检查内容 | 方法 |
|---|---|---|
| 纵向 | 后端修改影响哪些前端文件 | 搜索api/目录URL |
| 横向 | 状态映射是否影响其他模块 | 全局搜索statusMap |
| 深度 | 是否需同步审批日志 | 检查@Transactional |
| 约束 | 是否涉及若依框架约定 | 检查@PathVariable等 |
| 推断 | 状态来源是查表还是推断 | 检查if/switch |
工具辅助:
pdd deps impact <file>可自动生成
基于根因设计2-3个方案（如：表面修复/最佳实践/根因修复）
使用 config/fix-risk-matrix.yaml 进行5维量化评估：
| 维度 | 权重 | 说明 |
|---|---|---|
| 复杂度风险 | 20% | 代码复杂度和维护成本 |
| 兼容性风险 | 25% | 浏览器/Vue/第三方库兼容性 |
| 副作用风险 | 25% | 状态污染/DOM泄漏/内存泄漏 |
| 可回滚性 | 15% | 失败时恢复难度 |
| 测试覆盖度 | 15% | 测试保障充分性 |
决策标准: ≥8.0强烈推荐 | 7.0-7.9推荐 | 6.0-6.9有条件 | <6.0不建议
严格遵循:
按模板生成完整变更发布单（含部署指引、回滚方案、测试用例）
建议自动触发回归验证
每次修复完成后必须执行
使用 templates/case-template.md 归档以下内容：
存储位置: docs/bug-cases/ 目录
每周或每5个Bug后执行一次复盘：
典型违规: ❌跳过冲突检测 | ❌基于25%置信度修复 | ❌不评估风险选复杂方案 | ❌不归档案例
合规示例: ✅检测到同名方法先解决 | ✅验证后选择65%置信度假设 | ✅选8.2分根因修复方案 | ✅归档完整案例
| # | 你的想法 | 应该怎么做 | v2.1检查项 |
|---|---|---|---|
| 1 | "这个Bug很简单直接改" | 即使一行也必须五维分析 | 是否执行了冲突检测？ |
| 2 | "像Vue响应式问题" | 设计最小化测试验证 | 置信度≥40%吗？ |
| 3 | "参考实现应该能用" | 对比关键差异点 | 检查同名方法和数据结构？ |
| 4 | "这方案应该没问题" | 量化风险评估 | 总分≥7.0？无高风险项？ |
| 5 | "修复完了收工" | 归档案例沉淀经验 | 填写了case-template必填项？ |
| 版本 | 日期 | 变更 |
|---|---|---|
| 2.1.0 | 2026-05-06 | 质量优化: 压缩29%(523→370行)，详情移至config按需加载 |
| 2.0.0 | 2026-05-06 | 重大升级: Phase1+Phase2全量改进（验证/决策树/冲突检测/风险评估/案例库） |
| 1.1 | 2026-04-28 | 新增Step 4.5回归验证+依赖链引擎集成 |
| 1.0 | 2026-04-28 | 初始版本: 四步SOP+五维分析+变更发布单 |
技能文档结束
expert-bug-fixer v2.1 - 精简高效的智能化Bug修复专家 详细示例见config/目录，持续迭代优化中
自动化测试执行专家 - 读取YAML测试用例，通过Chrome DevTools MCP执行E2E测试，生成专业HTML报告。当用户需要执行测试、运行测试、回放测试时调用此技能。支持中文触发：执行测试、运行测试、回放测试、跑一下这个yaml、重放刚才的测试、开始自动化、执行测试用例、运行yaml文件、单步调试、带截图执行、生成测试报告、批量执行测试、并行测试、E2E执行、浏览器自动化执行。
测试用例建模师 - 将自然语言描述或页面操作录制转换为结构化YAML测试用例。当用户需要生成测试用例、录制操作流程、创建E2E测试时调用此技能。支持中文触发：写个测试用例、生成测试用例、帮我录个操作、录制测试流程、把这个操作记下来、测试一下功能、帮我验证流程、零基础写测试、自然语言转测试、回归测试、冒烟测试、UI自动化、E2E自动化、验收测试、场景测试、浏览器测试。
"PDD Visual Manager 可视化监控技能。当用户需要查看项目状态、启动Dashboard、使用TUI终端界面、监控流水线进度、查看质量评分、导出项目数据时自动触发。支持中文触发：可视化监控、Dashboard、看板、TUI、项目状态、流水线、质量评分、pdd vm。"
交通事故责任评估与判定专业技能。当用户需要交通事故责任分析、事故现场照片评估、交通法规咨询、事故责任划分、法律依据查询时触发此技能。适用于车辆碰撞事故、行人事故、非机动车事故等各类道路交通事故的责任认定场景。无论用户使用"交通事故"、"车祸"、"责任判定"、"交通法规"、"事故定责"等何种表述，只要涉及交通事故评估或责任认定，均应调用此技能。
若依(RuoYi)框架权限配置专家，专注于权限问题的诊断和解决。当用户遇到以下问题时自动触发： - 权限校验失败、Access Denied错误 - 按钮/菜单不显示 - @PreAuthorize权限标识不匹配 - v-hasPermi权限值错误 - sys_menu或sys_role_menu配置问题 - 若依框架的权限系统相关问题 - 开发新功能时的权限配置指导 使用此skill可以帮助用户快速定位权限问题根源，提供标准化的权限配置方案。
"Spring Cloud 微服务架构专家。当项目涉及服务注册与发现、配置中心、网关路由、熔断降级、链路追踪等微服务组件时自动触发。支持中文触发：微服务、网关配置、服务注册、熔断器、链路追踪。"