# Debug

> 当用户遇到复杂 bug、问题反复出现、找不到原因时使用 — 用科学方法逐步排查，禁止猜测性修复

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

---


# 系统化调试

用科学方法排查问题，不要猜、不要碰运气。每一步都要有证据支撑。

## 核心原则

- 禁止「改一下试试看」— 每次修改必须基于明确的假设
- 禁止跳步 — 必须按顺序执行每个步骤
- 记录每一步的发现 — 避免兜圈子

## 步骤

### 1. 理解问题

询问用户：
> 遇到了什么问题？可以描述现象、贴报错信息、或者告诉我哪个功能不正常。

收集信息：
- 错误信息（完整的报错日志或截图）
- 什么时候开始出现的
- 之前做了什么改动
- 期望的行为是什么

### 2. 复现问题

- 找到相关的代码文件，阅读并理解上下文
- 尝试复现问题（运行代码、运行测试）
- 确认问题确实存在，记录复现步骤

如果无法复现，告诉用户并请求更多信息。不要在无法复现的情况下猜测修复。

### 3. 定位根因

- 根据错误信息和代码逻辑，提出假设
- 用最小范围的验证来确认或排除假设（加日志、断点、单元测试）
- 如果第一个假设不成立，记录原因，提出下一个假设
- 缩小范围直到找到根因

记录格式：
```
假设 1：xxx
验证：xxx
结果：确认 / 排除（原因：xxx）
```

### 4. 修复

- 用最小改动修复问题
- 解释改了什么、为什么这样改
- 运行测试确认修复有效
- 检查修复是否可能引入新问题

### 5. 验证

- 重新运行复现步骤，确认问题已解决
- 运行完整测试套件，确认没有破坏其他功能
- 告诉用户修复完成，总结根因和修复方案