Tugas yang ditulis untuk manusia bisa hanya tiga kata. "Perbaiki bug login" sudah cukup, karena orangnya akan bertanya apa maksud Anda. Tugas yang ditulis untuk agen tidak bisa mengandalkan percakapan semacam itu, dan perbedaannya muncul sebagai run yang terbuang, hasil yang tidak ditinjau siapa pun, serta papan kerja yang kolom statusnya tidak lagi berarti seperti yang dipikirkan orang.
Manajemen tugas agen AI adalah disiplin menulis, menugaskan, dan menutup pekerjaan yang dieksekusi oleh agen dan diterima oleh manusia. Panduan ini membahas tiga bagian yang menentukan apakah semuanya tetap utuh: apa saja isi tugas yang siap untuk agen, bagaimana penugasan dibagi antara manusia dan agen, serta bagaimana status dan tinjauan benar-benar berperilaku begitu run sudah terlibat. Contoh-contohnya mengikuti cara Sharkly mengimplementasikannya, dan aturan yang sama berlaku untuk sistem apa pun yang memperlakukan agen sebagai eksekutor.
TL;DR
Tugas yang siap untuk agen menyatakan hasil yang diinginkan, cakupan, konteks, dan bagaimana penyelesaiannya akan ditinjau. Penugasan punya dua slot: manusia bertanggung jawab, dan satu agen atau crew yang mengeksekusi. Kategori status mengendalikan eksekusi, jadi status backlog yang diparkir mencegah run dimulai, berpindah keluar darinya bisa memulai run, dan status canceled atau duplicate menghentikan run yang aktif sementara completed tidak. Status tugas dan status run agen itu terpisah, dan tinjauan adalah status bernama yang harus sampai ke seseorang, bukan sekadar niat yang akan dikerjakan nanti.
Apa saja isi tugas yang siap untuk agen
Deskripsi adalah antarmukanya. Segala hal yang diketahui agen tentang maksud Anda berasal dari deskripsi itu, ditambah apa pun yang dibawa tugas di kolom-kolomnya.
Tugas yang baik menyebutkan hasil yang diinginkan, bukan sekadar topiknya, dan deskripsinya menambahkan apa yang dibutuhkan orang baru atau agen untuk melanjutkan:
- mengapa pekerjaan ini penting;
- apa yang termasuk dan tidak termasuk dalam cakupan;
- berkas, tautan, contoh, atau perilaku yang diamati yang relevan;
- batasan dan keputusan yang sudah diambil;
- bagaimana penyelesaiannya akan ditinjau.
Poin terakhir itu jauh lebih penting daripada gabungan poin lainnya. Itulah pembeda antara hasil yang bisa Anda terima dalam dua menit dan hasil yang harus Anda bedah balik untuk memahaminya. Mulailah dari yang sederhana dan perbaiki seiring pekerjaan diselidiki; deskripsi tugas boleh terus disempurnakan.
Kolom-kolom mengisi sisanya: tipe, status, prioritas, tanggal, label, dan proyek atau sprint sebagai konteks perencanaan. Run yang dirakit untuk agen dapat mencakup judul dan deskripsi, status dan prioritas saat ini, konteks space dan sprint, komentar terbaru termasuk komentar yang memicunya, instruksi dan skill agen, repositori, environment, serta pengaturan run. Deskripsi yang minim tidak bisa ditutupi oleh model yang bagus.
Penugasan: dua slot, bukan satu
Kesalahan desain yang paling umum dalam manajemen tugas agen adalah hanya memiliki satu kolom assignee.
Pisahkan keduanya. Manusia ditugaskan untuk bertanggung jawab, dan sebuah space bisa mengizinkan satu orang atau beberapa. Agen atau crew ditugaskan ke slot eksekusi, yang tetap hanya bisa diisi satu. Sebuah tugas bisa memiliki keduanya sekaligus, dan mengubah kumpulan orang tidak mengubah eksekutor, sementara menugaskan agen tidak menggantikan orang-orangnya.
Manfaatnya, tidak ada tugas yang dimiliki oleh bot. Ketika sebuah hasil butuh keputusan, ada nama yang melekat padanya. Ketika agen melakukan kesalahan, percakapan tinjauan punya peserta. Panduan kami tentang manajemen proyek Claude Code menunjukkan pemisahan yang sama pada satu tugas, dari issue hingga merge.
Crew masuk ke slot eksekusi yang sama, dan eksekusinya dipimpin leader terlebih dahulu: agen leader memulai, membaca konteks, lalu melibatkan anggota sesuai kebutuhan. Gunakan satu agen untuk pekerjaan yang sudah jelas, dan crew ketika pekerjaan membutuhkan koordinasi.
Status: bagian yang mengendalikan eksekusi
Status bukan sekadar hiasan ketika agen sudah terlibat. Setiap status yang terlihat termasuk dalam sebuah kategori, dan kategori itu membawa makna sistem.
| Kategori status | Artinya | Efek pada run agen |
|---|---|---|
| Backlog | Diparkir, belum siap | Membuat atau menugaskan di sini tidak memulai run |
| Unstarted | Siap, belum dimulai | Berpindah ke sini dari backlog dapat memulai agen yang ditugaskan |
| Started | Sedang berjalan | Run berlanjut; beberapa status bisa berbagi kategori ini |
| Completed | Selesai, terminal | Terminal, tetapi tidak membatalkan run yang sudah aktif |
| Canceled | Tidak akan dilanjutkan | Menghentikan run yang dimulai untuk tugas tersebut |
| Duplicate | Diwakili di tempat lain | Menghentikan run yang dimulai untuk tugas tersebut |
Ada dua konsekuensi yang perlu benar-benar dipahami. Backlog adalah area persiapan yang nyata: siapkan tugas, lampirkan agen, dan tidak ada yang terjadi sampai Anda memindahkannya. Dan menandai sesuatu sebagai selesai tidak sama dengan menghentikannya, jadi batalkan run yang memang ingin Anda hentikan.
Aturan kedua adalah status siklus hidup dan status kerja agen itu terpisah. Sebuah tugas bisa berada dalam status started sementara agennya sedang bekerja, menunggu balasan manusia, menunggu tinjauan manusia, atau melaporkan error. Status run seperti queued, dispatched, running, completed, failed, dan canceled menggambarkan kemajuan eksekusi dan tidak otomatis memindahkan tugas. Menyamakan keduanya adalah cara papan kerja terlihat sehat padahal tiga hasilnya tidak terbaca.
Tinjauan: membuat serah terima jadi eksplisit
Agen mengakhiri run di salah satu dari dua tempat yang berguna: dengan hasil, atau dengan pertanyaan. Keduanya harus sampai ke seseorang.
Menunggu balasan manusia, menunggu tinjauan, serta pekerjaan yang gagal atau terblokir adalah sinyal yang butuh perhatian. Semuanya masuk ke antrean pribadi, dan di Sharkly itu adalah agent inbox, tempat penanggung jawab bisa membuka tugas, menjawab dalam konteks, meninjau hasilnya, atau memutuskan untuk mencoba ulang atau menugaskan ulang pekerjaan tersebut.
Komentar adalah percakapan yang bertahan lama pada tugas. Gunakan untuk konteks baru, temuan tinjauan, dan keputusan, serta simpan tujuan tetap dan kriteria penerimaan di deskripsi agar kebutuhan saat ini tetap mudah ditemukan. Komentar dari anggota pada tugas dengan assignee agen yang siap dapat memasukkan run berikutnya ke antrean, dan itulah yang membuat umpan balik tinjauan melanjutkan pekerjaan alih-alih memulai proses kedua. Mention mengubah itu: menyebut seseorang atau menggunakan all-mention tidak dengan sendirinya memulai run agen, dan komentar yang menyebut target lain tanpa assignee akan menekan run default.
Sebelum menerima, baca buktinya dan bukan hanya diff-nya. Log eksekusi menunjukkan mengapa sebuah run dimasukkan ke antrean, kapan dimulai dan berakhir, pemanggilan tool dan peristiwa runtime, sumber pemicunya, serta detail kegagalan. Penerimaan adalah keputusan manusia bahwa hasilnya sudah benar, dan tidak ada status run yang bisa melakukannya untuk Anda. Unduh Sharkly jika Anda ingin semua status ini sudah terhubung, bukan dirakit manual.
Template tugas yang layak ditiru
Tim yang menulis tugas agen dengan baik biasanya berujung pada kerangka yang sama. Simpan sebagai snippet lalu isi; semuanya hanya butuh sekitar tiga menit dan menyelamatkan Anda dari run yang terbuang.
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
Baris out-of-scope paling cepat membuktikan manfaatnya. Agen yang diberi tujuan sempit tanpa batasan cenderung "memperbaiki" hal-hal yang tidak Anda minta, dan setiap perbaikan semacam itu memakan waktu tinjauan. Menyebutkan apa yang harus dibiarkan lebih murah daripada meninjau apa yang telah disentuhnya.
Lima kesalahan yang sebaiknya dihindari
- Satu kolom assignee. Tanggung jawab dan eksekusi melebur, dan kepemilikan pun hilang.
- Menganggap run yang completed sebagai hasil yang selesai. Run yang berakhir tidak mengatakan apa pun tentang benar atau tidaknya perubahan itu.
- Mengulang run yang gagal secara refleks. Buka lognya dulu. Error vendor yang terlihat mirip sering kali butuh perbaikan yang justru berlawanan.
- Membiarkan tinjauan menumpuk. Hasil agen yang tidak ditinjau adalah utang yang menumpuk lebih cepat daripada pull request yang belum di-merge.
- Menulis tugas untuk orang yang sudah tahu. Jika kriteria penerimaan hanya ada di kepala Anda, agen hanya menebak-nebak.
FAQ
Bisakah agen mengubah status tugas? Dalam batasan tertentu. Workflow tipe tugas membatasi status mana yang tersedia, jadi agen hanya bisa memilih status yang diizinkan workflow tersebut.
Apa yang terjadi jika saya berkomentar saat run sedang aktif? Komentar yang memenuhi syarat bisa dimasukkan ke antrean untuk siklus run berikutnya alih-alih memulai duplikat paralel, dan komentar yang dikirim cepat berturut-turut digabungkan agar tidak menciptakan run pending yang duplikat.
Apakah saya perlu tipe tugas terpisah untuk pekerjaan agen? Biasanya tidak. Gunakan tipe terpisah ketika pekerjaan membutuhkan kumpulan kolom atau workflow yang benar-benar berbeda, dan label ketika Anda hanya perlu klasifikasi ringan.
Apa bedanya dengan manajemen proyek biasa? Primitifnya sama; tingkat ketatnya berbeda. Panduan kami tentang manajemen proyek agen AI membahas apa yang berubah pada setiap primitif ketika eksekutor tidak bisa bertanya klarifikasi di lorong kantor.
