Kadrolar

Kadro, bir işi birlikte yapan agent'lardan oluşan bir ekiptir. Bir kartı ya da bir soruyu tek bir agent'a değil kadroya verirsiniz. Kadronun koordinatörü işi adımlara böler, her adımı o işe uyan üyeye verir, bir üyenin yazdığını başka bir üyeye eleştirtir ve sonucu toparlar. Mesela bir araştırmacı, bir yazar ve bir editörden oluşan içerik kadrosu bir blog yazısını araştırmadan başlayıp yazıya ve düzeltmeye kadar götürür.

Kadronun bir de ortak talimatı vardır. Talimatı kadroya bir kez yazarsınız ve kadrodaki her agent onu kendi talimatının başında alır; koordinatör de onu kadronun çalışma kuralı olarak okur. Hangi işin araştırmayla başlayacağı ya da kimin kimi eleştireceği gibi kararları buraya yazarsınız.

#Ne zaman işe yarar

Kadro iki durumda işe yarar. Birincisi, bir iş birden çok uzmanlık istediğinde: araştırma, yazım ve eleştiri ayrı agent'lardaysa kadro onları tek işte buluşturur ve üyeler birbirinin çıktısını görür. İkincisi, aynı projenin farklı depolarına bakan kodlama agent'ları aynı kuralları paylaştığında. "Bu depoda şu biçimde commit mesajı yaz, testleri atlamadan bitir" gibi bir kuralı kadroya bir kez yazarsınız; deponun kendine özgü kısımlarını (hangi çerçeve, hangi klasör düzeni) her agent kendi görev tanımında tutar.

Kadro agent'ların ayarlarını değiştirmez. Agent'ın modeli, sıcaklığı, hangi bağlantılara erişebileceği ve hangi araçları kullanabileceği her zaman agent'ın kendi ayarıdır. Aynı kadrodaki iki agent farklı modellerle çalışabilir.

#Kadroya kart vermek

Bir kartı tek bir agent'a vermek yerine bütün kadroya verebilirsiniz. Kartın Atanan seçicisinde kadrolar listenin en üstünde ayrı bir grup olarak durur; yeni kart formunda da aynı liste vardır. Bir yorumda @squad.kadro-adi yazarsanız kart o kadroya geçer ve çalışmaya başlar.

Kadroya verilen kartı bir koordinatör yürütür. Koordinatör kadronun ortak talimatını brifing olarak okur, işi checklist maddelerine böler ve her maddeyi kadrodaki bir üyeye verir. Üyeler yalnız kendilerine verilen maddeleri işaretler, kartın çıktılarını ve çalışma notunu birlikte görür. Koordinatör işi yalnız kadronun üyelerine verebilir; kadro dışından bir agent ya da geçici bir yardımcı çağıramaz.

Kadroda Orbi'de çalışan iki ya da daha çok üye varsa bir üyenin ürettiği işi başka bir üye eleştirir: somut kusurları sayar, üretici düzeltir. Bir üye kendi işini eleştiremez, bir turda en fazla iki eleştiri yapılır ve her eleştiri adım izinde görünür. Üretilen iş hiç eleştirilmeden tur kapanmak isterse Orbi bir kez durdurup eleştiriyi ister. Bunun için ayrı bir ayar yoktur, kadronun doğal çalışma biçimidir.

Kart yüzünde tek avatar yerine kadronun en fazla üç üyesi üst üste görünür, fazlası "+N" ile yazılır. Kart çalışırken o an iş yapan üyenin avatarının çevresinde bir halka yanar. Kartın çekmecesinde atanan bölümü kadronun adını ve üyelerini listeler. Pano filtresinde de kadroyu seçip yalnız onun kartlarını görebilirsiniz.

Kadro kartı daha çok ajan çalıştırdığı için kartın ajan koşusu tavanı kadrodaki üye sayısıyla çarpılır.

#Kadro kartını okumak

Kadronun çalıştığı kartın Özet sekmesi yukarıdan aşağı okunur. En üstte kartın açıklaması, altında Sonuç durur: kadronun özeti, bağlı PR'lar, son rapor ve checklist. İz sekmesindeki Kim ne yaptı adımları sırayla anlatır: "Kod ajanı kodu yazdı", "Reviewer kodu inceledi · düzeltme istedi" gibi. Her adımın altında o işin tek satırlık sonucu yazar; satıra basınca üyenin hangi cihazda, hangi depoda ve dalda çalıştığını ve ayrıntısını görürsünüz. Koordinatörün yorumları kadronun adıyla imzalanır. Bir eleştiri adımına basınca eleştirinin tam metnini okursunuz.

Koordinatörün sorusu. Koordinatör sizin cevabınız olmadan ilerleyemiyorsa tek bir ajan gibi soru sorar. Soru "❓" ile başlayan ve kadronun adıyla imzalı bir yorum olarak görünür, kart incelemeye döner ve durum satırı Cevap bekliyor der. Cevabınızı yorum olarak yazın, kimseyi anmanız gerekmez: kart kadroya geri döner ve yeniden kuyruğa girer. Başka bir ajanı ya da kadroyu anan yorum onlara gider, kartı sorudan sonra birine atadıysanız kart o kişide kalır. Cihazında çalışan üyelerin işi sürerken koordinatör soru sormaz, önce onların bitmesini bekler.

Çıktılar sekmesinde her çıktı tek bir belgedir ve en son değişen en üstte durur. Bir üye yazıyı düzelttiğinde ya da koordinatör raporunu güncellediğinde yeni sürüm eskisinin yerine geçer. Belgenin başlığında sürüm numarası, yazarı ve durumu görünür: Onaylandı, Düzeltme istendi ya da Son hali incelenmedi. Son hali incelenmemiş bir belge varsa Özet sekmesindeki Sonuç bölümü de bunu yazar. Nasıl bu hale geldi bölümü sürümleri ve aralarındaki eleştirileri yeniden eskiye sıralar. Eleştiriye basınca tam metni açılır, bir sürümde Değişiklikler'e basınca önceki sürüme göre çıkarılan metin kırmızı üstü çizili, eklenen metin yeşil görünür. Böylece eleştirinin uygulanıp uygulanmadığını tek bakışta görürsünüz.

Araştırma, brifing ve inceleme notları Ara çıktılar başlığı altında, teslimlerin altında kapalı durur. Bunlar kadronun yazıyı hazırlarken kullandığı malzemedir; eleştirilmez ve kartın sonucu sayılmaz. Hangi adımın teslimi yazdığına, hangisinin ona malzeme verdiğine koordinatör işi bölerken karar verir; checklist'te her maddenin yanında "teslim" ya da "ara çıktı" yazar. Üyeler de bu planın tamamını görür, böylece araştırmacı not yazar, yazar da yazıyı kendi kurgusuyla yazar. Bir üyenin checklist maddesi de ancak o üye kendi işini yaptığında tamamlanır; koordinatör onu üye adına kapatamaz.

#Kadronun ortak bilgisayarı

Ajanların kendi bilgisayarında çalıştığı çalışma alanlarında (Ajanın kendi bilgisayarında çalışan iş) kadro kartı da bilgisayarda çalışabilir. Koordinatör işin bilgisayar gerektirdiğine karar verirse kart için tek bir bilgisayar açılır ve üyeler aynı klasörde aynı anda çalışır. Her üye kendi modeli, kendi talimatı ve kendi izinleriyle çalışır; koordinatör her üyeye hangi dosyaların onun olduğunu söyler, üyeler birbirinin dosyasını değiştirmez. Kartın izinde her adım onu yapan üyenin adıyla görünür. Durum satırındaki durdurma bütün kadroyu durdurur, karta yazdığınız yorum çalışan her üyeye ulaşır. Kadro sıra beklerken tek bilgisayar sayılır. Modeli bilgisayardan çağrılamayan bir üye işini eskisi gibi Orbi'de yapar.

#Cihazda çalışan üyeler

Kadroda kendi cihazında çalışan bir kodlama agent'ı varsa koordinatör ona kartın bir parçasını verir ve hangi depoda çalışacağını üyenin depo listesinden seçip açıkça yazar. Üyenin birden çok deposu varsa ve kart hangisi olduğunu söylemiyorsa koordinatör tahmin etmez, karta soruyu yazıp kartı incelemeye çeker.

Üyenin işi kart üstünde ayrı bir koşudur. O depoya sahip bir cihaz koşuyu alır, üye kendi dalında çalışır, pull request'ini karta bağlar ve koşusunu kapatır. Kart bu sırada "çalışıyor" kalır ve panoda hangi üyenin hangi cihazda çalıştığı kartın üstünde yazar. Henüz hiçbir cihazın almadığı koşu "cihaz bekliyor" diye görünür.

Kodu yalnız kendi cihazında çalışan başka bir üye inceler, çünkü Orbi'de çalışan üye kodun dalını açamaz. Kadroda cihazda çalışan tek üye varsa inceleme size düşer: kart incelemeye gelir ve yorumda PR'a bakmanız istenir. Agent'lar sayfası böyle bir kadroyu uyarır. Bir parça diğerine bağlıysa (örneğin web tarafı API'deki yeni ucu kullanacaksa) koordinatör önce API'yi yaptırır, sonra web'i API'nin PR'ıyla birlikte başlatır.

Son üye koşusu bitince koordinatör kendiliğinden uyanır, üyelerin sonuçlarını okur, işi bütünleştirir ve kartı incelemeye çeker. Deposu hiçbir cihazda kurulu olmayan bir üyeye iş açılmaz; koordinatör hangi deponun eksik olduğunu yorumda yazar ve kartı incelemeye çeker. Depo bir cihazda kuruluysa ama o cihaz uzun süre işi almazsa koşu zaman aşımında kapanır ve o üyenin açık maddeleri sebebiyle hata olur; koordinatör kalan işi bitirir.

#Kadroyla konuşmak

Kadroya kart vermeden de onunla konuşabilirsiniz. Bir kanalda @squad.kadro-adi yazın ya da Sohbet ekranında yeni sohbet açarken Kadrolar bölümünden kadroyu seçin. İkisinde de kadronun koordinatörü isteği okur ve yalnız işe yarayacak üyeleri çalıştırır; ilgisi olmayan üye konuşmaya girmez.

Konuşma herkesin görebileceği biçimde akar. Koordinatör bir üyeye iş verdiğinde bunu gerekçesiyle bir satır olarak yazar: "→ @agent.arastirmaci: kaynakları o tarar". Her üye kendi adıyla cevap verir. Kadroda iki ya da daha çok üye varsa üretilen işi başka bir üye eleştirir ve eleştiri Eleştiri etiketiyle ayrı görünür. Sonunda koordinatör kadro adına tek başına okunabilir bir cevap yazar. Cevaptaki işi başka bir üye incelemediyse cevabın altında bunu söyleyen bir not çıkar. Notu Orbi o turdaki eleştiri kaydına bakarak koyar, cevabın ne dediğine bakmaz. Cevap "doğrulandı" dese bile not görünür.

Kanal kalabalıklaşmasın diye kadronun bütün mesajları tek bir blokta toplanır. Blok kapalıyken yalnız soru ve kadronun son cevabı görünür; Tartışmayı göster ile iş verişleri, üye cevaplarını ve eleştiriyi sırayla okursunuz. Kadro çalışırken blok çalışıyor der. Cevaplar arka planda üye üye gelir, sayfada beklemeniz gerekmez.

Konuşmayı sürdürmek için bloktaki Kadroya yanıt yaz düğmesine basın. Yazma kutusunun üstünde mesajın kadroya gideceği yazar ve kadroyu yeniden etiketlemeniz gerekmez. Kanala etiketsiz yazdığınız sıradan bir mesaj kadroya gitmez. Birebir sohbette muhatap zaten kadrodur, her mesaj ona gider.

Kadro konuşmada da araçlarını kullanır: dosya ya da kayıt yazabilir. Konuşmada kart açmaz; konuşmanın işi için kartı Görev olarak kaydet açar. Yeni bir koleksiyon ya da akış gibi baştan bir şey kurmadan önce onay ister. Onay kartı bunu isteyen üyenin mesajının altında durur, siz onaylayınca gösterilen haliyle kurulur ve sonucu kadroya yazılır. Birebir kadro sohbeti yalnız sizindir ve workspace akışında görünmez.

İş konuşmayla bitmiyorsa bloktaki Görev olarak kaydet düğmesini kullanın. Seçtiğiniz projede kadroya atanmış bir görev açılır ve Yapılacaklar'da başlar. İstek, kadronun son cevabı ve konuşmaya dönen bağlantı açıklamaya yazılır. Üyelerin yazdıkları Çıktılar sekmesine gelir: son cevabı veren üyenin yazısı teslimdir, aynı üyenin düzeltmeleri onun sürümleridir, diğer üyelerin notları ara çıktıdır. Eleştiriler dahil konuşmanın tamamı da ara çıktı olarak eklenir. Kuyruğa almak ayrı bir adımdır, çünkü görev koşusu kredi harcar. Konuşmayı bitir konuşmayı kapatır; kadroyu yeniden etiketlerseniz yeni bir konuşma açılır.

Kadroda kendi cihazında çalışan bir kod ajanı varsa o üye konuşmaya katılmaz: kod değişikliği dal ve PR ister, bunlar da bir karta bağlanır. Koordinatör o parçayı cevabında söyler; Görev olarak kaydet ile açtığınız görevde kod ajanı işini alır.

#Birebir kadro sohbetinde model, dosya ve bilgisayar

Birebir kadro sohbetinin yazma kutusu agent sohbetindekiyle aynıdır. Ataç düğmesiyle mesaja dosya eklersiniz. Yalnız okuyabildiğiniz alanlardaki dosyalar eklenebilir, eklenen dosya da mesajın altında görünür. Model seçiciden bir model seçerseniz o mesajın turunda koordinatör ve kadronun bütün üyeleri o modelle çalışır; üyelerin kendi model ayarı o mesaj için geçmez. Seçici açıkken yazma kutusunun altında bu yazar, mesajınızın altında da hangi modelin seçildiği görünür. Üyelerin kendi modeli seçeneği her üyeyi kendi modeline döndürür.

Ajanların kendi bilgisayarında çalıştığı çalışma alanlarında (Ajanın kendi bilgisayarında çalışan iş) kadro sohbeti de bilgisayarı kullanır. "Bir tablo, bir Word belgesi ve bir PDF hazırla" gibi bir iş gelince koordinatör sohbet için tek bir bilgisayar açar ve işi üyelere paylaştırır. Üyeler aynı klasörde aynı anda çalışır, her biri işini bitirince kendi adıyla yazar. Ürettiği dosyayı da o üye sohbete ekler. Eklediğiniz dosyalar bilgisayarda hazır bulunur. Üyeler çalışırken yazdığınız mesaj çalışan üyelere hemen ulaşır. Bir üye soru sorarsa soru sohbete düşer ve yazma kutusunun üstündeki satır cevap bekliyor der. Cevabınız aynı bilgisayarda o üyeye gider. Bilgisayar konuşma sürdükçe açık kalır ve 20 dakika sessizlikte kapanır. Sonraki mesaj aynı klasörle devam eder. Kısa bir soru bilgisayar açmadan cevaplanır. Kredi her üyenin kendi kullanımıyla düşer. Kanaldaki kadro konuşması da bilgisayarı aynı biçimde kullanır. Kanalı herkes okuduğu için bilgisayar kanal adına çalışır: kimsenin kişisel bağlantısı kullanılmaz, bilgisayara yalnız kanalın bütün okurlarının görebildiği dosyalar iner ve kredi çalışma alanından düşer (Kanalda).

Turu çalıştıran Orbi süreci iş ortasında durursa tur kaybolmaz. Birkaç dakika içinde sohbete Tur yarıda kaldı, yeniden başladı satırı düşer ve kadro aynı mesajı baştan cevaplar. Mesajınız bir kez cevaplanır, bilgisayardaki klasör ve üyelerin o ana kadar yazdıkları da durur. Bilgisayar için kredi yine bir kez düşer. Yeniden başlayan tur da yarıda kalırsa blok tamamlanamadı der, mesajınızı yeniden yazarak tekrar deneyebilirsiniz.

#Ortak talimat, agent'ın kendi talimatıyla nasıl birleşir

Bir agent kadroya girdiğinde etkin talimatı iki parçadan oluşur: önce kadronun ortak talimatı, hemen altında agent'ın kendi görev tanımı. Agent'ın kendi metni altta durur, yani ikisi aynı konuda çelişirse agent'ın kendi cümlesi geçerli olur. Böylece kadronun genel kuralını uygularken tek bir agent için istisna tanımlayabilirsiniz.

Agent'ın detay sayfasında kadro seçicisinin hemen altında kadronun ortak talimatı salt okunur ve katlanmış durur, başlığa tıklayınca açılır. Kendi metninizi yazmadan önce agent'ın davranışının diğer yarısının nereden geldiğini görürsünüz.

#Kadro oluşturmak ve düzenlemek

Kadroları Agent'lar sayfasından yönetirsiniz; listenin kendisi zaten kadro başlıklarından oluşuyor. Sayfanın üstündeki Kadro aç düğmesiyle yeni bir kadro kurarsınız: bir ad, isteğe bağlı kısa bir açıklama ve ortak talimat metni yazarsınız. Var olan bir kadroyu düzenlemek için başlığının sağındaki üç nokta menüsünden Kadroyu düzenle'yi seçersiniz.

Düzenleme ekranı kadronun üyelerini ve her üyenin açıklamasını da gösterir. Koordinatör işi kime vereceğine yalnız bu açıklamalara bakarak karar verir, talimatlarını okumaz. Açıklaması boş olan üyenin yanında bir uyarı çıkar: koordinatör o üyeyi "(açıklama yok)" olarak görür ve hangi işi aldığını bilemez, bu yüzden ajanın sayfasından tek cümlelik bir açıklama ekleyin.

Ortak talimatı değiştirip kaydettiğinizde kadrodaki her agent aynı anda güncellenir. Kadroda agent varsa, kaydetmeden önce kaç agent'ı etkileyeceğinizi söyleyen bir uyarı görürsünüz. O an sürmekte olan bir iş eski talimatla biter, bir sonraki iş yeni talimatı kullanır.

Kadro açmak ve düzenlemek yalnızca Admin rolündeki üyelere açıktır.

#Bir agent'ı kadroya eklemek ya da çıkarmak

En hızlı yol Agent'lar sayfasıdır: agent satırının sağındaki üç nokta menüsünden gideceği kadroyu seçersiniz. Agent'ın halihazırda bulunduğu kadro menüde işaretli ve seçilemez durumdadır; kadrolu bir agent'ta ayrıca Kadrodan çıkar seçeneği bulunur. Bu yol tek tıkla sonuçlanır, agent'ın detay sayfasını açmanız gerekmez.

Agent'ın detay sayfasındaki Tanım sekmesinde de, görev tanımının üstünde bir kadro seçicisi vardır. Oradan yaptığınız değişiklik kaydettiğinizde geçerli olur.

Kadrolu bir agent'ı detay sayfasından kadrodan çıkarırken ya da başka bir kadroya taşırken Orbi size sorar: ortak talimat artık uygulanmayacak, metnini agent'ın kendi görev tanımının başına kopyalamak ister misiniz? Kopyalarsanız agent aynı davranışı sürdürür; kopyalamazsanız ortak talimat o agent için sessizce düşer.

#Agent'lar sayfasında kadrolar

Agent listesi başlıklar altında gruplanır: her kadronun kendi başlığı, altında o kadrodaki agent'lar sıralanır. Başlığa tıklayınca grup katlanır ya da açılır; hangi grupları kapattığınız tarayıcınızda hatırlanır.

En üstte Sistem başlığı ve altında Orbi durur. Orbi bir kadroya alınamaz, başka bir kadroya taşınamaz; listede diğerleriyle aynı dille görünür ama kadro değildir. Hiçbir kadroya girmemiş agent'lar en altta Kadrosuz başlığı altında toplanır.

#Kadro yazarken ve seçerken de görünür

Bir metin kutusuna @agent. yazıp öneri listesini açtığınızda her agent'ın kadrosu adının altında görünür. Aynı ünvanı taşıyan iki agent'ı çoğu zaman ancak kadrosu ayırır. Yazdığınız mention'ın üstüne geldiğinizde açılan kartta da kadro adı yer alır.

Agent seçtiğiniz her yerde aynı satır sizi karşılar: kartın atanan seçicisinde, yeni kart formunda, sohbet başlatma listesinde, koleksiyonun agent sütununda ve akış tuvalinin sol paletinde. Adın altındaki küçük satır önce kadroyu, sonra ünvanı yazar. Kadrosuz agent'ta satır eskisi gibi yalnız ünvanı taşır. Akış paletindeki arama kutusu kadro adını da bulur: "Pazarlama" yazdığınızda o kadronun agent'ları listelenir.

#Kadro silinirse

Bir kadroyu sildiğinizde içindeki agent'lar silinmez, yalnızca kadrosuz kalır ve o andan sonra ortak talimat onlara uygulanmaz. Silme onayı, kaç agent'ın etkileneceğini önceden söyler. O kadroya verilmiş kartlar Orbi'ye kalır ve bir sonraki koşuda Orbi tarafından yürütülür.