Kod incelemesi

Verdent, tek görevi kodunuzu incelemek olan Reviewer adında yerleşik bir alt aracı içerir. Yazmayı bitirdikten sonra yalnızca @Reviewer etiketleyin; değişikliklerinizi birden çok açıdan tarayarak önem derecesine göre sıralanmış, yapılandırılmış bir sorun listesi sunar. Düzeltmek istediğiniz herhangi bir öğeye tıklayın; değişiklikleri otomatik olarak uygular—yorum yazmanıza ya da belgeleri manuel olarak aramanıza gerek yoktur.

Kod incelemesi nasıl tetiklenir

En doğrudan yol, bir grup içinde bir takım arkadaşınızı etiketler gibi sohbete @Reviewer yazmaktır:

@Reviewer please review the authentication logic I just wrote

Reviewer mevcut bağlamı otomatik olarak okur ve incelemeye başlar. Ayrıca herhangi bir talimat vermeden yalnızca @Reviewer çağırabilirsiniz—neyi inceleyeceğine kendisi karar verir.

Manuel tetiklemenin yanı sıra, aracı, iş akışında son bir VERIFY adımı olarak Reviewer'ı otomatik olarak çağırabilir. Kod yazıldıktan sonra bununla uğraşmanıza gerek kalmaz—sistem, sonucu doğrulamak için Reviewer'ı devreye sokar.

İnceleme çıktısı nasıl görünür

İnceleme sonrasında yapılandırılmış bir Findings listesi görürsünüz. Her öğe şunları içerir:

• Başlık — sorunun tek satırlık açıklaması
• Ayrıntılı açıklama — neden bir sorun olduğu ve olası etkisi
• Dosya yolu + satır numarası — doğrudan koda atlamak için tıklayın
• Güven skoru — Reviewer'ın ne kadar emin olduğu (0–1)

Sorunlar üç önem düzeyine ayrılır:

Üstte, P0: 1 / P1: 3 / P2: 5 gibi bir özet, önem derecesi dağılımına anlık bir genel bakış sunar. Sonda ise bir overall_explanation, değişikliklere üst düzey bir değerlendirme sağlar.

Tek tıkla düzeltme

Her sorunu manuel olarak düzenlemeye gerek yoktur. Her Finding bir onay kutusu içerir:

1. Düzeltmek istediğiniz sorunları seçin (tümünü seçme desteklenir)
2. Fix tıklayın
3. Reviewer değişiklikleri otomatik olarak uygular
4. Durum Fix done olarak güncellenir

Bazı durumlarda, Reviewer değişikliklerin düşük riskli olduğuna karar verirse, tüm sorunları otomatik olarak seçip onay gerektirmeden düzeltmeyi tetikleyebilir.

Çoklu modelle iş birlikli inceleme

Reviewer'ın en güçlü özelliklerinden biri çoklu modelle kod incelemesidir—birden çok yapay zeka modelinin aynı kodu paralel olarak incelemesi, tıpkı farklı geçmişlere sahip üç mühendisin uygulamanızı bağımsız olarak değerlendirmesi gibidir.

Nasıl etkinleştirilir

Settings → Chat → Reviewer → "Multi-model review" seçeneğini etkinleştirin adımlarını izleyin.

Model seçim modları

En fazla 3 model seçebilirsiniz. İlki birincil inceleyicidir; diğerleri ikincil inceleyicilerdir. Daha fazla model daha geniş kapsam anlamına gelir ancak yürütme daha yavaştır. Basit değişiklikler için genellikle tek bir model yeterlidir.

İnceleme kuralları (özel inceleme politikaları)

Reviewer varsayılan olarak birçok yaygın sorunu yakalar, ancak her ekibin kendi standartları vardır. Review Rules, mühendislik yönergelerinizi doğrudan tanımlamanıza olanak tanır.

Nerede yapılandırılır

Settings → Chat → Reviewer → Review Rules düzenleyicisi (Markdown destekli Monaco düzenleyici).

Neler tanımlayabilirsiniz

• Tüm SQL sorguları parametreli ifadeler kullanmalı, dize birleştirme yapılmamalı
• Asenkron işlemler uygun try/catch hata işleme içermeli
• React bileşenleri, props kararlı olduğunda memo kullanmalı
• Tüm genel API'ler kullanıcı izinlerini doğrulamalı

Bu kurallar otomatik olarak Reviewer'ın bağlamına eklenir ve her incelemede kontrol edilir. Güncellemeler yaklaşık 500 ms sonra otomatik olarak geçerli olur—manuel kaydetme gerekmez.

Gerçek zamanlı iş akışı

İnceleme sırasında Reviewer'ın Working Tree Stream'ini gerçek zamanlı olarak gözlemleyebilirsiniz—hangi dosyayı okuduğunu ve hangi mantığı analiz ettiğini gösterir. Genişlettiğinizde tam bir görev ağacı ortaya çıkar. Daha basit bir görünüm tercih ederseniz, sonuçları etkilemeden daraltabilirsiniz.

Kullanım senaryoları

Son kalite kontrolü

Karmaşık mantık uyguladıktan sonra, yorgunluk nedeniyle gözden kaçırmış olabileceğiniz uç durumları ve ince hataları yakalamak için @Reviewer çalıştırın.

PR öncesi doğrulama

Pull request göndermeden önce bir inceleme çalıştırın. İleri geri yazışmaları azaltmak ve takım arkadaşlarınızın inceleme yükünü hafifletmek için önce tüm P0/P1 sorunlarını düzeltin.

Güvenlik denetimi

Her değişikliğin güvenlik politikalarına göre otomatik olarak kontrol edilmesini sağlamak için güvenlik odaklı Review Rules ekleyin (ör. "tüm girdiler XSS açısından temizlenmeli").

Ekip standartlarını uygulama

ESLint kurallarını, API tasarım kurallarını ve adlandırma standartlarını Review Rules içine kodlayın; böylece yeni katkıda bulunanlar bile ekip yönergelerini otomatik olarak takip etsin.

Çok perspektifli mimari kararlar

Büyük değişiklikler için, bağımsız değerlendirmeler almak ve kör noktaları ortaya çıkarmak amacıyla çoklu model incelemesini etkinleştirin.

Yeni başlayanlar için öğrenme aracı

Reviewer geri bildirimlerini öğrenme materyali olarak kullanın—P0 sorunlarının neden önemli olduğunu anlamak, belge okumaktan daha hızlı şekilde temel mühendislik ilkelerini öğretir.

Notlar

• Tek model mi çoklu model mi: çoklu model daha geniş kapsam sağlar ancak daha yavaş ve daha pahalıdır. Basit veya acil görevler için tek model genellikle yeterlidir.
• Ücretsiz katman kısıtlaması: User mode'daki ücretsiz kullanıcılar yalnızca Eco Mode havuzundan model seçebilir; premium modeller abonelik gerektirir.
• Model kullanımdan kaldırma: seçili bir model emekliye ayrılırsa devre dışı bırakılır ve değiştirilmesi gerekir.
• Review Rules globaldir: tüm projelerde geçerlidir. Bir kural projeye özelse, bir not ekleyin veya kullandıktan sonra kaldırın.
• BYOK durumu: kendi API anahtarınızı kullanıyorsanız, süresi dolmuş veya yetersiz bakiye ilgili modelleri devre dışı bırakır ve güncellenene kadar inceleme hatalarına yol açar.

Ayrıca bkz.