debug

分类: 开发与编程 | 上传者: pproenca | 下载: 0 | 版本: v1.0（最新）

用于查找和修复错误（以前称为调试）的综合调试方法。在调试代码、调查错误、排除问题、执行根本原因分析或响应事件时应使用此技能。涵盖系统再现、假设驱动的调查和根本原因分析技术。当遇到异常、堆栈跟踪、崩溃、段错误、未定义的行为或错误报告需要调查时使用。

更新日志: Source: GitHub https://github.com/pproenca/dot-skills

目录结构

当前层级: tree/master/skills/.curated/debug/

📁 assets/
- 📁 templates/
  - 📄 _template.md 594 B
📁 references/
- 📄 _sections.md 2.4 KB
- 📄 anti-blame-tool.md 2.5 KB
- 📄 anti-debug-fatigue.md 2.5 KB
- 📄 anti-quick-patch.md 2.8 KB
- 📄 anti-shotgun-debugging.md 2.4 KB
- 📄 anti-tunnel-vision.md 2.4 KB
- 📄 hypo-binary-search.md 2.7 KB
- 📄 hypo-one-change-at-time.md 2.7 KB
- 📄 hypo-rubber-duck.md 2.5 KB
- 📄 hypo-rule-out-obvious.md 2.2 KB
- 📄 hypo-scientific-method.md 2.5 KB
- 📄 hypo-where-not-what.md 2.7 KB
- 📄 obs-breakpoint-strategy.md 2.5 KB
- 📄 obs-log-inputs-outputs.md 2.7 KB
- 📄 obs-stack-trace-reading.md 2.8 KB
- 📄 obs-strategic-logging.md 2.8 KB
- 📄 obs-trace-data-flow.md 2.5 KB
- 📄 obs-watch-expressions.md 2.5 KB
- 📄 pattern-async-await-errors.md 2.5 KB
- 📄 pattern-memory-leak.md 2.2 KB
- 📄 pattern-null-pointer.md 1.8 KB
- 📄 pattern-off-by-one.md 1.8 KB
- 📄 pattern-race-condition.md 1.7 KB
- 📄 pattern-timezone-issues.md 2.1 KB
- 📄 pattern-type-coercion.md 2.0 KB
- 📄 prev-defensive-coding.md 3.2 KB
- 📄 prev-document-solution.md 2.5 KB
- 📄 prev-improve-error-messages.md 2.8 KB
- 📄 prev-postmortem.md 2.8 KB
- 📄 prob-document-symptoms.md 1.9 KB
- 📄 prob-minimal-reproduction.md 2.2 KB
- 📄 prob-recent-changes.md 2.1 KB
- 📄 prob-reproduce-before-debug.md 1.9 KB
- 📄 prob-separate-symptoms-causes.md 2.3 KB
- 📄 prob-state-expected-actual.md 2.3 KB
- 📄 rca-examine-boundaries.md 4.4 KB
- 📄 rca-fault-propagation.md 2.9 KB
- 📄 rca-five-whys.md 2.2 KB
- 📄 rca-last-known-good.md 2.3 KB
- 📄 rca-question-assumptions.md 2.5 KB
- 📄 tool-call-stack-navigation.md 2.7 KB
- 📄 tool-conditional-breakpoints.md 2.3 KB
- 📄 tool-exception-breakpoints.md 2.3 KB
- 📄 tool-logpoints.md 2.4 KB
- 📄 tool-memory-inspection.md 2.4 KB
- 📄 tool-step-commands.md 2.6 KB
- 📄 triage-duplicate-detection.md 1.8 KB
- 📄 triage-quick-wins-first.md 1.7 KB
- 📄 triage-reproducibility-matters.md 2.0 KB
- 📄 triage-severity-vs-priority.md 1.8 KB
- 📄 triage-user-impact-assessment.md 1.8 KB
- 📄 verify-add-test.md 2.8 KB
- 📄 verify-regression-check.md 2.4 KB
- 📄 verify-reproduce-fix.md 2.0 KB
- 📄 verify-understand-why-fix-works.md 2.4 KB
📄 AGENTS.md 11.5 KB
📄 metadata.json 1.0 KB
📄 README.md 5.7 KB
📄 SKILL.md 5.7 KB

SKILL.md

---
name: debug
description: Comprehensive debugging methodology for finding and fixing bugs (formerly debugging). This skill should be used when debugging code, investigating errors, troubleshooting issues, performing root cause analysis, or responding to incidents. Covers systematic reproduction, hypothesis-driven investigation, and root cause analysis techniques. Use when encountering exceptions, stack traces, crashes, segfaults, undefined behavior, or when bug reports need investigation.
---

# dot-skills Debugging Best Practices

Comprehensive debugging methodology guide for software engineers, containing 54 rules across 10 categories prioritized by impact. Based on research from Andreas Zeller's "Why Programs Fail" and academic debugging curricula.

## When to Apply

Reference these guidelines when:
- Investigating a bug or unexpected behavior
- Debugging code during development
- Code produces wrong results or crashes
- Performance issues need root cause analysis
- Triaging incoming bug reports and prioritizing fixes
- Conducting root cause analysis for incidents
- Reviewing debugging approaches or code for common bug patterns

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Problem Definition | CRITICAL | `prob-` |
| 2 | Hypothesis-Driven Search | CRITICAL | `hypo-` |
| 3 | Observation Techniques | HIGH | `obs-` |
| 4 | Root Cause Analysis | HIGH | `rca-` |
| 5 | Tool Mastery | MEDIUM-HIGH | `tool-` |
| 6 | Bug Triage and Classification | MEDIUM | `triage-` |
| 7 | Common Bug Patterns | MEDIUM | `pattern-` |
| 8 | Fix Verification | MEDIUM | `verify-` |
| 9 | Anti-Patterns | MEDIUM | `anti-` |
| 10 | Prevention & Learning | LOW-MEDIUM | `prev-` |

## Quick Reference

### 1. Problem Definition (CRITICAL)

- `prob-reproduce-before-debug` - Reproduce the bug before investigating
- `prob-minimal-reproduction` - Create minimal reproduction cases
- `prob-document-symptoms` - Document symptoms precisely
- `prob-separate-symptoms-causes` - Separate symptoms from causes
- `prob-state-expected-actual` - State expected vs actual behavior
- `prob-recent-changes` - Check recent changes first

### 2. Hypothesis-Driven Search (CRITICAL)

- `hypo-scientific-method` - Apply the scientific method
- `hypo-binary-search` - Use binary search to localize bugs
- `hypo-one-change-at-time` - Test one hypothesis at a time
- `hypo-where-not-what` - Find WHERE before asking WHAT
- `hypo-rule-out-obvious` - Rule out obvious causes first
- `hypo-rubber-duck` - Explain the problem aloud

### 3. Observation Techniques (HIGH)

- `obs-strategic-logging` - Use strategic logging
- `obs-log-inputs-outputs` - Log function inputs and outputs
- `obs-breakpoint-strategy` - Use breakpoints strategically
- `obs-stack-trace-reading` - Read stack traces bottom to top
- `obs-watch-expressions` - Use watch expressions for state
- `obs-trace-data-flow` - Trace data flow through system

### 4. Root Cause Analysis (HIGH)

- `rca-five-whys` - Use the 5 Whys technique
- `rca-fault-propagation` - Trace fault propagation chains
- `rca-last-known-good` - Find the last known good state
- `rca-question-assumptions` - Question your assumptions
- `rca-examine-boundaries` - Examine system boundaries

### 5. Tool Mastery (MEDIUM-HIGH)

- `tool-conditional-breakpoints` - Use conditional breakpoints
- `tool-logpoints` - Use logpoints instead of modifying code
- `tool-step-commands` - Master step over/into/out
- `tool-call-stack-navigation` - Navigate the call stack
- `tool-memory-inspection` - Inspect memory and object state
- `tool-exception-breakpoints` - Use exception breakpoints

### 6. Bug Triage and Classification (MEDIUM)

- `triage-severity-vs-priority` - Separate severity from priority
- `triage-user-impact-assessment` - Assess user impact before prioritizing
- `triage-reproducibility-matters` - Factor reproducibility into triage
- `triage-quick-wins-first` - Identify and ship quick wins first
- `triage-duplicate-detection` - Detect and link duplicate bug reports

### 7. Common Bug Patterns (MEDIUM)

- `pattern-null-pointer` - Recognize null pointer patterns
- `pattern-off-by-one` - Spot off-by-one errors
- `pattern-race-condition` - Identify race condition symptoms
- `pattern-memory-leak` - Detect memory leak patterns
- `pattern-type-coercion` - Watch for type coercion bugs
- `pattern-async-await-errors` - Catch async/await error handling mistakes
- `pattern-timezone-issues` - Recognize timezone and date bugs

### 8. Fix Verification (MEDIUM)

- `verify-reproduce-fix` - Verify with original reproduction
- `verify-regression-check` - Check for regressions
- `verify-understand-why-fix-works` - Understand why fix works
- `verify-add-test` - Add test to prevent recurrence

### 9. Anti-Patterns (MEDIUM)

- `anti-shotgun-debugging` - Avoid shotgun debugging
- `anti-quick-patch` - Avoid quick patches without understanding
- `anti-tunnel-vision` - Avoid tunnel vision on initial hypothesis
- `anti-debug-fatigue` - Recognize debugging fatigue
- `anti-blame-tool` - Don't blame the tool too quickly

### 10. Prevention & Learning (LOW-MEDIUM)

- `prev-document-solution` - Document bug solutions
- `prev-postmortem` - Conduct blameless postmortems
- `prev-defensive-coding` - Add defensive code at boundaries
- `prev-improve-error-messages` - Improve error messages

## How to Use

Read individual reference files for detailed explanations and code examples:

- [Section definitions](references/_sections.md) - Category structure and impact levels
- [Rule template](assets/templates/_template.md) - Template for adding new rules
- Example rules: [prob-reproduce-before-debug](references/prob-reproduce-before-debug.md), [hypo-binary-search](references/hypo-binary-search.md)

## Full Compiled Document

For the complete guide with all rules expanded: [AGENTS.md](AGENTS.md)

登录后下载/点赞/收藏 ❤ 94 | ★ 0

debug

目录结构

SKILL.md

举报内容

提示