Yapay zeka kodlaması, uygulamayı giderek daha hızlı hale getiriyor.
Birçoğunuz muhtemelen insanların tüm uygulamaları incelemeye yetişemediği bir durumdasınız.
Bir çözüm olarak bu makale, codex-review adlı kendi kendine yapılan bir Skill'in en son sürümünü açıklıyor. Bu Skill, inceleme rolünü bir Codex alt ajanına atar ve önemli sorunlar ortadan kalkana kadar düzeltmeleri ve yeniden incelemeleri tekrarlar.
Aslında Altı Ay Önce Oluşturulmuş Bir Skill
Aslında bu Skill'in temeli yaklaşık altı ay önce oluşturuldu. Küçük küçük iyileştirmeler yaparak düzenli olarak kullanmaya devam ediyorum.
https://x.com/makaneko_AI/status/2005475035075707092
Önceki sürüm, Claude Code'un uygulamayı üstlendiği ve Codex'in bir inceleyici olarak çağrılıp düzeltmeleri ve yeniden incelemeleri tekrarladığı bir yöntem olarak tanıtılmıştı. O zamanlar Claude Code uygulama görevlerinde güçlüydü ve Codex sadece "akıllıydı", bu yüzden bu konfigürasyona sahipti.
Ancak yapay zeka ortamı tamamen değişti. Codex artık uygulamada daha güçlü ve daha akıllı (Fable 5 hariç) ve birçok kişi muhtemelen uygulama görevlerini yalnızca Codex ile tamamlıyor.
Böyle bir ortama uyum sağlamak için, döngünün Codex içinde çalışmasını sağlayacak şekilde içeriği yeniledim.
En Son Sürümde Değişen Üç Şey
Temel akış önceki sürümle aynı kalıyor.
Uygulama liderini ve inceleme liderini ayırın ↓ İncelemeci salt okunur modda bakar ↓ Önemli noktalar varsa başarısız ↓ Düzelt ↓ Aynı yöntemi kullanarak yeniden incele ↓ Geçene kadar tekrarla
En son sürümün kilit noktaları aşağıdaki üç tanesidir:
1. GPT-5.5 için optimize edildi
2. Önemli sorunlara odaklanma
3. Genel doğruluk iyileştirildi
Bunları sırayla açıklayacağım.
1. GPT-5.5 için Optimize Edildi
2026/06/18 itibarıyla OpenAI'in en son GPT-5.5 serisi, ajan tabanlı kodlama ve pratik çalışmalarda güçlü bir model olarak konumlandırılıyor. Çok adımlı, belirsiz görevlerde bile otonom olarak ilerleyebildiği belirtiliyor.
Resmi GPT-5.5 kılavuzuna bakıldığında, "ayrıntılı prosedürleri doldurmak yerine istenen sonuçları kısa ve öz bir şekilde yazarsanız daha iyi çalışır" gibi şeyler söylüyor.
Bu nedenle, en son sürümde ayrıntılı şablonları listelemeyi bıraktım ve incelemecinin uyması gereken kuralları güçlendirdim.
https://x.com/makaneko_AI/status/2049848091860463995
2. Önemli Sorunlara Odaklanma
Codex'in, iyi ya da kötü, zekasını kullanarak ayrıntılı noktalara değinme eğilimi vardı.
Bu nedenle, en son sürümde incelemeciden "yalnızca P0/P1 eşdeğeri (en yüksek/yüksek öncelikli) sorunları almasını ve küçük üslup noktalarıyla ilgilenmemesini" açıkça belirttim.
Bu sayede gereksiz tekrarlayan küçük düzeltmeler azaldı ve sorunsuz bir şekilde ilerlemek kolaylaştı.
3. Genel Doğruluk İyileştirildi
Genel olarak doğruluğu küçük ayrıntılarda iyileştirdim.
Örneğin, bir incelemenin yarıda kesilip geçer olarak işaretlendiği boşlukları kapattım. İncelemecinin başlatılamadığı veya döndürülen raporun bozuk ve okunamaz olduğu durumlar artık geçer olarak işaretlenmiyor.
Büyük bir değişiklik birden fazla inceleyici arasında paylaşıldığında bile, herkes geçer döndürürse ve incelenmemiş veya başarısız inceleme yoksa tümü geçer. Bu iyileştirmeler, inceleme sırasında sorunların gözden kaçırılması riskini azalttı.
Önerilen Kullanım
Bu Skill'in, spesifikasyon tasarımından veya orta ila büyük ölçekli uygulamadan sonra otomatik olarak tetiklenmesi talimatı verilmiştir, ancak kullanıcının istediği zamanda otomatik olarak başlayacak şekilde ayarlanması önerilir.
Örneğin, Codex'in her zaman ilk okuduğu AGENTS.md dosyasına "Şu durumda Codex incelemesini yürüt" ekleyin. Veya bir uygulama planı formatı varsa, bunu zorunlu bir adım olarak dahil edin.
Önceki sürümün açıklama makalesi de bu alanı açıklıyor.
https://note.com/makaneko_ai/n/n3cefcec49e2d
"codex-review" Skill'inin Tam Metni
Ölçek | Kriter | Strateji |
|---|---|---|
küçük | ≤3 dosya, ≤100 satır | diff 1 çalıştırma |
orta | 4-10 dosya, 100-500 satır | arch → diff 1 çalıştırma |
büyük | >10 dosya, >500 satır | arch → diff (paralel olarak birden çok çalıştırma) → çapraz kontrol |
{
"ok": false,
"summary": "İncelemenin özeti",
"issues": [
{
"file": "src/auth.py",
"lines": "42-45",
"problem": "Sorunun açıklaması",
"recommendation": "Düzeltme planı",
"verification": "Düzeltme sonrası doğrulama yöntemi"
}
],
"notes_for_next_review": "Notlar"
}
``text
## Düzeltme Döngüsü
ok=false ise, max_iters sayısına kadar tekrarlayın. Varsayılan max_iters=5.
1. issues'ı analiz edin ve bir düzeltme planı oluşturun.
2. Uygulayıcı, minimal diff ile düzeltir (spesifikasyon değişikliklerini çözülmemiş sorunlar olarak bırakın).
3. Değişiklik riskine göre testleri, linter'ları veya alternatif doğrulamayı çalıştırın. Çalıştırılmazsa nedeni bırakın; kritik yolda doğrulanmamışsa, engelleyici olarak ele alın.
4. Aynı modda yeniden inceleme yapın.
Durdurma koşulları:
- ok=true: geçit geçer
- max_iters'a ulaşıldı: geçit başarısız
- Test art arda iki kez başarısız oldu: geçit başarısız
- İncelemeci hatası / JSON ayrıştırma hatası / çıktı formatı eksikliği / incelenmemiş alan mevcut: geçit başarısız
Geçit başarısız olarak durdurulursa, kalan engelleyici, incelenmemiş ve başarısız doğrulamaları nihai raporda çözülmemiş olarak çıktılayın.
## /review Geri Dönüşü
/review'u yalnızca JSON geçidi başarısız olursa kullanın. /review bir keşif yardımcısıdır ve çıktısı olduğu gibi ok=true için temel olarak kullanılmamalıdır.
## Hata Kuralları
- İncelemeci kurulamazsa, başarısızlık nedenini, denenmiş incelemeci yolunu ve incelenmemiş aralığı nihai raporda kaydedin.
- İncelemeci'nin salt okunur kısıtlamasını gevşetmeyin.
- Aşırı girdi veya zaman aşımı durumunda, aralığı azaltarak veya bölerek yeniden deneyebilirsiniz.
## Nihai Rapor Örneği
Bu, kapsamlı bir şablon değil, incelenmemiş alanların kaldığı bir örnektir.
``
Codex İnceleme Sonuçları
- mod: JSON geçidi veya /review
- inceleme_kapsamı: dal farkı
- Ölçek: büyük (12 dosya, 620 satır)
- Paralel: 3 alt ajan
- incelemeci_yolu: önce spawn_agent
- geri dönüş kanıtı: yok
- Yineleme: 2/5
- İnceleme geçidi: ok=false
- neden: incelenmemiş_kapsam boş değil
- Tamamlama kanıtı: push/merge/release/görev tamamlama vb. ayrı olarak onaylanır
Düzeltme Geçmişi
- auth.py: Yetkilendirme kontrolü eklendi
İncelenmemiş
- utils/legacy.py: Codex zaman aşımı, yeniden inceleme gerekli
Çözülmemiş
- main.py: İçerik, risk, önerilen eylem```
Özet
codex-review Skill'inin en son sürümü, yalnızca önceki sürümün Codex içinde çalışmasını sağlamakla ilgili değil. Mevcut Codex ve GPT-5.5'e uyacak şekilde gereksiz adımlardan arındırılmış ve bir inceleme geçidi olarak izlenecek kurallar netleştirilmiştir. Kendi kendine inceleyen ve düzelten bir mekanizma çok kullanışlıdır, bu yüzden tanıtmayı deneyin.
Bu makaleyi faydalı bulduysanız, takip edip paylaşmanızdan mutluluk duyarım. Yapay zekayı sadece kullanmanın değil, otonom olarak çalıştırmanın yollarını paylaşmaya devam ediyorum.
İlgili Gönderiler
https://x.com/makaneko_AI/status/2058739339606233492
