Projeler
İlişkili işleri projelerle organize edin ve onlara ortak bir hedef, plan ve yürütme bağlamı verin.
Projeler, bitmesi için birden fazla iş gerektiren çalışmayı organize eder — bir ürün lansmanı, bir migration veya aşamalar hâlinde teslim edilen bir özellik.
Tek bir işin tanımlayabileceği çalışmanın bir projeye ihtiyacı yoktur. Projeler; ortak bir hedefi paylaşan, ilerlemesinin birlikte takip edilmesi gereken veya paylaşılan depolara ve çalışma dizinlerine ihtiyaç duyan bir çalışma grubuna uyar.
Bir projenin parçaları
| Parça | Amaç |
|---|---|
| Ad, simge ve açıklama | Hedef, kapsam ve uzun ömürlü gereksinimler; açıklama, proje içinde çalışan agent'ların yürütme bağlamına girer. |
| Durum | planned, in_progress, paused, completed veya cancelled. |
| Öncelik | urgent, high, medium, low veya none. |
| Sorumlu | Projeyi kim koordine ediyor — bir üye veya bir agent. |
| Başlangıç ve hedef tarihleri | Projenin planlanan zaman aralığı. |
| İşler ve ilerleme | Projedeki çalışma ve ne kadarının bittiği. |
| Kaynaklar | Belirli bilgisayarlardaki bağlı GitHub depoları veya yerel dizinler. |
Projeler ve işler
Bir proje herhangi bir sayıda iş içerebilir; bir iş en fazla bir projeye ait olabilir. İşleri doğrudan proje içinde oluşturun veya işin özelliklerinden projeyi seçin ya da değiştirin.
Proje ilerlemesi, bağlı işlerden otomatik olarak hesaplanır:
progress = issues in done or cancelled ÷ all issues in the projectcancelled, çalışmanın projenin kapsamı dışında kapatıldığı anlamına gelir, bu yüzden ilerlemeye dahil edilir. Proje durumu ve iş durumu birbirinden bağımsızdır: her işi bitirmek projeyi otomatik olarak completed yapmaz, projenin durumunu değiştirmek de işlerini toplu olarak değiştirmez.
Proje açıklaması ve yürütme bağlamı
Bir agent, bir proje içindeki bir işi çalıştırdığında, projenin adı ve açıklaması o çalıştırmanın bağlamına eklenir. Açıklama; ilgili her işin ihtiyaç duyduğu bilgiler için yerdir: hedef, teknik sınırlar, teslim konvansiyonları. Yalnızca tek bir işe uygulanan gereksinimler o işe aittir.
Kaynak ekleme
Proje kaynakları, agent'lara hangi kod ve çalışma dizinlerini kullanacaklarını söyler:
- GitHub depoları: runtime'ın çıkış (checkout) yapabileceği bir depoyu, isteğe bağlı bir ref ile sağlar.
- Yerel dizinler: belirli bir bilgisayardaki runtime'ın mevcut bir dizinde çalışmasına izin verir; içeriğini agent doğrudan değiştirir.
Nasıl seçileceği ve güvenlik sınırları için bkz. Proje kaynakları.
Proje sorumlusu
Sorumlu bir üye veya bir agent olabilir ve projeyi kimin koordine ettiğini belirtir. Bu bir izin ayarı değildir: projenin işlerini otomatik olarak atamaz ve bir agent'ı sorumlu yapmak onu otomatik olarak çalıştırmaz. Bir çalıştırma başlatmak yine de bir iş ataması, bir @ bahsi veya bir otomasyon tetikleyicisi gerektirir.
Kenar çubuğuna sabitleme
Sabitlenen bir proje kenar çubuğunuzda görünür. Sabitleme kişisel bir tercihtir ve diğer üyeleri etkilemez.
Oluşturma, düzenleme ve silme
Herhangi bir çalışma alanı üyesi proje oluşturabilir ve düzenleyebilir; yalnızca owner ve admin silebilir.
Bir projeyi silmek işlerini silmez: işler projeden ayrılır ve çalışma alanında kalır. Projenin açıklaması, durumu ve kaynakları kalıcı olarak silinir.
Sonraki adımlar
- Proje kaynakları — GitHub depolarını veya yerel dizinleri bağlayın.
- İşler — bir projedeki somut çalışmayı oluşturun ve organize edin.
- Agent'lar — agent kimliği, yapılandırması ve Erişimi hakkında bilgi edinin.