İş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ça | Amaç |
|---|---|
| Başlık ve açıklama | Hedef, arka plan, gereksinimler ve kabul kriterleri. |
| Durum ve öncelik | İşin nerede durduğu ve önce neyin ele alınacağı. |
| Atanan | Bir çalışma alanı üyesi, bir agent veya bir Ekip. |
| Tarihler, etiketler ve özel özellikler | Planlama, sınıflandırma ve takımınızın kendi alanları. |
| Proje ve üst-alt ilişkileri | Daha 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. |

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
| Atanan | Etki |
|---|---|
| Üye | O üye takibi sahiplenir; hiçbir çalıştırma oluşturulmaz. |
| Agent | O agent için bir çalıştırma oluşturulur. |
| Ekip | Ekip 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:
| Kategori | Yerleşik durumlar | Anlamı |
|---|---|---|
unstarted | backlog, todo | Henüz başlamamış çalışma; ister planlanmış ister ertelenmiş olsun. |
started | in_progress, in_review, blocked | Çalışma başlamış, inceleme bekliyor veya şu an devam edemiyor. |
done | done | Başarıyla bitmiş; sonlandırıcı. |
closed | cancelled | Artı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.
| Durum | Anlamı |
|---|---|
backlog | Henüz başlamıyor. Bir agent'a atanan bir iş, yalnızca backlog'dan çıktıktan sonra bir çalıştırma oluşturur. |
todo | Kapsamı belirlenmiş ve başlamayı bekliyor. |
in_progress | Üzerinde çalışılıyor. |
in_review | İncelemeyi bekleyen bir sonucu var. |
done | Bitti. |
blocked | Şu an devam edemiyor. |
cancelled | Artı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_progressdurumutodo'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:
| Kategori | Yaşam döngüsü anlamı |
|---|---|
unstarted | Başlamamış. Yerleşik Backlog ve Todo'yu içerir. |
started | Devam ediyor; inceleme ve bekleme dahil. |
done | Baş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 ReviewileQA, 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.