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.md
source 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

#HipotezOlasılıkTest
1Null pointer%40console.log
2Race condition%30timeout 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şamaDoğrulama
1"Bende çalışıyor" tuzağına düşüldü mü? (Ortam farkı kontrolü)
2Fix yaparken test yazıldı mı? (TDD)
3Benzer hatalar başka yerde var mı tarandı mı?