Buat dan kelola tiket

Panduan ini menunjukkan cara membuat dan mengelola tiket.

Buat tiket

Dari UI

1. Klik Tiket di bilah sisi ruang kerja.
2. Tekan Tiket baru.
3. Isi:
   • Judul — ringkasan singkat. Hanya kolom ini yang wajib diisi.
   • Deskripsi — markdown, dengan bilah alat pemformatan.
   • Status — To do (default) atau Backlog. Status yang sudah dimulai dan status terminal dicapai melalui siklus hidup, bukan saat pembuatan.
   • Prioritas — tidak ada, mendesak, tinggi, sedang, atau rendah.
   • Penerima tugas — diri Anda sendiri atau agen mana pun di ruang kerja.
   • Proyek — pengelompokan opsional.
4. Tekan Buat, atau aktifkan Buat lagi lebih dulu agar dialog tetap terbuka untuk entri cepat.

Tidak ada pemilih penyedia di dialog ini. Tiket dibuat pada penyedia tiket aktif ruang kerja.

Dari agen

Minta agen di sebuah space:

Buat tiket untuk memperbaiki masalah timeout login pada koneksi lambat.

Agen itu memanggil alat MCP create_ticket. Prioritas pada alat tersebut berupa bilangan bulat, bukan nama:

create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: 2
)

Nilai	Prioritas
0	Tidak ada
1	Mendesak
2	Tinggi
3	Sedang
4	Rendah

Hanya workspace_id dan title yang wajib; description, priority, assignee (id agen) dan team_id bersifat opsional. Alat ini digolongkan sebagai penulisan sinkronisasi vendor dan meminta persetujuan Anda sebelum dijalankan.

Perbarui status tiket

Tiket mengikuti siklus hidup berikut:

backlog → open → inProgress ⇄ blocked
                    ↓   ↑
                 inReview
                    ↓
              done / failed   (terminal)

done, failed dan cancelled bersifat terminal. cancelled dapat dicapai dari status non-terminal mana pun. done dan failed dapat dicapai dari inProgress atau inReview; open juga dapat berpindah langsung ke blocked. Pemilih status di UI mencantumkan setiap status kecuali failed — agen menandainya dengan fail_ticket.

Untuk mengubahnya, gunakan salah satu dari:

• baris Status di bilah properti tiket,
• submenu Status pada menu klik kanan tiket di daftar,
• chip Status di bilah mengambang setelah memilih beberapa tiket.

Graf siklus hidup mengikat agen, bukan Anda

Setiap perubahan status yang dilakukan dari UI dipaksakan, sepenuhnya melewati graf — Anda dapat memindahkan tiket ke status apa pun yang tercantum di pemilih, termasuk membuka kembali tiket yang done, failed atau cancelled. Pemilih tidak menawarkan failed sebagai target. Diagram di atas mengatur agen dan otomatisasi: transisi tidak sah yang dicoba oleh alat MCP atau reconciler akan dicatat dan diabaikan, bukan diterapkan.

Perubahan status memancarkan peristiwa domain (TicketStatusChanged, TicketCompleted dan lainnya) yang dapat memicu pipeline. Lihat Siapkan pemicu pipeline.

Tetapkan tiket

1. Buka tiket.
2. Di bilah properti, tetapkan Penerima tugas — diri Anda sendiri, anggota ruang kerja lain, atau agen.

Menetapkan tidak memulai pekerjaan apa pun

Penetapan mencatat kepemilikan dan tidak melakukan hal lain. Penetapan tidak membuat space, tidak mengubah status dan tidak mengirim agen mana pun — TicketAssigned adalah sinyal audit murni tanpa pengirim di baliknya. Agar agen mulai bekerja, kirim pesan kepadanya di sebuah space (lihat Chat dengan agen).

Satu pengecualian: TicketAssigned adalah jenis peristiwa yang dapat Anda sambungkan ke pemicu pipeline, sehingga templat buatan Anda sendiri dapat bereaksi terhadap penugasan.

Tambahkan label

Label diterapkan secara massal dari daftar tiket, bukan dari satu tiket — bilah properti tidak memiliki kontrol label.

1. Arahkan kursor ke baris di daftar tiket lalu centang kotaknya. Centang sebanyak yang Anda perlukan; bilah mengambang muncul begitu ada yang dipilih.
2. Di bilah itu, buka chip Label.
3. Pilih sebuah label. Label ditambahkan ke setiap tiket terpilih yang belum memilikinya; label yang sudah ada tidak pernah dihapus. Hapus label menghapus semuanya. Pemilih mencantumkan label yang sudah ada di tiket mana pun dalam ruang kerja. Agen dapat menambahkan nama baru melalui update_ticket atau tickets.patch.

Tautkan tiket

Relasi berada di kartu Relasi tiket pada bilah properti, atau di balik Hubungkan ke pada menu klik kanan daftar.

1. Buka tiket dan temukan kartu Relasi.
2. Tekan kontrol tambah di kartu itu dan pilih relasinya:

Relasi	Arti
Sub-isu dari…	Tiket lainnya adalah induk tiket ini
Induk dari…	Tiket lainnya adalah anak dari tiket ini
Diblokir oleh…	Tiket ini diblokir oleh tiket lainnya
Memblokir…	Tiket ini memblokir tiket lainnya
Terkait dengan…	Simetris, tidak menyiratkan arah
Duplikat dari…	Tiket ini menduplikasi tiket lainnya

3. Pilih tiket target.

Diduplikasi oleh muncul di kartu tetapi tidak di pemilih — ini kebalikan dari Duplikat dari dan ditetapkan dari tiket lainnya. Setiap relasi yang tercantum dapat diklik untuk membuka tiket yang ditautkan dan dapat dihapus saat kursor diarahkan ke atasnya.

Relasi induk dan sub-isu disimpan pada tiket itu sendiri, bukan sebagai baris tautan, sehingga menghapus induk ikut menghapus anak-anaknya (lihat di bawah), sedangkan tautan pemblokiran dan keterkaitan tidak.

Tambahkan kolaborator

Kolaborator adalah daftar nama pada tiket — siapa yang terlibat dan dalam kapasitas apa.

1. Buka tiket.
2. Tekan kontrol tambah orang di kartu Tambah kolaborator.
3. Pilih agen.

Ada tiga peran: assignee, collaborator (default) dan reviewer. Pemilih di UI hanya mencantumkan agen ruang kerja dan selalu menuliskan peran default; manusia dapat muncul sebagai baris tetapi tidak ditawarkan di menu itu. Alat MCP add_ticket_collaborator menerima role.

Menambahkan kolaborator menulis satu baris dan tidak menerbitkan peristiwa domain apa pun; tindakan ini tidak memberikan akses space. Untuk memasukkan agen ke dalam percakapan, tambahkan sebagai peserta dari header space — lihat Space.

Hapus tiket

Gunakan Hapus tiket di bagian bawah bilah properti, di menu klik kanan, atau pada aksi hapus di bilah mengambang setelah memilih beberapa tiket.

Penghapusan hanya bersifat lokal

Tiket yang berasal dari pelacak eksternal tidak dihapus di sana — tidak ada penyedia yang mendukungnya — sehingga tiket itu dapat muncul kembali pada sinkronisasi berikutnya. Penghapusan juga berantai: kolaborator tiket dan tiket anak mana pun ikut terhapus.

Panduan terkait

• Delegasikan pekerjaan ke agen
• Atur pekerjaan dengan proyek
• Chat dengan agen
• Referensi siklus hidup tiket

Konsep terkait

• Tiket
• Peristiwa domain