Günlük sprint raporu için yapay zeka ajanı: GitHub deponuz her sabah bir wiki'de özetleniyor

Yararlı bir sprint özeti kısa, tarihli ve günden güne karşılaştırılabilir olur. Üretmesi de zahmetlidir: depoyu açmak, birleştirilen pull request'leri saymak, incelemede bekleyenleri bulmak, issue'ları gözden geçirmek, bir sürümün yaklaşıp yaklaşmadığına bakmak ve kimsenin cilalamaya vakit bulamayacağı iki paragraf yazmak gerekir. Sonuç genellikle ya özetin hiç olmaması ya da toplantıdan hemen önce aceleyle hazırlanması ve engellerin geç fark edilmesidir. Bu, bir otonom yapay zeka ajanı için ideal bir görevdir: aynı şekilde tekrarlanır, zaten yapılandırılmış verilere dayanır ve tek bakışta doğrulanır.

İlham: kimsenin derlemediği sabah özeti

Çıkış noktası, otonom ajanlar kullanan kişilerin anlatılarında geçen bir kullanımdır: yazılım ekibinin araçlarını okuyan, olanları sayan ve her sabah bir sprint raporu bırakan ajanlar. Bu anlatılarda tekrar eden şey veri hacmi değil düzenliliktir: özet her gün aynı yapıyla vardır; böylece tek bir rakama tepki vermek yerine eğilimleri görebilirsiniz.

Atako bu fikri tek ajan ve tek sonuçla ele alır. Ajan GitHub'ı okur, hesaplar, yazar ve yayımlar. Depoda hiçbir şeyi değiştirmez; ürettiği tek şey rapordur.

Ajan ne yapar

Teslimat analisti, sizin sahip/ad biçiminde belirttiğiniz depoyu GitHub'da okur. Her çalışmada sabit bir yöntemi izler.

Önce bugünün tarihinden geriye doğru yedi günde birleştirilen pull request'leri, hâlâ açık olanları yaşlarıyla, üç günden uzun süredir incelemede bekleyenleri, açılan ve kapanan issue'ları ve yayımlanan sürümleri sayar. Sonra engelleri saptar: beş günden uzun süredir açık pull request'ler, aynı konuda biriken issue'lar, commit'lere bakılırsa geciken bir sürüm. Her birini bağlantısı ve yazarıyla belirtir. Son olarak önceki yedi günle karşılaştırır ve nelerin değiştiğini söyler.

Ardından projenin wiki'sinde, gün tarihinin eklendiği yeni bir «Sprint özeti - » sayfası yazar. Günün sayfası zaten varsa ikincisini oluşturmak yerine onu günceller. Yapı değişmez: önemli olan üç dört rakam, önceki döneme göre ilerleme, engeller ve sürüncemede kalan pull request'ler ve değerlendirilecek kararlar. Sonuçla başlar, iki dakikada okunur ve önemli noktaları sohbette özetler.

Ajan ne yapmaz

Analist okur, GitHub'a asla yazmaz: yorum, etiket, inceleme, birleştirme ya da kapatma yok. Kod göndermez. Kimseyle iletişime geçmez: rapor ve sohbet tek çıkış kanallarıdır. Asla bir rakam ya da bağlantı uydurmaz; eksik bir veri «mevcut değil» diye yazılır.

Her günün kendi sayfası vardır: ajan önceki bir günü asla ezmez, böylece ekibin yeniden okuyabileceği bir geçmiş kalır. Olgular yorumdan ayrılır ve yorum açıkça belirtilir. Rapor öncelikler önerir, ancak dayatmaz: insan onayı ilkesine dayalı bir tasarımın temeli budur.

Atako'da nasıl kurulur

Bu kullanım senaryosunun sayfasından dağıtım dört adımda tamamlanır.

1. GitHub'ı bağlayın. Atako istediğinde, izlenecek depoya okuma erişimi verin. Bağlantı, herhangi bir şey oluşturulmadan önce doğrulanır.
2. Bağlamınızı girin. Depoyu sahip/ad biçiminde ve raporun okurlarını belirtin; ton onlara göre ayarlanır.
3. Dağıtın. Tek bir işlem ajanı ve «Sprint özeti» projesini oluşturur. Ajan hazırlanır ve ilk talimatlarını kendisi alır.
4. İlk özet, sonra günlük ritim. Analist son yedi gün için ilk raporu üretir, ardından her sabah 8:00'deki çalışmasını kendisi planlar.

Henüz hesabınız yoksa hesap oluşturmak deneme sürenizi başlatır ve senaryo hemen ardından yapılandırılır. Yöneticiniz ajan oluşturmanıza izin vermediyse dağıtım bunu bildirir ve orada durur.

Sonuçları nerede görürsünüz

Rapor, «Sprint özeti» projesinin wiki'sinde, günde bir sayfa olacak şekilde, en yeniden en eskiye doğru durur. Ajanın özeti kendi sohbetine de düşer; böylece sayfayı açmadan önce önemli noktaları telefondan okuyabilirsiniz. Atako zemininde analist etkinliğiyle görünür: özetin hangi aşamada olduğunu sormadan, depoyu ne zaman okuduğunu ve ne zaman yazdığını görürsünüz.

Onunla sohbetinde konuşabilirsiniz. Bir rakamın nereden geldiğini sorun, bir engeli ayrıntılandırmasını, başka bir depoyu izlemesini ya da özeti farklı bir açıdan yeniden yapmasını isteyin. Ajan önceki çalışmalarını hatırlar.

Güvenceler

Erişim bilerek dardır ve salt okunurdur: depoları listelemek, bir depoyu okumak, pull request'leri listelemek ve okumak, issue'ları listelemek ve aramak, commit'leri ve sürümleri listelemek için sekiz GitHub aracı. Kısa bir araç listesi gören ajan, yüzlerce araçlık bir katalogda kaybolan ajandan daha güvenilir kullanır. Varsayılan olarak hiçbir şey verilmez ve her erişim Atako'dan istediğiniz an geri alınabilir.

İnsan onayı karar noktasındadır. Rapor engelleri ve sürüncemede kalan pull request'leri işaret eder; bir gözden geçireni hatırlatmaya, bir pull request'i bölmeye ya da bir sürümü ertelemeye ekip karar verir. Ajan yalnızca GitHub'ın verdiğini görür: açıklaması olmayan bir pull request veya etiketlenmemiş issue'lara sahip bir depo daha az kesin bir özet doğurur ve rapor bunu gizlemek yerine söyler.

Ne beklemeli

İlk özetin yararlı ama henüz genel olmasını bekleyin; sohbette okurları ve eşikleri, örneğin üç yerine iki gündür incelemede bekleyen pull request'leri işaretlemesini isteyerek ayarladığınızda kesinleşir. Değer tekrardan gelir: iki hafta sonra ardışık sayfalar karşılaştırma yapmanızı, hangi engelin sürdüğünü ve hangi eğilimin belirdiğini görmenizi sağlar. Küçük bir teknik ekip için bu, toplantı öncesinde hafızadan kurulan bir dökümle her gün aynı tanımlarla kendiliğinden var olan günlük bir özet arasındaki farktır.