Claude-skill-registry debugging_methodology
Sistematik debugging döngüsü - reproduce, isolate, hypothesize, fix.
install
source · Clone the upstream repo
git clone https://github.com/majiayu000/claude-skill-registry
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/majiayu000/claude-skill-registry "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/data/debugging-methodology" ~/.claude/skills/majiayu000-claude-skill-registry-debugging-methodology && rm -rf "$T"
manifest:
skills/data/debugging-methodology/SKILL.mdsource content
🔍 Debugging Methodology
Sistematik hata ayıklama döngüsü.
🔄 Debugging Döngüsü
REPRODUCE → UNDERSTAND → ISOLATE → HYPOTHESIZE → TEST → FIX → REFLECT
1️⃣ Reproduce
### Tekrarlama Raporu - Hata: [Açıklama] - Adımlar: 1. ... 2. ... 3. → Hata - Ortam: [OS, Node, Browser] - Tekrarlanabilirlik: [%100 / %50 / Nadiren]
2️⃣ 5 Whys
Problem: Login çalışmıyor 1. Neden? → API 401 dönüyor 2. Neden? → Token geçersiz 3. Neden? → Token expire 4. Neden? → Refresh çalışmıyor 5. Neden? → Endpoint değişmiş
3️⃣ Binary Search (git bisect)
git bisect start git bisect bad HEAD git bisect good v1.0.0 git bisect run npm test
4️⃣ Hipotez Listesi
| # | Hipotez | Olasılık | Test |
|---|---|---|---|
| 1 | Null pointer | %40 | console.log |
| 2 | Race condition | %30 | timeout ekle |
Debugging Methodology v1.1 - Enhanced
🔄 Workflow
Kaynak: Scientific Method in Debugging
Aşama 1: Incident Response (Triage)
- Log: Hata mesajını ve call stack'i kaydet.
- Reproduce: Hatayı lokalde veya test ortamında en az 1 kez tekrar et.
- Environment: Versiyon farklarını (Prod vs Dev) kontrol et.
Aşama 2: Root Cause Analysis (RCA)
- Bisection: Sorunun başladığı commit'i bul (
).git bisect - Isolation: Sistemi parçalara ayırarak hatayı izole et (Unit Test yaz).
- Hypothesis: En olası nedenleri listele ve Binary Search ile ele.
Aşama 3: Resolution & Prevention
- Fix: En az müdahale ile sorunu çözen kodu yaz.
- Verify: Hem fix'i hem de regression (yan etki) olmadığını test et.
- Post-Mortem: "Neden oldu?" ve "Nasıl önlenir?" sorularını yanıtla.
Kontrol Noktaları
| Aşama | Doğrulama |
|---|---|
| 1 | "Bende çalışıyor" tuzağına düşüldü mü? (Ortam farkı kontrolü) |
| 2 | Fix yaparken test yazıldı mı? (TDD) |
| 3 | Benzer hatalar başka yerde var mı tarandı mı? |