AI peer review (AI akran incelemesi) artık Claude Code için ücretsiz ve açık kaynaklı bir beceridir. Bu özellik, Claude, Codex ve Gemini'nin CLI devir teslimleri aracılığıyla birbirlerinin kodunu incelemesini sağlar; buna yapılandırılmış bir karar, dosya:satır bulguları ve yanıt formatına gömülmüş bir dürüstlük sözleşmesi dahildir.
Becerinin adı `ai-collab-bridge` şeklindedir. MIT lisanslıdır. 30 saniyede kurulur. Bunu macOS arm64 üzerinde test ettim; bash betikleri Linux'a da taşınabilir.
TL;DR
AI akran inceleme becerisini 30 saniyede kurun
bash git clone https://github.com/owgit/ai-collab-bridge ~/.claude/skills/ai-collab-bridge chmod +x ~/.claude/skills/ai-collab-bridge/scripts/*.sh ~/.claude/skills/ai-collab-bridge/scripts/doctor.sh
`doctor.sh` betiği, beceri dosyalarınızı, gerekli araçları ve her bir AI CLI'ını (Claude, Codex, Gemini) tek bir geçişte doğrular. Çıkış kodu, başarısız olan kontrol sayısına eşittir. Eğer bir şey bozuksa, çıktı size tam olarak hangi düzeltme komutunu çalıştırmanız gerektiğini söyler. Temiz bir macOS kurulumunda yaptığım testlerde, tüm doğrulama iki saniyenin altında tamamlandı.
Ardından yeni bir Claude Code oturumu başlatın — AI akran inceleme becerisi otomatik olarak keşfedilecektir — ve onu *"en son commit'imi incelemek için AI Collab Bridge'i kullan"* gibi bir komutla tetikleyin.
AI akran incelemesi gerçekte nasıl çalışır
Protokol, tek bir paragrafa sığacak kadar küçüktür. Uygulayıcı — yani işi yeni bitiren AI — bir paket sahneye koyar. Bu paket; bir özet, odak soruları, diff ve dosya listesini içeren tek bir markdown dosyasıdır. Ardından uygulayıcı, inceleyicinin CLI'ını bu paketi bir inceleme isteği şablonuna sararak çağırır. İnceleyici paketi okur ve yanıt verir.
Paket sahneleme (uygulayıcı tarafı)
bash SUMMARY="Değişikliğin kısa açıklaması" \ QUESTIONS="Odaklanılmasını istediğiniz herhangi bir şey" \ ~/.claude/skills/ai-collab-bridge/scripts/stage-packet.sh main > /tmp/packet.md
Bu komut, inceleyicinin ihtiyacı olan her şeyi (özetiniz, odak sorularınız, `git diff --stat` ve `main` dalına karşı tam diff) içeren bir markdown dosyası üretir.
AI akran incelemesini tetikleme
bash ~/.claude/skills/ai-collab-bridge/scripts/request-review.sh codex /tmp/packet.md
veya claude / gemini — aynı yapı, farklı hedef
Bu betik, paketinizi inceleme isteği şablonuna sarar, hedef AI'nın CLI'ına gönderir ve yapılandırılmış yanıtı ekrana basar.
Yanıt formatı
Her AI akran inceleme yanıtı aynı beş bölümlü şablonu takip eder:
Son madde, bunu ilk tasarladığımda beni şaşırtan kısımdı. Tecrübelerime göre, herhangi bir kod incelemesinin en değerli bölümü, inceleyicinin neye bakmadığını açıklamak zorunda bırakıldığı bölümdür. Bu olmadan, bir `APPROVE` kararının "Her şeyi kontrol ettim ve sorun yok" mu yoksa "Diff'e göz gezdirdim ve hiçbir şey gözüme çarpmadı" mı olduğunu anlayamazsınız. Bu liste sayesinde uygulayıcı, inceleyicinin kapsamının tam olarak nerede bittiğini bilir. Her AI akran incelemesinin altında yatan dürüstlük sözleşmesi budur. Protokol bunu zorla uygulayamaz; sadece dürüst olmamayı gizlemeyi zorlaştırabilir.
Kıyaslama: %100'e karşı %31 geçme oranı
AI akran inceleme becerisini, temel alınmış ham Claude'a karşı test ettim. Üç test senaryosu — inceleyici rolü, uygulayıcı devir teslimi, karşılama turu — aynı promptlar, aynı model; becerili versiyon ve becerisiz versiyon karşılaştırması.
| Metrik | Beceri ile | Becerisiz | Fark |
|---|---|---|---|
| --- | --- | --- | --- |
| Geçme oranı | %100 | %31 | +69 puan |
| Süre | 67 sn | 68 sn | aynı |
| Token | 60 k | 53 k | +%14 |
Ölçümlerime göre, AI akran inceleme becerisi yaklaşık %14 daha fazla tokene mal oluyor (model rol oyun kitapçıklarını okuyor) ve aynı hızda çalışıyor. Yapılandırılmış ve dürüst bir çıktı için ucuz bir sigorta.
Meta an: Köprünün kendini incelemesi
v0.1'i yayınladıktan sonra, köprüyü bir sonraki commit'ini incelemek için kullandım. Codex, doctor betiğimde ve prob mantığımda kaçırdığım iki hatayı yakaladı. İkisini de düzelttim, v0.2'yi yayınladım ve köprüyü tekrar çalıştırdım. Codex iki hata daha yakaladı. Onları da düzeltip v0.3'ü yayınladım.
Köprünün kendisinde bulduğu dört hata
Stilistik tercihler veya faydalı görünmek için uydurulmuş endişeler değil. Her düzeltmeden sonra test ettiğim somut şeyler:
Bunların hiçbiri ben yazarken bana açık gelmemişti. Ancak Codex için, implementasyon önyargım olmadan diff'i soğukkanlılıkla okuduğunda hepsi çok açıktı. AI akran incelemesi için tüm argüman bu: Farklı zihinler, farklı kör noktalar, yapılandırılmış devir teslim. İş daha iyi hale geliyor ve siz bunun için düşünmek zorunda kalmıyorsunuz.
Codex CLI hakkında öğrendiklerim
Bu AI akran inceleme becerisini yayınlarken yapılan işin çoğu protokol değil, her bir AI'nın CLI'ını beklenmedik bir şey yapmadan nasıl çağıracağınızı çözmekti.
Codex MCP önyükleme takılması
`codex exec` çalıştırdığınızda, `~/.codex/config.toml` dosyasını yükler ve yapılandırdığınız herhangi bir MCP sunucusunu önyüklemeye çalışır. Eğer bu sunucular kendi kimlik doğrulamalarını gerektiriyorsa (Cloudflare Workers MCP, GitHub Copilot MCP vb.) ve etkileşimsiz kullanım için tokenları ayarlamadıysanız, codex sessizce takılı kalır. İlk inceleme gönderimimde işlem, MCP önyüklemesine kadar iz sürmeden önce on dakika boyunca askıda kaldı. Çözüm `--ignore-user-config` kullanmaktır. Codex CLI'ının ayrıca tam olarak bu kullanım durumu için tasarlanmış özel bir `codex exec review` alt komutu ve yalnızca aracının son mesajını bir dosyaya yazan bir `-o` bayrağı vardır. Tam referans için OpenAI Codex CLI deposuna ve Codex belgelerine bakın.
npm satıcı ikili dosyası ENOENT hatası
npm üzerinden yüklenen `@openai/codex` bazen platforma özel satıcı ikili dosyası olmadan gelir. `which codex` başarılı olur ancak çalıştırıldığında eksik bir arm64 ikili dosyasına işaret eden gizemli bir Node `ENOENT` yığın izi ile başarısız olur. Bunu kendi makinemde yaşadım ve çözüm `npm uninstall -g @openai/codex && npm install -g @openai/codex` şeklinde. Köprünün `doctor.sh` betiği artık bu deseni tam olarak tespit ediyor ve düzeltmeyi doğrudan sunuyor.
Desteklenen AI CLI'ları
| AI | Varsayılan çağırma | Geçersiz kılma ortam değişkeni |
|---|---|---|
| --- | --- | --- |
| Claude | `claude -p` | `AI_COLLAB_CLAUDE_CMD` |
| Codex | `codex exec review --ignore-user-config --ephemeral` | `AI_COLLAB_CODEX_CMD` |
| Gemini | `gemini -p` | `AI_COLLAB_GEMINI_CMD` |
Başka bir AI eklemek, `scripts/request-review.sh` içinde bir `case` satırı ve `references/` altında isteğe bağlı bir rol oyun kitabçığı eklemektir. PR'lara açığız.
Çoklu AI iş akışları için AI akran incelemesi neden önemlidir?
Eğer "AI'ın otomatik tamamlama"dan "AI'ın iş birliği yapan ortak" olmasına geçişi takip ediyorsanız, sonraki darboğazın bireysel modeller olmadığını muhtemelen fark etmişsinizdir. Sonraki darboğaz, modellerin birbirleri ve araçlarınızla nasıl çalıştığıdır.
Bu aynı zamanda agent-ready website checklist→ yazımda da savunduğum şeydi: Modelin kendisinden ziyade modelin etrafındaki sistemler daha önemlidir.
Kendi günlük iş akışımda bu şu şekilde görünüyor:
AI akran incelemesi olmadan, bu iş akışları paralel ama izole olarak çalışır. Her AI sadece önünde olanı görür. AI akran inceleme becerisi yerinde olduğunda ise diff'ler yapılandırılmış bir şekilde aralarında akar ve iş katlanarak büyür.
Aynı desen, daha önce yazdığım diğer açılarda da ortaya çıkıyor: Karşılaştırma açısından Claude Code vs Cursor for 2026→, araçlar açısından TypeScript ile MCP sunucusu nasıl yapılır→ ve yapı açısından çapraz depo AI bağlam katmanı→. Döngünüzdeki ajanların insanlarla temiz arayüzlere sahip olduğu kadar, birbirleriyle de temiz arayüzlere sahip olması gerekir.
AI akran inceleme becerisini kendiniz deneyin
AI akran inceleme becerisi açık kaynaktır ve `github.com/owgit/ai-collab-bridge` adresinde bulunur.
bash git clone https://github.com/owgit/ai-collab-bridge ~/.claude/skills/ai-collab-bridge chmod +x ~/.claude/skills/ai-collab-bridge/scripts/*.sh ~/.claude/skills/ai-collab-bridge/scripts/doctor.sh
Depo kökünde `AGENTS.md` ve `CLAUDE.md` dosyaları bulunur, böylece Codex ve Claude Code, depoya doğrudan işaret edildiğinde açık giriş noktalarına sahip olur.
Protokol, CLI'a sahip herhangi bir AI için çalışır — aynı paket formatı, aynı yanıt şablonu, aynı üç karar.
Kendi iş akışımda bu, AI tarafından oluşturulan kodda çalıştırmanız gereken güvenlik incelemesi→ ile doğal bir şekilde eşleşir.
Eğer katkıda bulunmak isterseniz, sonraki açık adımlar depoda belgelenmiştir: `--output-schema` ile yanıt formatının zorlanması, daha fazla CLI desteği eklenmesi ve halihazırda test ettiğim inceleyici-olarak-Codex yollarının ötesinde inceleyici-olarak-Claude senaryolarının oluşturulması.
Mesele ne?
AI modelleri arasındaki sınırlar gerçekler değil, uzlaşmalardır. İşbirliği mi yapacaklarına yoksa rekabet mi edeceklerine karar vermek bize kalmış. Eğer aynı kod tabanı üzerinde çalışan iki AI'ınız varsa ve birbirlerini incelemiyorlarsa, kodda gerçek hataları olduğu gibi bırakıyorsunuz demektir. AI akran inceleme becerisi, bunu düzeltmek için yapılandırılmış bir yoldur. Ücretsizdir, MIT lisanslıdır ve 30 saniyede kurulur. Gidin ve AI'larınıza bir iş arkadaşı verin.