kod-denetim — Denetim Scripti + AI Düzeltme SKILL'i

SKILL dosyası: .claude/skills/kod-denetim/SKILL.md olarak kaydet. denetim.sh'ı çalıştırır (sıfır token), bulguları AI ile yorumlayıp önceliklendirir ve istenirse düzeltir: god-file bölme planı, uzun fonksiyon çıkarma, sır rotasyonu. Ucuz tarama + akıllı düzeltme ikilisi.

---
name: kod-denetim
description: "Denetim yap", "kod kalitesine bak", "projeyi taramadan geçir" dendiğinde veya release öncesi kullanılır. Önce denetim.sh scriptiyle sıfır-token hızlı tarama yapar, sonra bulguları AI ile yorumlayıp önceliklendirir ve istenirse somut düzeltme planı çıkarır/uygular.
---

# Kod Denetimi: Script Tarar, AI Düzeltir

İş bölümü net: mekanik tarama scripte (bedava, 2 saniye), yorum ve
düzeltme AI'a (token sadece gerektiğinde). Script çıktısı olmadan
dosya dosya gezip token yakma.

## 1. Scripti hazırla ve çalıştır

Proje kökünde `denetim.sh` yoksa indir:

```bash
curl -fsSL https://restopromt-web.slovveis.workers.dev/denetim.sh -o denetim.sh && chmod +x denetim.sh
```

Sonra makine okunur çıktıyla çalıştır:

```bash
./denetim.sh . --json > denetim-sonuc.json
```

## 2. Bulguları önceliklendir

JSON'daki bulguları şu sırayla ele al:

1. **sir-taramasi (en acil):** Gömülü şifre/anahtar bulunduysa HER ŞEYİ
   durdur. Kullanıcıya söyle: dosyadan silmek YETMEZ — anahtar iptal
   edilip yenilenmeli (git geçmişinde kalır). Sırrı env değişkenine taşı.
2. **dosya-uzunlugu KRİTİK:** God-file'lar. Dosyayı OKU, sorumluluklarını
   listele, bölme planı çıkar (aşağıda).
3. **fonksiyon-uzunlugu KRİTİK:** Fonksiyonu oku, mantıksal blokları
   tespit et, çıkarılacak alt fonksiyonları öner.
4. **bos-catch:** Her birine ya gerçek hata işleme ya da bilinçli
   "yut ama logla" davranışı öner.
5. Geri kalanlar (debug kalıntısı, kopya dosya vb.): tek seferde
   temizlenebilir mekanik liste olarak sun.

## 3. God-file bölme planı formatı

Bulunan her 800+ satırlık dosya için şunu üret (uygulamadan ÖNCE göster):

- Dosyanın şu anki sorumlulukları (madde madde)
- Önerilen yeni dosya yapısı: hangi satır aralığı → hangi yeni dosya
- Taşıma sırası (önce en bağımsız parça) ve her adımda neyin test edileceği
- Riskler: paylaşılan state, import döngüsü ihtimali

Örnek: 1500 satırlık login.php → auth/dogrulama.php (oturum kontrolü),
auth/kayit.php, db/kullanici-sorgulari.php, views/giris-formu.php.

## 4. Düzeltme kuralları

- Kullanıcı "düzelt" demeden HİÇBİR dosyayı değiştirme — önce rapor + plan.
- Düzeltirken davranışı değiştirme: sadece taşı/böl/çıkar, mantığa dokunma.
- Her düzeltme sonrası varsa testleri çalıştır; yoksa scripti tekrar
  çalıştırıp bulgu sayısının düştüğünü göster.
- Tek oturumda en fazla 1-2 god-file böl — dev refactor'ları parçalara ayır.

## 5. Kapanış raporu

| Alan | Önce | Sonra |
|------|------|-------|
| Kritik bulgu | X | Y |
| Uyarı | X | Y |

+ hâlâ açık kalan bulgular ve önerilen sıradaki adım.

## Korkuluklar

- Script çıktısındaki her bulgu %100 doğru olmayabilir (heuristik) —
  düzeltmeden önce dosyayı okuyup doğrula.
- Sır bulgusunda asla sırrın kendisini rapora/commit mesajına yazma.
- Derin mimari değerlendirme gerekiyorsa (tek dosya değil sistem sorunu)
  cekismeli-degerlendirici agent'ını öner — o iş bu skill'in kapsamı dışı.