halilneed
TREN

scar

scar, Claude Code, Codex CLI ve Gemini CLI’ın diskinizde zaten tuttuğu oturum kayıtlarını tarar ve ayrı oturumlarda tekrar eden hataları bulur. Her biri için bir kural, test özeti ya da düzeltme taslağı yazar, sonra dersin tutup tutmadığını ölçer. Hiçbir ağ isteği yapmaz ve reponuza kendiliğinden hiçbir şey yazmaz.

Hata aileleri
16
Sonuçlar
tuttu, tekrarladı, çok yeni, kanıt yok
Okunan ajanlar
Claude Code, Codex CLI, Gemini CLI
Ağ istekleri
yok
Lisans
MIT

Örnek çıktı

Bu, bu sitenin yapıldığı makinede --mine --days 90 ile yapılmış gerçek bir çalıştırmanın kısaltılmış hâlidir. Özel projelerin adını içeren satırlar çıkarıldı, uzun hata satırları kısaltıldı. Sayılar, tarayıcının yazdırdığı sayılardır. Tarama hiçbir ağ isteği yapmadı.

# scar — recurring failures

Source note: 156 sessions scanned (all, 90d) · 305 failure episodes
             · 6 low-confidence signatures dropped · 16 scars

| Id             | cost | sessions | projects | family            | artifact | error                        |
|----------------|------|----------|----------|-------------------|----------|------------------------------|
| `scar-0eqc684` |   68 |       14 |        5 | shell-quoting     | rule     | unexpected EOF while looki…  |
| `scar-0qkezmw` |   42 |        8 |        4 | edit-precondition | rule     | <tool_use_error>String to…  |
| `scar-12srzqa` |   36 |        6 |        5 | not-a-git-repo    | rule     | fatal: not a git repositor…  |
| `scar-08kw0mp` |   12 |        2 |        2 | timeout           | rule     | Command timed out after 2m…  |
| `scar-0w2b7dp` |   12 |        2 |        2 | compile-error     | test     | Build failed. Use dotnet b…  |

## What to do

`node scar.mjs --draft scar-0eqc684` → rule

Sıralama ham sayıya göre değil, maliyete göre yapılır: ayrı oturumlar × 3, dokunulan projeler × 2, tekrarlar için bir üst sınır, ve aynı duvara birden fazla ajan çarptıysa +4. Kötü geçen bir öğleden sonranın tüm yeniden denemeleri tek bir olay sayılır. Her scar’ı sınıflandıran 16 aile açıp okuyabileceğiniz bir örüntü listesidir. Sonraki adım tablonun altına yazdırılır.

Kurulum

# bir kez
> /plugin marketplace add halilneed/plugins

# eklenti
> /plugin install scar@hailneed

# ve deneyin
> /scar:mine

Marketin kimliği hailneed; kurulum satırının @hailneed ile bitmesi bu yüzden.

  • Claude Code ve Node.js 18 ya da üstü.
  • Bağımlılık yok, API anahtarı yok, kota harcanmaz.
  • Tek başına da çalışır: node scripts/scar.mjs --mine --md --lang en
  • CI için --verify --out verify.json sabit bir çıktı biçimi verir. Kontrolü written[].verdict üzerine kurun.

Komutlar

/scar:mine

Tekrarlayan hatalar, maliyetlerine göre sıralı: hangi hata kaç ayrı oturumda ve projede geri geldi, hangi komutlar başarısız oldu ve hemen ardından ne işe yaradı. Olayların çoğu başka bir aracın başarısıyla bitiyorsa rapor bunu söyler, çünkü o durumda ders daha iyi bir komut değil, araç seçimidir.

/scar:write <id>

Kalıcı ders: bir kural, bir regresyon testi özeti, bir ortam düzeltmesi ya da bir karar kaydı. Her birinde bir kanıt satırı ve bir scar işareti bulunur, böylece sonuç daha sonra ölçülebilir. Taslağı size gösterir ve reponuza bir şey yazmadan önce sorar.

/scar:verify

Dersin tutup tutmadığını kontrol eder. İşaretli her çıktı için hatanın, çıktı yazılmadan önceki ve sonraki tekrar sayısını verir. Dört sonuç vardır: tuttu, tekrarladı, çok yeni, kanıt yok. “Tekrarladı” sonucu, kuralın hatayı durdurmadığı anlamına gelir.

Ne yapar, ne yapmaz

  • Hiçbir ağ isteği yapmaz ve reponuza hiçbir şey yazmaz. Taslaklar stdout’a gider, scar.mjs içinde ne fetch ne soket vardır; repoya neyin gireceğine siz karar verirsiniz.
  • 16 aile vardır ve model yargısı yoktur. scars.mjs okuyabileceğiniz bir örüntü listesidir, --selftest onu verilerinize dokunmadan çalıştırır.
  • Yeniden deneme döngüleri sıralamayı şişirmez. Bir olay, art arda gelen başarısızlıklar ile ardından gelen ilk başarıdan oluşur; tek oturumdaki yirmi deneme tek bir derstir.
  • verify işarete bağlıdır. Tekrarları işaretin tarihinden önce ve sonra sayar, bu yüzden işareti olmayan bir kural ölçülemez.
  • Okunamayan oturumlar ve düşük güvenli olduğu için atılan imzalar kaynak notunda sayılır.
  • MIT lisanslıdır (LICENSE). Hesap yok, kayıt yok, telemetri yok.

Planlanan

Barındırılan bir sürüm, scar Cloud, planlanıyor. Eklenti ücretsiz ve yerel kalacak.

  • Ekip çapında scar havuzu: bir kişinin yaşadığı hata bütün ekip için bir kurala dönüşür.
  • Kural etkinliği zaman serisi: hangi dersler ekip genelinde tutuyor, hangileri sessizce işe yaramaz oldu.
  • İşe başlama özeti: yeni ekip üyeleri için bu repodaki bilinen tuzaklar.

Hazır olduğunda haberdar olmak için yazılar sayfasından abone olun.