# Bug Fix Strategy

> Bug最短路径修复策略。所有Bug修复必须先走本策略，按优先级依次尝试，禁止跳级。同一Bug重复≥2次才进入重构评估。

- Skill: `xu-jin-cs/bug-fix-strategy` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add xu-jin-cs/bug-fix-strategy`
- Raw SKILL.md: https://api.skillmd.com/api/skills/xu-jin-cs/bug-fix-strategy/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: xu-jin-cs (https://skillmd.com/u/xu-jin-cs)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/xu-jin-cs/bug-fix-strategy

---

# Bug最短路径修复策略

## 核心原则
能改配置就不改代码，能调参数就不改逻辑，能改交互就不动业务，能改调用就不重构。

## 修复优先级（按序，不得跳级）

> **修复级别判定禁止手写（2026-08-15 裁定，gate-switch 机械门禁）：每次修复动作前扳动 `python3 ~/.agents/skills/bug_fix_gate/scripts/gate_switch.py --spec ~/.agents/skills/bug_fix_gate/scripts/specs/bug_fix_gate.json --set bug_id=<id> --set level=<N>`，判 A 才许动手；判 B 照抄理由（重复次数不足/需用户确认/跳级）。**

**第一优先：配置/参数调整**
超时/端口/路径/开关/环境变量 → 解决则止步

**第二优先：交互逻辑调整**
操作顺序/事件时机/状态判断条件 → 解决则止步

**第三优先：逻辑修改**
计算错误/业务规则/数据转换 → 解决则止步

**第四优先：方法调用调整**
参数传错/调用错误方法/返回值处理 → 解决则止步

**第五优先：重构评估（仅限重复Bug≥2次）**
≤3文件 → 直接重构
>3文件 → 向用户确认后执行

重构前必须输出方案：当前问题 / 新结构 / 改动文件清单 / 执行顺序 / 验证方式

## 禁止行为
- 禁止跳级
- 单次Bug禁止重构
- 无方案不得重构
- >3文件未确认不得执行