- Ana sayfa
- Öğrenme merkezi
- Yapay zekâ kod incelemesi
- Yapay zekâ kod incelemesi kontrol listesi: yapay zekânın yazdığı pull request'ler için 25 kontrol
Yapay zekâ kod incelemesi kontrol listesi: yapay zekânın yazdığı pull request'ler için 25 kontrol
Son güncelleme
Yapay zekânın yazdığı pull request'leri incelemek için yazdırılabilir 25 maddelik kontrol listesi: kapsam, kanıt, testler, doğruluk, güvenlik, bağımlılıklar ve onay.
Bir yapay zekâ ajanının yazdığı bir pull request'i incelerken bu 25 kontrolü kullanın. Ajanların yazdığı kod için en iyi işleyen sırayı izlerler: önce kapsam, sonra kanıt, sonra testler ve ancak ondan sonra kodun kendisi. Yazdırın, pull request şablonunuza yapıştırın veya bir sekmede açık tutun. Her grubun ardındaki gerekçe Bir yapay zekâ ajanının yazdığı kod nasıl incelenir sayfasındadır.
Kapsam
- 1. Değişiklik görevle örtüşüyor. Diff'ten önce görevi okuyun. Değişiklik isteneni, sizin talebi okuyacağınız şekilde yapıyor.
- 2. Fazladan hiçbir şey eklenmemiş. Gerçek değişikliğe karışmış, istenmemiş yeniden düzenlemeler, yeniden adlandırmalar, yeniden biçimlendirmeler veya "hazır buradayken" düzeltmeleri yok.
- 3. Hassas dosyalar bilerek değiştirilmiş. CI tanımları, bağımlılık manifest'leri, kimlik doğrulama, altyapı ve migration'lar yalnızca görevin gerektirdiği yerde değiştirilmiş.
- 4. Değişiklik incelenebilecek kadar küçük. Riskli kısımları düzgün okuyamıyorsanız, göz gezdirmek yerine görevin bölünmesini isteyin.
Kanıt
- 5. Testler tam bu sürüm üzerinde çalışmış. Son düzenlemeden önceki bir sonuç, onayladığınız kod hakkında hiçbir şey söylemez.
- 6. İlgili hiçbir şey atlanmamış. Yeşil bir durumun arkasında atlanmış test paketleri, filtrelenmiş test çalıştırmaları veya "no tests found" yok.
- 7. Otomatik bulgular triyajdan geçirilmiş. Açık yüksek önem dereceli bulgu yok ve reddedilen her bulgunun katıldığınız bir gerekçesi var.
- 8. "Doğrulanmadı" görünür. Testler çalışamadıysa pull request bunu söylüyor. Geçmiş gibi görünmüyor.
Testler
- 9. Hiçbir test silinmemiş veya kapatılmamış. Kaldırılan senaryolara, atlama işaretlerine ve yorum satırına alınmış testlere bakın.
- 10. Doğrulamalar gevşetilmemiş. Tam bir karşılaştırma, bir değerin var olduğunu veya doğru (truthy) olduğunu kontrol eden bir şeye dönüşmemiş.
- 11. Beklenen değerler uysun diye kaydırılmamış. Değişen anlık görüntülerin (snapshot) ve beklenen çıktıların görevde bulabileceğiniz bir gerekçesi var.
- 12. Yeni testler başarısız olabilir. Sonuçları doğrularlar, yalnızca sınırlarda mock kullanırlar ve değişiklik geri alınsaydı başarısız olurlardı.
Doğruluk
- 13. Her API ve paket gerçekten var. Fonksiyonlar, seçenekler ve paketler, lockfile'ınızın sabitlediği sürümlerde gerçekten mevcut.
- 14. Hatalar yutulmamış. Boş catch blokları yok; günlüğe yazılıp yok sayılan hata yok; boş bir sonuca dönüştürülen hata yok.
- 15. Sessiz geri dönüşler yok. Sıfır, boş bir dize veya boş bir liste gibi varsayılanlar başarısız bir aramayı gizlemiyor.
- 16. Uç durumlar ele alınmış. Boş ve eksik girdi, saat dilimleri, sayfalandırma, yeniden denemeler ve aynı anda gelen iki istek.
- 17. Yinelenen yardımcılar yok. Yeni bir yardımcı araç, kod tabanında zaten bulunan birini tekrarlamıyor.
- 18. Veri değişiklikleri güvenli. Migration'lar ekleyici veya geri alınabilir ve daha önce çalışmış hiçbir migration düzenlenmemiş.
Güvenlik
- 19. İzin kontrolleri komşularıyla örtüşüyor. Yeni uç noktalar ve eylemler yetkilendirmeyi benzer kodun yaptığı şekilde kontrol ediyor.
- 20. Güvenilmeyen girdi veri olarak kalıyor. Kullanıcı girdisinden oluşturulan SQL, shell komutu veya HTML yok ve diff'teki yorumlardan veya dosyalardan izlenen talimat yok.
- 21. Diff'te secret yok. Kodda, testlerde, fixture'larda veya günlük satırlarında anahtar, token, parola veya özel URL yok.
- 22. Güvensiz varsayılanlar yok. Kullanımdan kaldırılmış kriptografi, kapatılmış sertifika kontrolleri, açık CORS veya açık bırakılmış hata ayıklama anahtarları yok.
Bağımlılıklar
- 23. Her yeni bağımlılık yerini hak ediyor. Gerekli, bakımı süren, doğru yazılmış (benzer görünen bir ad değil) ve izin verdiğiniz bir lisansa sahip.
Onay
- 24. Prompt'u verenden başka biri onaylıyor. Görevi yazan kişi değişikliğin yazarıdır. Başka biri inceleyebiliyorsa o incelemeli.
- 25. Değişikliği açıklayabiliyorsunuz. Bozulduğunda nöbette olan kişiye karşı onu savunabilirsiniz. Onayladıktan sonra düzenlenirse yeniden onaylayın.
Bu kontrol listesini kullanmak
Kontroller en önemli oldukları yerde ucuzdur. 1-8 arası kontroller birkaç dakika sürer ve düzenli görünen kodun arkasına saklanan sorunları yakalar: kimsenin istemediği iş ve gerçek olmayan kanıt. 9-12 arası kontroller bilerek koddan önce gelir. Testleri geçirmesi istenen bir ajan testleri değiştirerek geçirebilir ve bu, kodda değil test diff'inde daha kolay görülür.
13-22 arası kontrolleri para, kimlik doğrulama, kişisel veri, izinler veya saklanan veriyle ilgili kodda eksiksiz okuyun. Üretilmiş veya mekanik dosyalarda hızlıca okuyun. Değişiklik 4. kontrolden geçemiyorsa orada durun: görevi bölmek, okunamayacak kadar büyük bir şeyi incelemekten daha hızlıdır.
Bir değişikliği reddettiğinizde hangi kontrolden geçemediğini yazın. Bu gerekçe, ister bir kişi ister bir ajan yapsın, bir sonraki deneme için en iyi girdidir.
AI CodeOps hangi kontrolleri otomatikleştirir
Bu kontrollerin bazıları hatırlanmak yerine zorunlu kılınabilir. AI CodeOps'ta:
- Kontrol 4: diff'i 60 KB'yi aşan bir değişiklik "Split the task into smaller changes" ile reddedilir.
- Kontrol 5 ve 8: projenizin testleri değişiklik üzerinde çalışır, bir sonuç yalnızca üzerinde çalıştığı sürüm için geçerlidir ve Quality gates paneli bir değişikliğin ne zaman doğrulanamadığını gösterir.
- Kontrol 7: yapay zekâ inceleyicisinin bulguları bir önem derecesi taşır ve yüksek veya daha üst önem derecesindeki açık bir bulgu, fixed, won't fix, false positive veya duplicate olarak işaretlenene kadar değişikliği engeller; onu acknowledged olarak işaretlemek yeterli değildir. Bkz. Kalite kapıları.
- Kontrol 3: bir çalışma alanı politikası,
infra/**gibi yollar altındaki değişiklikler için onay isteyebilir veya onları reddedebilir. - Kontrol 23: CI'ınızın çağırdığı yayın kapısı, projenin SBOM'unda izin verilmeyen bir lisans göründüğünde bir değişikliği reddedebilir.
- Kontrol 24 ve 25: başka biri onaylayabiliyorken oturumu başlatan kişi onay oyunu kullanamaz ve onaydan sonra bir değişikliği düzenlemek onu yeniden onaya gönderir. Bkz. Onaylar ve politikalar.
Geri kalanı bir kişi gerektirir. Kontrol listesinin amacı da budur: kapı kanıtı tutar, inceleyici değişikliği değerlendirir. İnceleme tarafının nasıl çalıştığını Çok ajanlı kod incelemesi gösterir.
Sık sorulan sorular
Her yapay zekâ pull request'inde 25 kontrolün hepsini çalıştırmam gerekir mi?
Kapsam, kanıt ve onay kontrollerini her birinde çalıştırın. Geri kalanını para, kimlik doğrulama, kişisel veri, izinler veya saklanan veriye dokunan değişikliklerde eksiksiz, mekanik değişikliklerde ise hızlıca çalıştırın.
Bu kontrol listesi yalnızca yapay zekâ ajanlarının yazdığı kod için mi?
Hayır. Kontrollerin çoğu her pull request için geçerlidir. Riskin stilden çok kapsam, kanıt ve testlerde yattığı, ajanların yazdığı kod için sıralanmışlardır.
Bu kontrol listesini wiki'mize veya pull request şablonumuza kopyalayabilir miyim?
Evet. CC BY 4.0 ile lisanslanmıştır; bu yüzden onu kopyalayıp uyarlayabilirsiniz. Kendi sürümünüzü yayımladığınızda bu sayfaya bağlantı verin.
Atıf yapın
AI CodeOps (2026). Yapay zekâ kod incelemesi kontrol listesi: yapay zekânın yazdığı pull request'ler için 25 kontrol. https://aicodeops.dev/learn/ai-code-review/checklist
Bu sayfa ve indirilebilir dosyaları CC BY 4.0 lisansıyla sunulur: ekibiniz için kopyalayıp uyarlayın ve kendi sürümünüzü yayımladığınızda bu sayfaya bağlantı verin.
İlgili içerikler
- Bir yapay zekâ ajanının yazdığı kod nasıl incelenir
- Yapay zekâ kod incelemesi nedir?
- Onaylar ve politikalar
- Kötü merge'leri engelleyen yapay zekâ kod incelemesi
- Yapay zekânın ürettiği kod nasıl incelenir: 25 maddelik kontrol listesi
- Hata durumunda açık mı, kapalı mı: kalite kapıları hataları nasıl ele almalı
- Öğrenme merkezinin tamamı