Bir kişi için yazılan görev üç kelimeden oluşabilir. "Giriş hatasını düzelt" yeterlidir, çünkü karşınızdaki kişi ne demek istediğinizi sorar. Bir agent için yazılan görev ise bu sohbetten yararlanamaz; aradaki fark, boşa harcanan çalıştırmalar, kimsenin incelemediği sonuçlar ve durum sütununun artık insanların sandığı anlama gelmediği bir pano olarak kendini gösterir.
AI agent görev yönetimi; bir agent'ın yürüttüğü, bir kişinin ise kabul ettiği işlerin yazılması, atanması ve kapatılması disiplinidir. Bu rehber, işlerin bir arada yürüyüp yürümeyeceğini belirleyen üç bölümü ele alıyor: agent'a hazır bir görev neler içerir, atama kişiler ile agent'lar arasında nasıl bölüşülür ve işin içine çalıştırmalar girdiğinde durum ile inceleme gerçekte nasıl davranır. Örnekler Sharkly'nin bunu nasıl uyguladığını izliyor; aynı kurallar agent'ları yürütücü olarak gören her sisteme aktarılabilir.
Kısaca
Agent'a hazır bir görev; bir sonucu, kapsamı, bağlamı ve tamamlanmanın nasıl inceleneceğini belirtir. Atamanın iki alanı vardır: sorumluluk kişilerdedir ve yürütmeyi tek bir agent ya da ekip üstlenir. Durum kategorileri yürütmeyi yönlendirir; yani beklemedeki bir backlog durumu çalıştırmayı engeller, oradan çıkmak çalıştırmayı başlatabilir, iptal edildi veya yinelenen durumları etkin çalıştırmaları durdurur, tamamlandı ise durdurmaz. Görev durumu ile agent çalıştırma durumu birbirinden ayrıdır ve inceleme, birinin sonraya bıraktığı bir niyet değil, mutlaka bir kişiye ulaşması gereken adlandırılmış bir durumdur.
Agent'a hazır bir görev neler içerir
Açıklama, arayüzün kendisidir. Agent'ın niyetiniz hakkında bildiği her şey, bu açıklamadan ve görevin alanlarında taşıdığı bilgilerden gelir.
İşe yarar bir görev, konuyu değil sonucu adlandırır; açıklaması ise konuya yeni giren bir kişinin ya da agent'ın ilerleyebilmesi için gerekenleri ekler:
- iş neden önemli;
- neler kapsam içinde, neler dışında;
- ilgili dosyalar, bağlantılar, örnekler veya gözlemlenen davranış;
- kısıtlar ve hâlihazırda alınmış kararlar;
- tamamlanmanın nasıl inceleneceği.
Bu son madde, diğerlerinin toplamından daha fazla iş görür. İki dakikada kabul edebileceğiniz bir sonuç ile tersine mühendislik yapmanız gereken bir sonuç arasındaki fark budur. Küçük başlayın ve iş incelendikçe iyileştirin; bir görev açıklamasının gelişmesinde sakınca yoktur.
Geri kalanını alanlar taşır: tür, durum, öncelik, tarihler, etiketler ve planlama bağlamı için bir proje ya da sprint. Agent için derlenen bir çalıştırma; başlığı ve açıklamayı, güncel durum ve önceliği, alan ve sprint bağlamını, onu tetikleyen yorum dahil son yorumları, agent'ın talimatlarını ve becerilerini, depoları, ortamı ve çalıştırma ayarlarını içerebilir. Yetersiz açıklamaları iyi modeller telafi etmez.
Atama: tek değil, iki alan
Agent görev yönetiminde en sık yapılan tasarım hatası, tek bir atanan kişi alanı kullanmaktır.
Bu iki alanı ayrı tutun. Kişiler sorumluluk için atanır ve bir alan bir ya da birden fazla kişiye izin verebilir. Yürütme alanına ise bir agent ya da ekip atanır ve bu alan tek seçimlik kalır. Bir görevde her ikisi aynı anda bulunabilir; kişi kümesini değiştirmek yürütücüyü değiştirmez, bir agent atamak da kişilerin yerini almaz.
Bunun getirisi, hiçbir görevin bir bota ait olmamasıdır. Bir sonuç karar gerektirdiğinde ortada bir isim vardır. Agent yanlış yaptığında inceleme konuşmasının bir katılımcısı olur. Claude Code proje yönetimi incelememizde, tek bir görevin issue'dan merge'e kadar aynı ayrımı nasıl izlediğini gösteriyoruz.
Ekipler de aynı yürütme alanına girer ve yürütme lider öncelikli işler: lider agent başlar, bağlamı okur, ardından gerektiğinde üyeleri sürece katar. Net tanımlanmış işler için tek bir agent, koordinasyon gerektiren işler içinse bir ekip kullanın.
Durum: yürütmeyi kontrol eden kısım
İşin içine agent'lar girdiğinde durum artık bir süs değildir. Görünen her durum bir kategoriye aittir ve kategori sistem açısından bir anlam taşır.
| Durum kategorisi | Ne anlama gelir | Agent çalıştırmalarına etkisi |
|---|---|---|
| Backlog | Beklemede, hazır değil | Burada oluşturmak veya atamak çalıştırma başlatmaz |
| Başlatılmadı | Hazır, başlamadı | Backlog'dan buraya taşımak, atanmış agent'ı başlatabilir |
| Başladı | Devam ediyor | Çalıştırmalar sürer; birden fazla durum bu kategoriyi paylaşabilir |
| Tamamlandı | Bitti, nihai | Nihaidir, ancak hâlihazırda etkin bir çalıştırmayı iptal etmez |
| İptal edildi | Devam etmeyecek | Görev için başlatılan çalıştırmaları durdurur |
| Yinelenen | Başka bir yerde temsil ediliyor | Görev için başlatılan çalıştırmaları durdurur |
İki sonucu iyice kavramakta fayda var. Backlog gerçek bir hazırlık alanıdır: görevi hazırlayın, agent'ı ekleyin ve siz taşıyana kadar hiçbir şey olmaz. Bir işi tamamlandı olarak işaretlemek ise onu durdurmakla aynı şey değildir; gerçekten durmasını istediğiniz bir çalıştırmayı iptal edin.
İkinci kural, yaşam döngüsü durumu ile agent'ın çalışma durumunun ayrı olduğudur. Görev, başladı kategorisinde dururken agent çalışıyor, insan yanıtı bekliyor, insan incelemesi bekliyor ya da bir hata bildiriyor olabilir. Kuyruğa alındı, gönderildi, çalışıyor, tamamlandı, başarısız ve iptal edildi gibi çalıştırma durumları yürütmenin ilerleyişini anlatır ve görevi kendiliğinden ilerletmez. Birini diğeri yerine okumak, panonun sağlıklı görünmesine rağmen üç sonucun okunmadan beklemesinin sebebidir.
İnceleme: devir teslimi açık hale getirmek
Agent'lar çalıştırmaları iki faydalı noktadan birinde bitirir: bir sonuçla ya da bir soruyla. İkisinin de bir kişiye ulaşması gerekir.
İnsan yanıtı beklemek, inceleme beklemek ve başarısız ya da tıkanmış işler dikkat sinyalleridir. Bunlar kişisel bir kuyruğu besler; Sharkly'de bu kuyruk agent gelen kutusudur ve sorumlu kişi buradan görevi açıp bağlam içinde yanıtlayabilir, sonucu inceleyebilir ya da işi yeniden denemeye veya yeniden atamaya karar verebilir.
Yorumlar, görev üzerindeki kalıcı konuşmadır. Yeni bağlam, inceleme bulguları ve kararlar için bunları kullanın; sabit hedefi ve kabul kriterlerini ise açıklamada tutun ki güncel gereksinim kolayca bulunabilsin. Hazır bir agent ataması olan bir göreve üye yorumu yapmak yeni bir çalıştırmayı kuyruğa alabilir; inceleme geri bildiriminin ikinci bir süreç başlatmak yerine işi sürdürmesini sağlayan da budur. Bahsetmeler bu durumu değiştirir: bir kişiden bahsetmek veya tümünü bahset kullanmak tek başına bir agent çalıştırması başlatmaz ve atanan kişi olmadan başka hedeflerden bahseden bir yorum, varsayılan çalıştırmayı bastırır.
Kabul etmeden önce yalnızca diff'i değil, kanıtları da okuyun. Yürütme günlüğü bir çalıştırmanın neden kuyruğa alındığını, ne zaman başlayıp bittiğini, araç çağrılarını ve çalışma zamanı olaylarını, tetikleyici kaynağı ve hata ayrıntılarını gösterir. Kabul, sonucun doğru olduğuna karar veren kişidir; bunu hiçbir çalıştırma durumu sizin yerinize yapamaz. Bu durumların elle birleştirilmesi yerine birbirine bağlı olmasını istiyorsanız Sharkly'yi indirin.
Kopyalamaya değer bir görev şablonu
Agent görevlerini iyi yazan ekipler genellikle aynı iskelette buluşur. Bunu bir snippet olarak saklayın ve doldurun; tümü yaklaşık üç dakika sürer ve boşa giden bir çalıştırmayı kurtarır.
Outcome: <what is true when this is done>
Context:
- Why this matters now
- Observed behavior, with the exact error or reproduction steps
- Files, links, or examples that are relevant
Scope:
- In: <the change you want>
- Out: <adjacent work the agent should not touch>
Constraints:
- Decisions already made, conventions to follow, things not to change
Review:
- How completion will be checked, and by whom
Kapsam dışı satırı yerini en hızlı kazanan satırdır. Dar bir hedef verilip sınır çizilmeyen agent'lar, sizin sormadığınız şeyleri iyileştirmeye eğilimlidir ve bu iyileştirmelerin her biri inceleme süresi harcatır. Neye dokunulmaması gerektiğini belirtmek, dokunduğu şeyleri incelemekten daha ucuzdur.
Kaçınmaya değer beş hata
- Tek bir atama alanı. Sorumluluk ile yürütme iç içe geçer ve sahiplik ortadan kalkar.
- Tamamlanan bir çalıştırmayı tamamlanmış bir sonuç sanmak. Çalıştırmanın bitmesi, değişikliğin doğru olduğuna dair hiçbir şey söylemez.
- Başarısız çalıştırmaları refleks olarak yeniden denemek. Önce günlüğü açın. Birbirine benzeyen tedarikçi hataları çoğu zaman birbirinin tersi çözümler gerektirir.
- İncelemelerin birikmesine izin vermek. İncelenmemiş agent sonuçları, birleştirilmemiş pull request'lerden daha hızlı büyüyen bir borçtur.
- Görevleri zaten her şeyi bilen kişi için yazmak. Kabul kriterleri kafanızın içindeyse, agent tahmin yürütüyor demektir.
SSS
Bir agent görevin durumunu değiştirebilir mi? Belirli sınırlar içinde. Görev türünün iş akışı hangi durumların kullanılabilir olduğunu kısıtlar, dolayısıyla bir agent yalnızca bu iş akışının izin verdiği durumları seçebilir.
Bir çalıştırma etkinken yorum yaparsam ne olur? Uygun bir yorum, paralel bir kopya başlatmak yerine bir sonraki çalıştırma döngüsü için kuyruğa alınabilir ve hızlı ardışık yorumlar birleştirilir, böylece yinelenen bekleyen çalıştırmalar oluşmaz.
Agent işleri için ayrı bir görev türüne ihtiyacım var mı? Genellikle hayır. İş, anlamlı ölçüde farklı bir alan kümesi ya da iş akışı gerektiriyorsa ayrı bir tür; yalnızca hafif bir sınıflandırmaya ihtiyacınız varsa etiket kullanın.
Bunun sıradan proje yönetiminden farkı ne? Temel yapı taşları aynı, katılık derecesi değil. AI agent proje yönetimi rehberimiz, bir yürütücü koridorda gidip netleştirici bir soru soramadığında her bir yapı taşında nelerin değiştiğini ele alıyor.
