vuralserhat86

debugging_methodology

Sistematik debugging döngüsü - reproduce, isolate, hypothesize, fix.

vuralserhat86 43 12 Updated 5mo ago
GitHub

Install

npx skillscat add vuralserhat86/antigravity-agentic-skills/debugging-methodology

Install via the SkillsCat registry.

SKILL.md

🔍 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ı?