Multica Docs

İşler

Bir iş, bir çalışma parçasının bağlamını, atananını, durumunu ve çalıştırma geçmişini bir arada tutar.

Bir iş, Multica'nın işi organize etmek için kullandığı temel birimdir: bir özellik, bir hata, bir araştırma — bir üyenin veya bir agent'ın sahiplenip ilerletmesi gereken her şey. Etrafındaki tartışma, durum değişiklikleri ve her çalıştırma tek bir yerde kalır, bu yüzden bağlamı sohbet günlüklerinden veya terminal çıktısından yeniden bir araya getirmeye gerek kalmaz.

Bir işin parçaları

ParçaAmaç
Başlık ve açıklamaHedef, arka plan, gereksinimler ve kabul kriterleri.
Durum ve öncelikİşin nerede durduğu ve önce neyin ele alınacağı.
AtananBir çalışma alanı üyesi, bir agent veya bir Ekip.
Tarihler, etiketler ve özel özelliklerPlanlama, sınıflandırma ve takımınızın kendi alanları.
Proje ve üst-alt ilişkileriDaha büyük bir çalışmanın parçası olur veya alt işlere bölünür.
Etkinlik ve çalıştırma günlüğüYorumlar, durum değişiklikleri, çalıştırmalar ve agent'ların döndürdüğü sonuçlar.

İş detayı: açıklama, tartışma, sağda özellikler ve çalıştırma günlüğü

Bir iş oluşturma

Bir işi İşler sayfasından veya bir projenin içinden oluşturun — bir başlık yeterlidir, diğer her özellik daha sonra doldurulabilir.

Her işin MUL-123 gibi bir numarası vardır. Rakamlar çalışma alanı içinde artar; bir yönetici çalışma alanının iş ön ekini değiştirdikten sonra, numaralar yeni ön ekle görüntülenir. Bkz. Çalışma alanları.

Bir atanan seçme

AtananEtki
ÜyeO üye takibi sahiplenir; hiçbir çalıştırma oluşturulmaz.
AgentO agent için bir çalıştırma oluşturulur.
EkipEkip lideri işi alır ve kimin ele alacağına karar verir.

Bir agent'a veya bir Ekibe atandığında, iş backlog'da değilse hemen kuyruğa girer; runtime çevrimdışıysa çalıştırma kuyrukta bekler. Arşivlenmiş agent'lar ve Ekipler atanamaz.

Atama bir agent'ın Erişimini atlamaz; bir Ekibe atarken kontrol edilen liderin Erişimidir. Bkz. İşleri agent'lara atama.

Durum

Her çalışma alanı, dört yaşam döngüsü kategorisine ayrılmış yedi yerleşik durumla başlar:

KategoriYerleşik durumlarAnlamı
unstartedbacklog, todoHenüz başlamamış çalışma; ister planlanmış ister ertelenmiş olsun.
startedin_progress, in_review, blockedÇalışma başlamış, inceleme bekliyor veya şu an devam edemiyor.
donedoneBaşarıyla bitmiş; sonlandırıcı.
closedcancelledArtık sürdürülmüyor; sonlandırıcı, başarılı bir tamamlanma değil.

Kategoriler, yaşam döngüsü mantığını basit tutar. Panolar, listeler, filtreler ve sıralama tek tek duruma göre çalışır, somut durumlar ise agent'ların ve otomasyonların dayandığı daha özel iş akışı davranışını korur.

DurumAnlamı
backlogHenüz başlamıyor. Bir agent'a atanan bir iş, yalnızca backlog'dan çıktıktan sonra bir çalıştırma oluşturur.
todoKapsamı belirlenmiş ve başlamayı bekliyor.
in_progressÜzerinde çalışılıyor.
in_reviewİncelemeyi bekleyen bir sonucu var.
doneBitti.
blockedŞu an devam edemiyor.
cancelledArtık sürdürülmüyor; kayıt kalır.

Durumlar arasında sabit bir akış yoktur — üyeler ve agent'lar bunları doğrudan değiştirebilir.

Agent'lar, işlerini değiştirdikçe işin bulunduğu durumu yazar: işin kendisinin istediği şey üzerinde çalışmaya başlamak — hangi biçimde olursa olsun, araştırma, tasarım veya işin kendisinin talep ettiği bir inceleme dahil — işi hemen in_progress'e taşır, böylece pano çalışma sürerken bunu gösterir; teslim etmek işi in_review'e taşır; görev sınırının ötesinde devam eden çalışma işi in_progress'te tutar; işin kendi teslimatından hiçbirini üretmeyen bir görev — soruları yanıtlamak, başka birine ait bir iş üzerine görüş bildirmek gibi — durumu baştan sona dokunulmadan bırakır. Bu güncellemeler, çalışma sırasında agent tarafından Multica CLI üzerinden açıkça yazılır — sunucu, bir çalışma başladığında veya tamamlandığında iş durumunu kendiliğinden değiştirmez (aşağıdaki iki sistem istisnası dışında). done genellikle bir insan onayıdır, veya çalışma alanı birleştirilen işleri done'a taşıyacak şekilde ayarlanmışsa işin bağlı PR'larının birleştirilmesidir.

Sistem tarafından yapılan iki değişiklik vardır:

  • Bir çalıştırma başarısız olduğunda, işin başka çalıştırması yoksa ve yeniden deneme tetiklenmediyse, in_progress durumu todo'ya geri döner.
  • İşe bağlı her PR birleştirildiğinde, iş çalışma alanının seçtiği duruma (varsayılan olarak done) taşınır — çalışma alanı durumu değiştirmemeyi seçmediyse veya bu iş için kapatılmadıysa. Bkz. GitHub entegrasyonu.

Özel durumlar

Bir çalışma alanı sahibi veya yöneticisi, Ayarlar → İş Durumları altında durumlar ekleyebilir — Code Review, QA, Rework. Her durum, dört yaşam döngüsü kategorisinden birine aittir:

KategoriYaşam döngüsü anlamı
unstartedBaşlamamış. Yerleşik Backlog ve Todo'yu içerir.
startedDevam ediyor; inceleme ve bekleme dahil.
doneBaşarıyla tamamlanmış; sonlandırıcı.
closedİptal edilmiş veya artık sürdürülmüyor; sonlandırıcı, başarılı bir tamamlanma değil.

Özel durumlar yalnızca yaşam döngüsü anlamını devralır. Yerleşik Backlog'un beklemeye alması, In Review'in Otopilot çalışmasını tamamlaması, Blocked'ın başarısızlığı veya In Progress'in kurtarması onlara geçmez. Bu davranış gerektiğinde sabit yerleşik durumu kullanın. Geçmiş özel durumlar da aynı kurallara uyar: Awaiting Response devam eden bir çalışmadır, otomatik inceleme tamamlanması değil. Atama ve oluşturma yine de genel agent tetikleme kurallarını izler.

Kurulu istemciler için, mevcut API kategori alanları yedi değerli tel (wire) enum'unu korur. Yeni istemciler bu gösterimi dört kategoriye normalleştirir; tel değerleri asla davranış devralımı vermez. Veritabanı yalnızca dört yaşam döngüsü değerini saklar.

Bu modelden dört şey çıkar:

  • Bir durumun kategorisi, durum var olduktan sonra sabittir. Daha sonra değiştirmek, o durumda bulunan her işin yaşam döngüsü davranışını değiştirirdi, bu yüzden düzenleyici bunu salt okunur tutar. Önce yaşam döngüsü aşamasını seçin, sonra adlandırın.
  • Durum gruplaması tek tek durumları kullanır. Pano sütunları, Liste bölümleri ve Kulvar durum sütunlarının her biri yerleşik ve özel durumları ayırt eder. Code Review ile QA, ikisi de Started'a ait olsa bile ayrı sütunlara sahiptir. Kategoriler dahili yaşam döngüsü sınıflandırmalarıdır, yerine geçen sütun adları değil.
  • Yerleşik durumlar kilitlidir. Adları, renkleri ve kategorileri değiştirilemez ve arşivlenemezler — bu sayfayı hiç açmayan bir çalışma alanı, sahip olduğu panoyu aynen korur.
  • Arşivleme bir durumu emekliye ayırır, silmez. Zaten o durumda olan işler durumu korur, adını ve rengini korur ve aynı şekilde davranmaya devam eder. Yalnızca bir sonraki sefer birisi durum ayarladığında sunulmaktan çıkar.

Yerleşik durumlar arayüz diline çevrilir; özel bir durum her zaman yazdığınız adı gösterir. API ve CLI ona anahtarıyla erişir: multica issue status MUL-42 code_review. Ayarlar sayfası bu anahtarı isimden türetir; API ise açık bir anahtar kabul eder ve yalnızca türetmeye geri döner. Her iki durumda da anahtar oluşturulduğunda sabitlenir — durumu daha sonra yeniden adlandırmak anahtarı değiştirmez.

İşler ve çalıştırmalar

Bir iş, bir çalışma parçasının kalıcı kaydıdır; bir çalıştırma ise bir agent'ın somut bir seferlik yürütmesidir. Bir iş, zaman içinde birden çok çalıştırma üretebilir — ilk bir uygulama, takip değişiklikleri, başka bir kontrol. Tamamlanmış bir çalıştırma yalnızca o çalıştırmanın bittiği anlamına gelir; işin bitip bitmediğini belirleyen işin durumudur.

Projeler ve alt işler

Bir iş en fazla bir projeye aittir; proje, içindeki çalıştırmalar için paylaşımlı talimatlar ve kaynaklar sağlar. Bir işi başka bir projeye taşımak bir kopya oluşturmaz.

Daha büyük çalışmalar alt işlere bölünebilir: üst iş genel hedefi korurken alt işler bağımsız olarak ilerler. Üst ve alt durumları birbirini etkilemez.

Alt işlere gruplar hâlinde ilerlemek için bir aşama verilebilir — 1, 2, 3. En erken bitmemiş aşamadaki her alt iş done veya cancelled'a ulaştığında, üst iş bir "alt işler tamamlandı" bildirimi alır; üst işin atananı bir agent olduğunda, agent uyanır ve bir sonraki aşamayı başlatıp başlatmayacağına karar verir. Aşaması olmayan alt işler tek bir grup sayılır ve hepsi bittiğinde bir kez bildirim gönderir.

Görünüm değiştirme

İşler sayfası beş görünüm sunar — liste, pano, tablo, Gantt ve kulvar — durum, atanan, proje ve diğer özelliklere göre filtrelenebilir ve sıralanabilir. Hepsi aynı işleri gösterir.

Bir işi silme

Herhangi bir çalışma alanı üyesi bir işi silebilir.

Silme geri alınamaz: iş, yorumları, ekleri ve bağlı kayıtlarıyla birlikte kalıcı olarak kaldırılır ve bitmemiş çalıştırmalar iptal edilir. Çalışma yalnızca artık sürdürülmüyorsa, bunun yerine durumu cancelled olarak ayarlayın — tartışma ve sonuçlar kullanılabilir kalır.

Sonraki adımlar

  • Projeler — birden fazla işin bitirdiği çalışmayı organize edin.
  • Yorumlar — bir iş etrafında tartışın, yanıtlayın ve @ ile bahsedin.
  • İşleri agent'lara atama — işi bir agent'a devredin ve ilk çalıştırmayı başlatın.
  • Çalıştırmalar — kuyruğa alma, çalıştırma, yeniden deneme ve iptal hakkında bilgi edinin.