AI CodeOps

Reviewer ajanı

Reviewer ajanı önerilen değişiklikleri doğruluk, uç durumlar ve bakım kolaylığı açısından kontrol eder ve somut düzeltmeler listeler. Sekiz yerleşik iş akışında çalışır.

Reviewer ajanı, eleştirel ikinci göz çiftidir. Önerilen değişikliği okur ve doğruluk, anlaşılırlık, uç durumlar ve bakım kolaylığıyla ilgili sorunları arar. Somut sorunları ve her biri için somut bir düzeltmeyi listeler.

Nerede çalışır

İş akışıAdım
Plan, Build, Review & TestReview
Parallel ReviewCorrectness review
UI ImplementationCode review
Architecture DebateCritic review
Swarm InspectionReviewer slice
Release ReadinessCorrectness review
Data MigrationFinal review
Quality-Gated ChangeReview

Architecture Debate'te eleştirmen rolünü üstlenir: nihai sentezden önce Architect'ten gelen iki rakip tasarımı sorgular.

Adımının ne zaman çalıştığı iş akışına bağlıdır:

  • Kod yazıldıktan sonra. Plan, Build, Review & Test, UI Implementation, Data Migration ve Quality-Gated Change'de adımı, değişikliği uygulayan adımı izler. Bu yüzden kod yazılana ve projenin testleri çalışana kadar bekler ve o değişikliği inceler.
  • Kod geçişinden önce. Parallel Review, Swarm Inspection ve Release Readiness'ın uygulama adımı yoktur. Tüm adımları herhangi bir kod yazılmadan önce çalışır ve Reviewer, görevden ve repoda zaten bulunan koddan yola çıkar.
  • Hiç kod yok. Architecture Debate kendi belgeleriyle sona erer.

Girdiler

  • Oturumun görevi ve projenin reposundaki ilgili dosyaların salt okunur bir anlık görüntüsü.
  • Önceki adımlar: genellikle bir plan ve Builder'ın değişikliğe dair açıklaması.
  • Kod yazıldıktan sonra çalıştığında: diff olarak değişiklik (uzunsa sığacak şekilde kısaltılmış ve kesildiği yer işaretlenmiş) ve kaydedilen test sonucu. Okuduğu dosyalara atıf yapması istenir.
  • Çalışma alanı politikanız izin veriyorsa, bağlı MCP sunucularından gelen araçlar.

Çıktılar

Reviewer'ın adımı, düzeltmeleriyle birlikte bir sorunlar listesini metin olarak döndürür. Oturumun geri kalanını iki şekilde etkiler:

  • Sonraki adımlar onu okur. Kod geçişinden önce çalıştığında, kod geçişi de onu okur ve ona göre hareket edebilir. Kod yazıldıktan sonra çalıştığında, oturumdaki hiçbir şey değişikliği ona göre yeniden yazmaz: belirttiği noktalar için bir takip oturumu başlatın.
  • İş akışının adımlarından sonra oturum, gerçek diff'i inceleyen ve her birinde başlık, önem derecesi, kategori, öneri ve uygun olduğunda dosya bulunan yapılandırılmış bulgular kaydeden bir bulgu geçişi çalıştırır. Reviewer'ın analizi bu geçişe bağlam olarak verilir. Oturumda hiçbir Security Auditor çalışmadığında bulgular Reviewer'a atfedilir.

Bu bulgular oturumun ve çalışma alanının kalite sayfalarında görünür ve yayın kapısı, bir değişiklik yayına alınabilmeden önce onları kontrol eder. Bulgu incelemesi çalışamazsa kapı, sessizliği geçti olarak yorumlamak yerine değişikliği bekletir.

Auto kademesinde Reviewer'ın adımları önce Premium kademesine gider.

Örnek çalıştırma

Gösterim amaçlı bir örnektir, kaydedilmiş bir oturum değildir. Quality-Gated Change'de oturum, faturalar için yeni bir CSV dışa aktarımı yazar ve projenin testleri onun üzerinde çalışır. Ardından Reviewer diff'i okur ve dışa aktarma dosyasında üç şeye dikkat çeker: tutarlar sunucunun yerel ayarıyla biçimlendirilmiştir, bu yüzden virgüllü ondalık ayırıcı dosyayı bozar; müşteri adları kaçışlanmamıştır, bu yüzden virgül içeren bir ad tüm sütunları kaydırır; ve dışa aktarım tüm faturaları belleğe yükler. Sabit bir sayı biçimi, düzgün tırnaklama ve akış hâlinde bir yanıt önerir. Ardından bulgu geçişi aynı diff'i bu notları bağlam olarak alıp inceler ve bir takip oturumu düzeltmeleri yapar.

Sınırlar

  • Kod yazıldıktan sonra diff'i okur; uzun bir diff, kesildiği yer işaretlenerek sığacak şekilde kısaltılır. Bulgu geçişi de diff'i okur: yalnızca Reviewer'ın adımını değil, bulgu geçişinin bulgularını da okuyun.
  • Adımı kodu değiştirmez. Kod yazıldıktan sonra önerdiği bir düzeltme için bir takip oturumu veya bir bulgudaki Fix düğmesi gerekir.
  • Kodu çalıştırmaz. Davranış, verify adımında projenin testleriyle kontrol edilir ve sonucu Tester okur.
  • Her iki yönde de yanılabilir: gerçek bir hatayı kaçırabilir ve sorun olmayan bir şeyi işaretleyebilir. Bulgular oturumda triyajdan geçirilebilir.

Sık sorulan sorular

Reviewer ajanı nihai diff'i görür mü?

Çalıştığı sekiz iş akışından dördünde evet. Adımı değişikliği uygulayan adımı izlediğinde, kod yazılıp test edildikten sonra çalışır ve ona diff ile kaydedilen test sonucu gösterilir. Ardından oturumun bulgu geçişi aynı diff'i inceler ve değişikliği kapıda tutan bulguları kaydeder.

İnceleme bulguları bir merge'ü engelleyebilir mi?

Evet. Diff incelemesinden gelen bulgular oturuma kaydedilir ve yayın kapısı, değişiklik yayına alınabilmeden önce bu incelemeyi kontrol eder.