Summary

Bu yapay zeka rapor oluşturucu, beş girdiden yola çıkarak - kod satırı sayısı, aktif katkıda bulunanlar, test kapsamı, kod tabanının yaşı ve tipleme stili - yeni bir mühendisin ilk anlamlı PR'ını ne kadar sürede açacağını ve kod tabanında çalışmanın ne kadar riskli olduğunu tahmin eder. Formül, yayınlanmış code review ve geliştirici anket araştırmalarına (Google/SmartBear review boyutu çalışmaları, Stripe'ın Developer Coefficient raporu) dayanan şeffaf bir sezgisel yaklaşımdır - kara kutu değil. Her şey istemci tarafında çalışır; kod tabanınla ilgili hiçbir şey hiçbir yere gönderilmez.

Kod tabanı rapor oluşturucu: onboarding süresi ve risk analizi

Kod satırı sayısını, test kapsamını, ekip büyüklüğünü ve yaşını gir. PR açıklamasına ya da Slack mesajına direkt yapıştırabileceğin sade bir rapor al - üyelik yok, sunucuya istek atılmıyor.

Şimdi dene

AI Kod Tabanı Rapor Oluşturucu

Kod tabanının istatistiklerini aşağıya gir. Rapor anlık güncellenir ve düz metin olarak kopyalayabilirsin.

Tahmini alışma süresi -
Kod tabanı risk puanı - -

Önce düzeltilmesi gerekenler

    Rapor nasıl hesaplanıyor

    Tahmine neler giriyor

    Boyut ve kapsam

    Onboarding süresi kod satırı sayısıyla birlikte artar ve test kapsamı %50'nin altına düştüğünde belirgin şekilde kötüleşir - reviewer'lar ve yeni gelenler, test suitine güvenmek yerine implementasyonu satır satır okumak zorunda kalır.

    Ekip kapasitesi

    5'ten az aktif katkıda bulunanı olan ekiplerde gayri resmi bir güvenlik ağı yoktur - sahibi belli olmayan bir soru bir gün boyunca DM'de bekler. 15 katkıda bulunanı geçtikten sonra mentorluk kapasitesi darboğaz olmaktan çıkar, darboğazın yerini kod tabanının kendisi alır.

    Yaş ve tipleme

    3-7 yılı geçen kod tabanları, yorumlara veya dokümantasyona hiç yansımamış örtük bilgi biriktirir: isimlendirme kuralları, kimsenin silmediği deprecated modüller, başka yerde düzeltilmiş bir hatanın workaround'ları. Statik tipleme (TypeScript, Go, Rust, Java), tipler dokümantasyon görevi de gördüğü için dinamik dillere kıyasla alışma süresini kısaltır.

    Bileti atamadan önce ortamı oku

    Risk puanı, ekibinle asıl darboğazların nerede olduğu konusunda bir sohbetin başlangıç noktasıdır, taşa kazınmış bir hüküm değil - bir sonraki işe alım başlamadan önce neyi düzelteceğine karar vermek için kullan, mühendisleri sıralamak için değil.

    Close-up of hands typing on a keyboard with a laptop screen showing blurred abstract report widgets

    Sıkça sorulan sorular

    Bu ücretsiz mi?
    Evet. Rapor oluşturucu tamamen tarayıcında çalışır - üyelik yok, ücretli duvar yok ve tahmini hesaplamak için sunucuya hiçbir veri gönderilmiyor.
    Bu referans değerler nereden geliyor?
    Formül, hakemli bir model değil, şeffaf bir sezgisel (heuristic) yaklaşımdır. Review boyutu tavsiyesi (PR'ları yaklaşık 400 satırın altında tutmak, kesintisiz okumanın yaklaşık 60 dakikadan sonra etkisini kaybetmesi) Google'ın mühendislik pratikleri dokümantasyonundan ve SmartBear/Cisco kod review çalışmasından geliyor. Kapsam ve teknik borç cezalarının büyüklüğü, mühendislerin haftalarının büyük bir kısmını kötü kod ve bakım işleriyle geçirdiğini ortaya koyan Stripe'ın Developer Coefficient raporundan besleniyor. Bunu bilerek bir sezgisel yaklaşım diyoruz - sayıyı kesin değil, yön gösterici olarak değerlendir.
    Kod tabanı verisi herhangi bir yere gönderiliyor mu?
    Hayır. Her girdi tarayıcında kalır ve hesaplama cihazında JavaScript ile çalışır. Tek ağ etkinliği, widget'ın ne sıklıkla kullanıldığını saymak için gönderilen, kod tabanı detayı içermeyen anonim bir tool-run ping'idir.
    Bu gerçek bir onboarding planının yerini tutuyor mu?
    Hayır. Sana planlamak için bir başlangıç sayısı verir - kabaca bir gün sayısı ve bir risk seviyesi. Bunu gerçek bir onboarding checklist'i, atanmış bir mentor ve kendi reponuzdan oluşturulmuş bir ilk hafta okuma listesiyle birleştir.
    Risk puanım neden beklediğimden yüksek çıktı?
    Onu en hızlı yükselten üç faktör: %30'un altında test kapsamı, 7 yıldan eski bir kod tabanı ve yüksek bir mühendis başına kod satırı oranı. Önce bu üçünü kontrol et - genelde bu çeyrekte gerçekten düzeltebileceğin şeyler bunlardır.
    Reposu birden fazla dil içeren bir monorepo ise ne olur?
    Hesaplamayı, yeni işe alınan kişinin gerçekten önce dokunacağı dil ve alan için yap, tüm monorepo için değil. Bir junior'ın sadece 40 bin satırlık tek bir serviste çalıştığı 2 milyon satırlık bir monorepo, tüm repo değil, o servis üzerinden puanlanmalı.
    Bunu code review kapasite planlaması için de kullanabilir miyim?
    Kısmen. Risk puanı review yüküyle ilişkilidir - yüksek riskli bir kod tabanı genelde daha yavaş ve daha maliyetli review'lar demektir - ama kendi metrik dashboard'unda ekibinin PR döngü süresini gerçekten ölçmenin yerini tutmaz.
    Risk puanı onboarding tahmininden nasıl farklı?
    Onboarding süresi, bir mühendisin ne zaman üretken hale geleceğini yanıtlar. Risk puanı ise kod tabanının genel olarak ne kadar kırılgan olduğunu yanıtlar - düşük test kapsamı ve yaşlanan, yoğunlaşmış bir kod tabanı, yıllardır orada olan mühendisler için bile riski artırır.

    Bu raporu bir onboarding sunumuna dönüştür

    Skywork, dağınık notları slaytlara, dokümanlara ve şemalara dönüştürür - yeni bir mühendis gelecek pazartesi başladığında kimsenin elle tasarlamaya vakti olmadığı onboarding paketi için işe yarar.