Peck - PR’leri kolayca açıklayan ve inceleme taslağı ile durumu gösteren macOS menü çubuğu uygulaması

Merhaba.

PR’lere bakarken değişiklikleri hızlıca anlamanın zor olduğu ya da benim incelemem gereken yorumları ve kendi PR’lerimin onay durumunu kaçırdığım anlar oluyordu; bu yüzden Peck adında bir macOS menü çubuğu uygulaması geliştiriyorum.

Peck

• Github: https://github.com/pecklabs/peck
• Hizmet tanıtımı: açılış sayfası URL’sini buraya girin

Neden yaptım?

• PR incelemesine başlarken en çok ihtiyaç duyulan şeyin, “bu PR neyi değiştiriyor?” sorusunu hızlıca anlayabilmek olduğunu düşündüm.
• Ancak pratikte diff’i açmak, dosyaları gözden geçirmek ve ilgili bağlamı takip etmek gerektiği için, incelemeye başlamadan önce bile epey zaman harcanıyor.
• Bir ölçüde anladıktan sonra da Approve vermenin mi uygun olduğu, sadece Comment bırakmanın mı yeterli olduğu, yoksa Request changes gerekip gerekmediğine karar vermek zaman alıyor.
  • Özellikle birden fazla depo arasında gidip gelirken ya da incelemeler biriktiğinde, bakmam gereken PR’leri gözden kaçırmak kolay oluyor.
  • Benim açtığım PR’lerde de GitHub’a doğrudan girmeden kimin onay verdiğini, kontrollerin başarısız olup olmadığını ya da çakışma çıkıp çıkmadığını sürekli takip etmek zahmetliydi.
  • Bu yüzden PR’leri kolayca açıklayan, inceleme taslağı oluşturan ve inceleme durumunu menü çubuğunda sürekli görmeyi sağlayan bir uygulama yaptım.

Başlıca özellikler

• GitHub PR listesini görüntüleme
  • İncelemem gereken PR’lerle benim açtığım PR’leri ayrı ayrı görme
  • Onay/kontrol/çakışma gibi durumları ikonlarla gösterme
• PR diff tabanlı kolay açıklama üretme
  • Değişiklikleri önce özetleyerek incelemeye başlamayı kolaylaştırma
  • Riskli görünen bölümleri ya da testin yetersiz olduğu kısımları birlikte gösterme
• AI inceleme taslağı oluşturma
  • Approve / Request changes / Comment seçeneklerinden hangisinin uygun olduğuna dair taslak oluşturma
  • Nihai inceleme, kullanıcı onayladıktan sonra GitHub’da yayımlanır
• GitHub kimlik doğrulaması
  • GitHub CLI girişi veya token tabanlı kimlik doğrulama
  • Kimlik bilgileri macOS Keychain’de saklanır
• Kişisel/ekip inceleme kuralları
  • İnceleme ölçütleri skill.md dosyasıyla belirlenip kullanılabilir

Henüz erken bir sürüm olduğu için, gerçek PR inceleme akışında hangi kısımların faydalı olduğunu görmek istiyorum.

PR’lere dair kolay açıklamaların incelemeye başlamada yardımcı olup olmadığı, AI inceleme taslağının fazla mı yetersiz mi kaldığı ve menü çubuğunda gösterilen bilgilerin yeterli olup olmadığı konusunda geri bildirim verirseniz sevinirim.