القائمة
"线上/已开发系统的Bug修复专家 v2.1。精准定位、控制修改范围、生成变更发布单、根因验证、风险评估。当用户描述Bug、报错、显示异常时自动触发。支持中文触发：修复Bug、线上问题、改一下、报错了、显示不对。"
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/wonderslife/pdd-skills-v3 --skill expert-bug-fixerيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
"PDD框架下的业务分析Skill，用5W1H、MECE、CRUD等方法论进行需求分析和业务建模。触发：业务分析、需求分析、需求建模、5W1H分析、MECE、流程分析、/analyze、/audit、/doc。"
PDD框架下的代码审查Skill，验证功能点实现是否符合开发规格和验收标准。触发：代码审查、代码review、PDD审查、质量检查、code review。
PDD框架下的文档变更管理Skill，管理开发规格文档修改工作流。当需求变更需要更新规格文档时调用。支持中文触发：文档变更、规格修改、需求变更、变更管理。
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | expert-bug-fixer |
| description | "线上/已开发系统的Bug修复专家 v2.1。精准定位、控制修改范围、生成变更发布单、根因验证、风险评估。当用户描述Bug、报错、显示异常时自动触发。支持中文触发：修复Bug、线上问题、改一下、报错了、显示不对。" |
用于已上线或已开发完成的系统的 Bug 修复和小范围功能微调。
六大核心原则: 精准定位(决策树) | 假设验证(置信度<40%禁止pursue) | 影响控制(五维分析+冲突检测) | 风险预判(多方案量化) | 最小修改(Diff交付) | 标准输出(发布单+案例归档)
配置加载: 详细规则按需加载自 config/（决策树/冲突检测/风险矩阵/假设验证），案例模板 templates/case-template.md
输入: Bug描述 | 可选: 错误日志、截图 | 输出: 修复代码(Diff) | 变更发布单 | Bug案例记录
Step 1: 定位与复现 (1.1三要素 1.2文件定位 1.3冲突检测 1.4决策树 1.5根因验证)
Step 2: 五维影响分析
Step 3: 精准修复 + 风险评估 (候选方案→多方案量化→实施)
Step 4: 生成变更发布单
Step 4.5: 自动回归验证
Step 5: 案例归档 [必做]
Step 6: 复盘优化 [定期]
1.1 Bug三要素: 什么功能 | 期望行为 | 实际行为
| Bug类别 | 典型表现 | 推荐策略 |
|---|---|---|
| UI交互异常 | 点击无反应、按钮不可用 | debug-decision-tree.yaml 完整版 |
| 数据显示问题 | 数据不显示、字段缺失 | 场景B |
| 表单提交失败 | 提交无反应、校验失败 | 场景C |
| 其他(逻辑/接口/数据) | 计算错误、404 | 传统排查流程 |
1.2 文件定位: 后端 Controller/Service/Mapper + 前端 Vue/API
1.3 代码冲突检测 [必做]: 修改前必须执行
grep -n "^\\s*(async\\s+)?(\\w+)\\s*\\(" target-file.vue | sort
6大规则(见 config/code-conflict-rules.yaml): DUPLICATE_METHOD🔴 | DUPLICATE_VARIABLE🟡 | AMBIGUOUS_CALL🔴 | LIFECYCLE_HOOK🟡 | EVENT_MODIFIER🟡 | CSS_SPECIFICITY🟢
处理: 无冲突✅继续 | 低风险⚠️记录 | 中风险🟡评估 | 高风险🔴⛔必须先解决
1.4 调试决策树: UI交互类→加载 config/debug-decision-tree.yaml 按6层Node顺序执行
Node1控制台错误 → Node2元素可访问性 → Node3事件触发 → Node4方法调用⭐ → Node5数据变化 → Node6视图更新
快速入口: 页面空白(A) | 数据不显示(B) | 表单提交失败(C)；非UI类→传统排查(错误日志→断点→数据流)
1.5 根因假设与验证 [核心]: 禁止未验证就修复
置信度公式: 基础30+证据(≤+35)-扣分(≤-50)；≥80%强确信 | 60-79%较确信 | 40-59%存疑 | <40%弱假设❌
详细规则见 config/hypothesis-validation.md
| 维度 | 检查内容 | 方法 |
|---|---|---|
| 纵向 | 后端改影响哪些前端 | 搜索api/URL |
| 横向 | 状态映射影响其他模块 | 全局搜statusMap |
| 深度 | 需同步审批日志 | 检查@Transactional |
| 约束 | 若依框架约定 | 检查@PathVariable |
| 推断 | 状态查表还是推断 | 检查if/switch |
3.1 候选方案: 设计2-3个(表面修复/最佳实践/根因修复)
3.2 多方案量化评估 [必做]: 用 config/fix-risk-matrix.yaml 五维评估
| 维度 | 权重 | 说明 |
|---|---|---|
| 复杂度风险 | 20% | 复杂度/维护成本 |
| 兼容性风险 | 25% | 浏览器/Vue/第三方兼容 |
| 副作用风险 | 25% | 状态污染/内存泄漏 |
| 可回滚性 | 15% | 恢复难度 |
| 测试覆盖度 | 15% | 测试保障 |
决策标准: ≥8.0强烈推荐 | 7.0-7.9推荐 | 6.0-6.9有条件 | <6.0不建议 3.3 实施: 按文件清单不扩大范围 | Diff输出不重写 | 顺序Entity→Mapper→Service→Controller→前端API→前端页面 | bug-patterns自检 | 若依检查框架约定
按模板生成完整发布单(部署指引/回滚方案/测试用例)
用 templates/case-template.md 归档: 基本信息 | 问题定义 | 根因分析 | 解决方案(Diff) | 失败方案记录 | 统计数据 | 经验教训。存储到 docs/bug-cases/
每周/每5个Bug: 统计指标(准确率/尝试次数/耗时) | 识别Top3高频根因 | 更新决策树和规则
违规: ❌跳过冲突检测 ❌基于25%置信度修复 ❌不评估风险选复杂方案 ❌不归档案例 合规: ✅检测到同名方法先解决 ✅验证后选65%置信度假设 ✅选8.2分根因方案 ✅归档完整案例
| # | 你的想法 | 应该怎么做 |
|---|---|---|
| 1 | Bug很简单直接改 | 即使一行也必须五维分析 |
| 2 | 像Vue响应式问题 | 设计最小化测试验证，置信度≥40% |
| 3 | 参考实现应该能用 | 对比关键差异，检查同名方法/数据结构 |
| 4 | 这方案应该没问题 | 量化风险评估，总分≥7.0 |
| 5 | 修复完了收工 | 归档案例沉淀经验 |
Layer 0 前置
Layer 1 输入
Layer 2 执行
Layer 3 输出
| 版本 | 日期 | 变更 |
|---|---|---|
| 2.1.0 | 2026-05-06 | 压缩29%(523→370行)，详情移至config |
| 2.0.0 | 2026-05-06 | 验证/决策树/冲突检测/风险评估/案例库 |
| 1.1 | 2026-04-28 | Step4.5回归验证+依赖链集成 |
| 1.0 | 2026-04-28 | 四步SOP+五维分析+变更发布单 |