Ajanına kural yazdın ama uymuyor, aynı hatayı yapmaya devam ediyor
Kuralı metin olarak tekrarlamıyorum: ajan yanlış komutu çalıştırmak üzereyken bir kanca onu reddediyor ve yerine geçen komutu söylüyor. Reddi yalnız hamlenin değişmesi şart olan yerde kuruyorum, çünkü her ret ajana bir adım daha ödetiyor; önerdiği yolun da gerçekten geçtiğini sınıyorum.
önceuyarıdan sonra düzeltme %36
sonraretten sonra %95 durdu · önerilen yolu ayrıca sına
kuralı uyarı olarak değil, yanlış komutu reddedip yerine geçeni söyleyen bir kanca olarak kur; yalnız geri alınamayan ya da pahalı hatadaAjana giden metin · 58 satır
Durum: ajanına bir kural yazdın (CLAUDE.md, istem ya da bir kancanın bastığı uyarı) ama ajan aynı hamleyi yapmaya devam ediyor.
Neden: ajan uyarıyı okur ama hamlesini çoğu kez değiştirmez; reddi düzeltir. Bende (Claude Code, 1–12 Kasım, 34.053 kanca olayı) bir kanca eylemi geçirip uyarı bastıktan sonra ajan aynı eylemi yeniden denediğinde %36'sında düzeltti, eylemi reddettiğinde %95'inde. Uyarı oranı tek bir uyarı kancasından, ret oranı dokuz ret kancasından geliyor. Komut koşmadan önce ajana eklenen bağlam notu komutu durdurmadı: küçük bir modelle 3 denemenin 3'ünde pahalı komut yine koştu.
Ret durdurur ama önerdiği yolu her zaman seçtirmez: denemede ret 3 denemenin 3'ünde durdurdu, önerilen komutu 1'inde seçtirdi. Önerilen yol başka bir kural tarafından reddediliyorsa ajan yol uydurur; bende bir ret kendi önerdiği okumayı da reddediyordu.
Ret bedava değil: reddedilen araç çağrısı baştan üretilir (yazılacak dosya yeniden yazılır), her ret ajana bir model adımı daha ödetir. Kanca eşleşen her araç çağrısında koşar: yavaşlarsa bütün ajanlar bekler, çökerse hepsi durur. Ret, ajanın gerçekten üretemeyeceği bir şeyi (gerekçe, kaynak, «test ettim») isterse ajan reddi geçmek için onu uydurur.
Yap:
(1–4 kendi kuralın içindir. Elinde kural yoksa ve yalnız yöntemi deniyorsan 5'teki örnek kuralla kur.)
1. Önce kancasız yolları dene; ilk tutan kazanır, kanca kurulmaz:
a. Kuralla çelişen ya da yanlışı öğreten kendi metnin var mı (CLAUDE.md'de eski bir satır, bir betiğin bastığı örnek komut)? Onu düzelt; üstüne kanca koyma.
b. Yanlışı yapan komut ya da betik senin elindeyse reddi oraya koy (betik yanlış argümanla hata verip doğrusunu söylesin); her araç çağrısında koşan kancaya değil.
c. Hata kendini zaten söylüyorsa (derleyici hatası, komutun hata çıkışı) kanca kurma; ajan onu görür ve düzeltir.
2. Yanlış tek bir araç çağrısının girdisinden (komut metni, dosya yolu, içerik) tanınabiliyor mu? «Yeterince düşünmedi» gibi girdiden tanınmayan bir yanlışa kanca kurma.
3. Ret mi, uyarı mı, hiç mi:
- Yanlış geri alınamıyorsa (silme, yayımlama, paylaşılan dalı ezme) → ret.
- Geri alınabiliyor ve sonra kendini söylüyorsa → kanca yok.
- Arası için tart: ret ⟺ isabet × (0,95 − 0,36) × kaçan bir yanlışın bedeli > bir ek model adımı. İsabet, kancanın ateşlediği çağrıların gerçekten yanlış olan payıdır; doğru hamlede de ateşleyen kancada ret pahalıdır, önce eşleşmeyi daralt.
- Uyarı yazacaksan kural değil sonuç yaz («bu komut 40 sn sürdü, 2 GB yazdı»). Kural cümlesi ya da «şu dosyayı oku» basma: ajan adresi açmaz, kopyalanan kural da asıl kural değişince eskir.
4. Ret metni iki parça: reddedilen ve yerine geçen tam komut, örnek:
RED: git push --force → git push --force-with-lease · başkasının gönderdiğini ezmez
Yerine geçen yol yazılmazsa ajan kendi yolunu uydurur. Yerine geçen komut ajanın makinesinde zaten var olmalı: kurulum isteyen bir aracı ret metnine yazma.
5. Kur (Claude Code, proje içinde; jq gerekir: command -v jq, yoksa brew install jq). Aşağıdaki blokların başındaki üç boşluk bu listenin girintisidir, dosyaya yazarken sil. Örnek tek bir kuralı taşıyor: «paylaşılan dalı --force ile ezme». Kendi kuralın için yalnız `yanlis` desenini ve ret metnini değiştir.
.claude/hooks/kural.sh:
#!/bin/sh
command -v jq >/dev/null 2>&1 || { echo "kural.sh: jq bulunamadı, kanca karar veremiyor" >&2; exit 2; }
cmd=$(jq -r '.tool_input.command // empty')
log="$(dirname "$0")/kural.log"
yanlis='(^|[;&|(])[[:space:]]*([A-Za-z_][A-Za-z0-9_]*=[^[:space:]]*[[:space:]]+)*git[[:space:]]+push([[:space:]]+[^;&|]*)?[[:space:]](--force|-[A-Za-z]*f[A-Za-z]*)([[:space:];&|)]|$)'
if printf '%s' "$cmd" | grep -Eq "$yanlis"; then
printf '%s\tret\n' "$(date +%FT%T)" >> "$log"
jq -n '{hookSpecificOutput:{hookEventName:"PreToolUse",permissionDecision:"deny",permissionDecisionReason:"RED: git push --force → git push --force-with-lease · başkasının gönderdiğini ezmez"}}'
exit 0
fi
.claude/settings.json (varsa hooks altına ekle):
{"hooks":{"PreToolUse":[{"matcher":"Bash","hooks":[{"type":"command","command":"sh \"$CLAUDE_PROJECT_DIR\"/.claude/hooks/kural.sh","timeout":5}]}]}}
Günlük dosyasını depoya sokma: printf '\n.claude/hooks/kural.log\n' >> .gitignore (baştaki boş satır, .gitignore yeni satırla bitmiyorsa son kuralına yapışmayı önler)
Eşleyiciyi dar tut ("matcher": "Bash"). Günlüğe komut metni yazılmaz (komut satırında sır olabilir), yalnız zaman ve karar yazılır.
Doğrula:
- Sahte olayı kancaya veren yardımcı. Proje kökünde koş (.claude klasörünün durduğu yer); tanımı ve çağrıları aynı komutta koş (her araç çağrısı yeni kabuk açar). Yardımcı kancayı settings.json'da yazılı komutla çağırır.
ev() { command -v jq >/dev/null || { echo "jq yok"; return 1; }; k=$(jq -r '.hooks.PreToolUse[].hooks[] | (.command // "") | select(test("kural[.]sh"))' .claude/settings.json | head -1); [ -n "$k" ] || { echo "settings.json'da kural.sh yok"; return 1; }; jq -nc --arg c "$1" '{tool_name:"Bash",tool_input:{command:$c}}' | CLAUDE_PROJECT_DIR="$PWD" sh -c "$k"; echo "çıkış $?"; }
- Eşleyici: jq -r '.hooks.PreToolUse[] | select(any(.hooks[]; (.command // "") | test("kural[.]sh"))) | .matcher' .claude/settings.json → Bash (büyük B ile; "bash" yazılırsa Claude Code kancayı hiç çağırmaz). Bu satır yalnız settings.json'u okur; kancanın kendisini aşağıdaki üç satır sınar.
- Üç satır birlikte okunur:
ev 'git push --force' → "deny" içeren JSON, sonra «çıkış 0»
ev 'git push --force-with-lease' → yalnız «çıkış 0» (retin önerdiği yol kancadan geçmeli)
ev 'git push' → yalnız «çıkış 0»
«çıkış 0» dışında bir sayı görürsen kanca bozuk.
- En yakın komşular. Reddedilmeli: ev 'git push -f origin main' · ev 'git push -fu origin main' · ev 'git push origin main --force' · ev 'cd repo && git push --force' · ev 'GIT_TRACE=1 git push --force' · ev 'git push origin "$(git branch --show-current)" --force'. Geçmeli: ev 'git push -u origin dal' · ev 'echo git push --force' · ev 'git commit -m "push --force yapma"' · ev 'git push origin main && rm -f x'. Bu iki grup da birlikte okunur: yalnız «Geçmeli» her şeyi geçiren, yalnız «Reddedilmeli» her şeyi reddeden kancada da tutar. Bu sürümün bilinen yanlış reddi: desen tırnağı görmez; tırnak içinde satır başından ya da ; & | ( işaretinden sonra gelen «git push --force» da reddedilir: ev 'git commit -m "düzelt; git push --force yapma"' → "deny".
- Kaçanlar, bilerek kapatılmadı; hepsi ret vermeden yalnız «çıkış 0» basar: ev 'git -C repo push --force' · ev 'git push origin +main' · ev 'sudo git push --force' · ev 'command git push --force' · ev 'git push origin main 2>&1 --force' · ev 'git push --mirror' · ev "$(printf 'git push \\\n--force')" (satır sonu ters eğik çizgiyle bölünen komut) · printf 'git push --force\n' > gonder.sh; ev 'sh gonder.sh'; rm gonder.sh (içinde yazan betik). Bu satır kancayı sınamaz, neyin kapatılmadığını gösterir. Liste örnektir, tam değildir: kanca yalnız komut metnini, satır satır görür. Kaçanın bedeli büyükse kancayı büyütme, reddi yanlışın kendisine koy (adım 1b). Bu örnekte: uzak depoda dalı zorla göndermeye kapat (dal koruması); o engel kancadan ve ajandan bağımsız çalışır.
- Süre: time sh .claude/hooks/kural.sh </dev/null → 0,2 saniyenin altında (sh «real», zsh «total» diye yazar). Bu satır kancanın doğruluğunu değil yalnız süresini ölçer: kanca dosyası yokken de küçük bir sayı basar, yanında «No such file» görürsen dosya yok. Kanca dosya okuyor, ağa çıkıyor ya da süreç başlatıyorsa süre büyür; settings.json'daki "timeout": 5 kancayı o saniyede keser ve komut koşar.
- Elle koştuğun satırları sil: rm -f .claude/hooks/kural.log
- Canlı: proje kökünde claude -p 'git push --force --dry-run komutunu koş' (--dry-run uzak depoya hiçbir şey göndermez), ardından cat .claude/hooks/kural.log → bir «ret» satırı, Claude'un cevabı da git push --force-with-lease'i anıyor: kanca Claude Code içinde koşuyor ve reddi ajana ulaşıyor.
Yapma:
- Her kuralı kancaya taşıma: her ret ajana bir adım, her kanca her çağrıya gecikme ekler.
- Kancaya kuralın metnini kopyalama; yalnız sonucu ve yerine geçen yolu yaz.
- Gerekçe, kaynak ya da «test ettin mi» gibi ajanın uydurabileceği bir şeyi retle isteme.
- Kaçan her yazımı desene ekleyerek kancayı büyütme: desen büyüdükçe doğru komutu da reddeder.Bu durum şurada da: Çok ajanla çalışıyorsan