Kendi Hatalarını Döngü İçinde Düzelten Bir Claude Code Ajanı Nasıl Oluşturulur (Tam Kurulum İçeride)

Claude kod yazar, bir test çöker ve hatayı halletmen için sana geri gönderir.

Kendini düzelten bir ajan böyle yapmaz: kendi hatasını okur, sebebi düzeltir ve yeşili görene kadar tekrar çalıştırır.

Bir kere kur ve ajanının ücretsiz hata ayıklayıcısı olmaktan çık.

İşte ihtiyacın olan tam kurulum 👇

Detaylara girmeden önce, AI ve vibe coding hakkında günlük notlarımı Telegram kanalımda paylaşıyorum: https://t.me/zodchixquant🧠

Neden tek bir geçiş yeterli değil

Varsayılan olarak Claude bir görevi bir kez çalıştırır. Bir test başarısız olur, hatayı bildirir ve bekler. Sen okursun, geri yapıştırırsın, tekrar dene dersin. Sen hata ayıklamayı yapıyorsundur, o sadece yazıyordur.

Kendini düzelten bir ajan bunu tersine çevirir. Kendi hatasını okur, ne tür bir hata olduğunu çözer, bu sebebi düzeltir ve tekrar çalıştırır; tıpkı bir hata ayıklayıcının düşündüğü gibi. Sen sadece geçtiğinde veya gerçekten takıldığında devreye girersin.

Dosya 1: düzeltme komutu

Bu aslında çalıştırdığın döngüdür. .claude/commands/fix.md dosyasına ekle:

1---
2description: Bir görevi çalıştır ve tüm testler geçene kadar kendini düzelt
3argument-hint: <görev>
4allowed-tools: Read, Write, Edit, Glob, Grep, Bash
5model: sonnet
6---
7
8Görev: $ARGUMENTS
9
10Döngü:
111. Görevi uygula.
122. Test paketini çalıştır: `npm test` (veya pytest, cargo test).
133. Tüm testler geçerse: dur ve bana sonucu göster.
144. Bir test başarısız olursa: hata türünü sınıflandır, kök nedeni adlandır,
15   bu nedeni düzelt, ardından 2. adıma geri dön.
165. Maksimum 5 deneme. Her turda deneme numarasını bildir.
17
18Sınıflandır-sonra-düzelt sırası asıl önemli olan noktadır.
19Her turda teşhis önce, düzenleme sonra. Geçmek için asla bir testi zayıflatma, kodu düzelt.

/fix kullanıcı uç noktasına sayfalama ekle yazarsın ve ajan, paket yeşil olana kadar yazar, test eder ve kendini onarır.

Dosya 2: otomatik kontrol kancası

Komut isteğe bağlı çalışır. Kanca, her düzenlemede kendi kendine kontrolü otomatik hale getirir.

.claude/settings.json dosyasına ekle:

1{
2  "hooks": {
3    "PostToolUse": [
4      {
5        "matcher": "Write|Edit",
6        "hooks": [
7          { "type": "command", "command": "npm test --silent 2>&1 | tail -5 || echo 'TESTLER BAŞARISIZ, devam etmeden önce düzelt'" }
8        ]
9      }
10    ]
11  }
12}

Artık Claude bir dosyayı her düzenlediğinde testler çalışır ve sonuç doğrudan görüş alanına düşer.

Bir başarısızlık hemen görünür, böylece ajan onu aynı akışta düzeltir, yoluna devam edip bozuk kodun üzerine daha fazla değişiklik yığmak yerine.

Dosya 3: hatayı okumayı öğret

Bu dosya, gerçek bir hata ayıklayıcıyı tahmin ediciden ayırandır. Çoğu ajan "test başarısız" görür ve rastgele düzenlemeye başlar.

İyi bir ajan önce hata türünü okur, çünkü her tür farklı bir nedeni işaret eder. Bunu CLAUDE.md dosyasına ekle:

1## Düzeltmeden önce bir başarısızlık nasıl okunur
2
3Önce her zaman hata türünü adlandır. Her biri farklı bir anlama gelir:
4
5- Doğrulama hatası (beklenen X, alınan Y): mantık yanlış.
6  Doğrulamadan değerin oluşturulduğu yere kadar geriye doğru izle.
7  Hesaplamayı düzelt, testin beklentisini değil.
8
9- Tür hatası / tanımsız bir fonksiyon değil: şekil uyuşmazlığı.
10  Bir şey null veya bu satıra yanlış tür ulaştı.
11  Bu değerin nereden geldiğini bul, orada koru veya düzelt.
12
13- Zaman aşımı / takılma: bir await eksik veya bir promise hiç çözümlenmiyor.
14  await olmadan async çağrıları veya asla değişmeyen bir koşulu ara.
15
16- İçe aktarma / modül bulunamadı: bir yol veya bağımlılık sorunu, mantık değil.
17  Yolu düzelt veya yükle, onu kullanan koda dokunma.
18
19- Tutarsız (bazen geçer): paylaşılan durum veya zamanlama, asla rastgele değil.
20  Sıraya bağlı testler veya taklit edilmemiş zaman/ağ ara.
21
22Kural: düzenleme yapmadan önce türü ve tek cümlelik kök nedeni yüksek sesle
23söyle. Nedeni adlandıramıyorsan, tahmin ediyorsundur. Dur.

Bir tür hatası ve bir doğrulama hatası zıt hamleler gerektirir: biri yukarı akışta bir veri şekli sorunudur, diğeri tam o noktada yanlış mantıktır. Önce sınıflandır ve ajan doğru şeyi düzeltir.

Bunu atla ve kırmızı kaybolana kadar rastgele düzenler, bu da sessizce bozuk olan yeşil bir paket elde etmenin yoludur.

Aslında ne görürsün

Tek bir satır yazarsın:

1/düzelt tarih biçimlendirici yanlış saat dilimleri döndürüyor

Sonra kendi kendine çalışır:

1Deneme 1
2  testler çalıştı → BAŞARISIZ
3  tür: doğrulama (beklenen 5, alınan 11)
4  neden: sayfa boyutu sorguya uygulanmamış
5  LIMIT ifadesi düzeltildi
6
7Deneme 2
8  testler çalıştı → BAŞARISIZ
9  tür: tür hatası (offset tanımsız)
10  neden: sayfa 1 offset göndermiyor, varsayılan yanlış
11  offset = (sayfa-1)*boyut eklendi
12
13Deneme 3
14  testler çalıştı → TÜMÜ YEŞİL (7/7)
15
163 denemede düzeltildi. Farkı incelemek ister misin?

Hiçbir zaman bir hatayı geri yapıştırmadın. Kendi başarısızlıklarını okudu, her bir nedeni adlandırdı ve paket geçene kadar düzeltti.

Yaygın hatalar

Teşhis etmeden düzeltmek. En büyüğü. Hata türünü adlandırmadan önce düzenleme yapan bir ajan tahmin ediyordur ve tahmin etmek kırmızıyı düzelterek değil, şans eseri yeşile çevirir. Önce sınıflandır kuralı tüm savunmadır.

Her hatayı aynı görmek. Bir zaman aşımı ve bir doğrulama hatasının hiçbir ortak yanı yoktur, ancak hata türü kılavuzu olmayan bir ajan ikisini de "bir şeyler yanlış" olarak görür ve en yakın satırı düzenler. Düzeltmelerinin yarısı yanlış dosyaya gider.

Semptomu yamamak. Hata fırlatan bir çağrıyı try/catch'e sarmak testi geçirir ve hatayı bırakır. Protokol, hataları tam da bu nedenle susturmayı yasaklar.

Testleri zayıflatmasına izin vermek. Testleri düzenlemesine izin verilen bir ajan, yeşile ulaşmak için eninde sonunda başarısız olanı siler. Hiçbir şey kanıtlamayan geçen bir paket en kötü sonuçtur, bu nedenle bu kural tartışılmaz.

5 dakikalık kurulum

2 dakika: .claude/commands/fix.md dosyasını oluştur.

1 dakika: settings.json dosyasına PostToolUse kancasını ekle.

1 dakika: CLAUDE.md dosyasına kendi kendine hata ayıklama protokolünü ekle.

1 dakika: Bilinen bir hatada /fix çalıştır ve sebebi deneme deneme çalışırken izle.

Artık hataları ileten insan sen değilsin. Ajan kendi kırmızısını okur ve yeşil olana kadar düzeltir. Daha akıllı olmadı, sadece sorunu sana geri göndermeyi bıraktı.

Okuduğun için teşekkürler!

AI, finans ve vibe coding hakkında günlük notlarımı Telegram kanalımda paylaşıyorum: https://t.me/zodchixquant