GitHub pull request'lerini Codex ile inceleme

GitHub pull request'leri için yüksek değerli bir ek inceleme turu elde etmek üzere Codex kod incelemesini kullanın. Codex, pull request farkını inceler, deponuzun yönergelerini izler ve ciddi sorunlara odaklanan standart bir GitHub kod incelemesi yayımlar. Araştırma önizlemesinde sunulan Security Review, bir pull request'teki olası güvenlik sorunlarını daha ayrıntılı biçimde inceler.

Başlamadan önce

Şunlara sahip olduğunuzdan emin olun:

• Codex'e bağlı bir GitHub deposu. Eski entegrasyonun kurulumu için Codex Cloud (Eski) bölümüne bakın.
• Codex kod inceleme ayarlarına erişim.
• Codex'in depoya özgü inceleme yönergelerini izlemesini istiyorsanız bir AGENTS.md dosyası.

Codex kod incelemesini ayarlama

Otomatik incelemeleri yapılandırmak için bağlı bir GitHub deposuna ve depo ayarları üzerinde GitHub push veya yönetici iznine ihtiyacınız vardır.

1. GitHub deponuzu Codex'e bağlayın.
2. Codex ayarlarına gidin.
3. Deponuzu seçin, ardından Kodu incele altında Otomatik inceleme seçeneğini açın.

Codex incelemesi isteyin

1. Bir pull request yorumunda @codex review ifadesinden bahsedin.
2. Codex'in tepki vermesini (👀) ve bir inceleme yayımlamasını bekleyin.

dkundel-openaiyorum yaptı21 dakika önceYazar

@codex review

Codex, tıpkı bir ekip arkadaşı gibi pull request üzerinde bir inceleme yayımlar. GitHub'da Codex yalnızca P0 ve P1 sorunlarını işaretler; böylece inceleme yorumları yüksek öncelikli risklere odaklı kalır.

Otomatik incelemeleri etkinleştirin

Çekme istekleriniz için otomatik incelemeleri etkinleştirmek üzere Otomatik inceleme seçeneğini Codex ayarlarındaki Kişisel tercihler altında açın. İncelemelerin ne zaman çalışacağını İnceleme tetikleyicisi ile seçin. Bu ayar, kod incelemesi etkin olan depolar için geçerlidir ve @codex review yorumu gerektirmez.

Codex'in neleri incelediğini özelleştirme

Codex, deponuzda AGENTS.md dosyalarını arar ve geçerli kod inceleme kurallarını izler. Kuralların yönettiği koda en yakın dosyaya bir ## Code Review Rules bölümü ekleyin. Yararlı olduğunda ilgili denetimleri gruplamak için ### başlıklarını kullanın.

Örneğin bir deney raporlama hizmeti, gösterim sonrası davranışların karşılaştırma kohortunu değiştirmesini önleyebilir:

## Code Review Rules

### Experiment cohorts

- Do not filter treatment comparisons on post-exposure behavior, including conversion or retention.
  Safe path: build cohorts from assignment or exposure; report conversion as an outcome.

Depo genelindeki kuralları kök AGENTS.md dosyasına, hizmete özgü kuralları ise services/experiment_reporting/AGENTS.md gibi iç içe bir dosyaya yerleştirin. Codex, değiştirilen her dosyayı kapsayan kök ve daha özel yönergeleri uygular; böylece ilgisiz değişikliklerin hizmete özgü bağlamı taşıması gerekmez.

İnceleme yapanların sıkça açıkladığı denetimleri kodlayan iki veya üç kısa kuralla başlayın. Yararlı kurallar:

• Sonuç doğuran, depoya özgü davranışa odaklanın. İşaretlenecek uyumluluk kısıtını, veri sınırını veya güvenli olmayan yan etkiyi ve bunun neden önemli olduğunu açıklayın.
• Güvenli yolu veya istisnayı belirtin. Codex'e gerçek bir sorunu beklenen davranıştan ayıracak kadar bağlam verin.
• Kuralları kapsamı belirli ve kalıcı tutun. Değişebilecek işlev adları yerine sonuçları tercih edin ve yönergeleri yönettiği kodun yakınına yerleştirin.
• Mekanik denetimleri CI'a bırakın. Biçimlendirme, lint ve diğer belirlenimci denetimleri inceleme kurallarına eklemeyin.

Temsilî bir pull request açıp @codex review ile inceleme isteyin. Kuralları gördüğünüz bulgulara ve geri bildirimlere göre iyileştirin; gürültü üreten yönergeleri daraltın veya kaldırın.

Kod inceleme kuralları Codex'e yol gösterir; testlerin, dal korumalarının veya zorunlu onayların yerini almaz.

Tek seferlik bir odak için bunu pull request yorumunuza ekleyin:

@codex review for issues in the database migration

Güvenlik İncelemesi

Güvenlik İncelemesi, çekme isteklerindeki güvenlik sorunlarına özellikle dikkat etmek isteyen müşterilere yönelik ek bir incelemedir. Çekme isteği farkını, destekleyici depo bağlamını ve yapılandırılmış tehdit modellerini veya güvenlik yönergelerini analiz ederek güvenliğe özgü riskleri Kod İncelemesinden daha ayrıntılı inceler.

Kod İncelemesi, genel incelemesinin bir parçası olarak güvenlikle ilgili sorunları da belirleyebilir. Bu nedenle Kod İncelemesi ile Güvenlik İncelemesi bulguları arasında zaman zaman örtüşme görebilirsiniz.

Güvenlik İncelemesini ayarlayın

Daha ayrıntılı kurulum talimatları ve yapılandırma seçenekleri için Güvenlik İncelemesi sayfasına bakın.

1. GitHub deponuzu Codex'e bağlayın.
2. Codex ayarlarına gidin.
3. Deponuzu seçin. Güvenlik açıklarını incele altında Otomatik güvenlik incelemesi seçeneğini açın ve kimlerin çekme isteklerinin inceleneceğini İnceleme ile seçin. Tetikleyici ayarını Kod incelemesi her çalıştığında olarak belirleyerek Kod incelemesi ile birlikte çalışmasını sağlayın.

Güvenlik İncelemesi isteyin

Manuel olarak Güvenlik İncelemesi istemek için bir çekme isteğine şu yorumu ekleyin:

@codex security review

İnceleme sürerken Codex tepki verir, ardından güvenlik bulgularını doğrudan çekme isteğinde yayımlar. İlişkili Codex görevini açın ve tam raporu görüntülemek için Güvenlik Raporu sekmesini seçin.

İnceleme bulgularını ele alma

Codex bir inceleme yayımladıktan sonra aynı pull request'e başka bir yorum bırakarak sorunları düzeltmesini isteyebilirsiniz:

@codex fix the P1 issue

Codex, çekme isteğini bağlam olarak kullanarak eski bulut sohbetini başlatır ve gerekli izne sahipse dala bir düzeltme gönderebilir.

Codex'e başka görevler verme

Bir yorumda @codex ifadesini review dışında bir ifadeyle birlikte kullanırsanız Codex, çekme isteğinizi bağlam olarak kullanarak eski bulut sohbetini başlatır.

@codex fix the CI failures

Kod incelemesi sorunlarını giderme

Codex tepki vermez veya inceleme yayımlamazsa:

• Codex ayarlarında depo için kod incelemesini açtığınızı doğrulayın.
• Çekme isteğinin Codex'e bağlı bir GitHub deposuna ait olduğunu doğrulayın.
• Bir çekme isteği yorumunda tam olarak @codex review tetikleyicisini kullanın.
• Otomatik incelemeler için depo ayarlarındaki Otomatik inceleme seçeneğini ve Codex ayarlarındaki Kişisel tercihler bölümünü kontrol edin. Çekme isteği olayının inceleme tetikleyicisi ayarlarınızla eşleştiğini doğrulayın.