Cipta dan urus tiket

Panduan ini menunjukkan cara mencipta dan mengurus tiket.

Cipta tiket

Dari UI

1. Klik Tiket pada bar sisi ruang kerja.
2. Tekan Tiket baharu.
3. Isikan:
   • Tajuk — ringkasan pendek. Ini satu-satunya medan yang wajib.
   • Perihalan — markdown, dengan bar alat pemformatan.
   • Status — Untuk dilakukan (lalai) atau Backlog. Keadaan bermula dan keadaan terminal dicapai melalui kitaran hayat, bukan semasa penciptaan.
   • Keutamaan — tiada, mendesak, tinggi, sederhana atau rendah.
   • Penerima tugasan — diri anda sendiri atau mana-mana ejen dalam ruang kerja.
   • Projek — pengelompokan pilihan.
4. Tekan Cipta, atau hidupkan Cipta lagi dahulu untuk membiarkan dialog terbuka bagi kemasukan pantas.

Tiada pemilih penyedia dalam dialog ini. Tiket dicipta terhadap penyedia tiket aktif ruang kerja.

Daripada ejen

Minta ejen dalam sesuatu ruang:

Cipta tiket untuk membaiki isu tamat masa log masuk pada sambungan perlahan.

Ia memanggil alat MCP create_ticket. Keutamaan pada alat itu ialah integer, bukan nama:

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

Nilai	Keutamaan
0	Tiada
1	Mendesak
2	Tinggi
3	Sederhana
4	Rendah

Hanya workspace_id dan title yang wajib; description, priority, assignee (id ejen) dan team_id bersifat pilihan. Alat ini dikelaskan sebagai penulisan segerak vendor dan meminta persetujuan anda sebelum ia dijalankan.

Kemas kini status tiket

Tiket mengikut kitaran hayat ini:

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

done, failed dan cancelled bersifat terminal. cancelled boleh dicapai daripada mana-mana status bukan terminal. done dan failed boleh dicapai daripada inProgress atau inReview; open juga boleh bergerak terus ke blocked. Pemilih status UI menyenaraikan setiap status kecuali failed — ejen menandakannya dengan fail_ticket.

Untuk menukarnya, gunakan mana-mana yang berikut:

• baris Status dalam bar sifat tiket,
• submenu Status pada menu klik kanan tiket dalam senarai,
• cip Status pada bar terapung selepas memilih berbilang tiket.

Graf kitaran hayat mengikat ejen, bukan anda

Setiap perubahan status yang dibuat dari UI dipaksa masuk, melangkau graf itu sepenuhnya — anda boleh memindahkan tiket ke mana-mana status yang disenaraikan oleh pemilih, termasuk membuka semula tiket yang done, failed atau cancelled. Pemilih tidak menawarkan failed sebagai sasaran. Rajah di atas mengawal ejen dan automasi: peralihan tidak sah yang dicuba oleh alat MCP atau penyelaras akan dilog dan diabaikan, bukan digunakan.

Perubahan status memancarkan acara domain (TicketStatusChanged, TicketCompleted dan lain-lain) yang boleh mencetuskan pipeline. Lihat Sediakan pencetus pipeline.

Tugaskan tiket

1. Buka tiket.
2. Dalam bar sifat, tetapkan Penerima tugasan — diri anda sendiri, ahli ruang kerja lain, atau ejen.

Menugaskan tidak memulakan apa-apa kerja

Penugasan merekodkan pemilikan dan tidak melakukan apa-apa lagi. Ia tidak mencipta ruang, tidak mengubah status dan tidak menghantar ejen — TicketAssigned ialah isyarat audit tulen tanpa penghantar di belakangnya. Untuk membuat ejen bekerja, hantar mesej kepadanya dalam sesuatu ruang (lihat Sembang dengan ejen).

Satu pengecualian: TicketAssigned ialah jenis acara yang boleh anda sambungkan pencetus pipeline, jadi templat anda sendiri boleh bertindak balas terhadap penugasan.

Tambah label

Label digunakan secara pukal daripada senarai tiket, bukan daripada tiket tunggal — bar sifat tiada kawalan label.

1. Tudingkan kursor pada satu baris dalam senarai tiket dan tandakan kotak semaknya. Tandakan sebanyak yang anda perlukan; bar terapung muncul sebaik sahaja ada yang dipilih.
2. Dalam bar itu, buka cip Label.
3. Pilih satu label. Ia ditambah pada setiap tiket terpilih yang belum memilikinya; label sedia ada tidak pernah dipadamkan. Kosongkan label membuang kesemuanya. Pemilih menyenaraikan label yang sudah ada pada tiket dalam ruang kerja. Ejen boleh menambah nama baharu melalui update_ticket atau tickets.patch.

Pautkan tiket

Hubungan berada pada kad Hubungan tiket dalam bar sifat, atau di sebalik Kaitkan dengan dalam menu klik kanan senarai.

1. Buka tiket dan cari kad Hubungan.
2. Tekan kawalan tambahnya dan pilih hubungan:

Hubungan	Maksud
Sub-isu bagi…	Induk tiket ini ialah tiket yang satu lagi
Induk bagi…	Tiket yang satu lagi ialah anak tiket ini
Disekat oleh…	Tiket ini disekat oleh tiket yang satu lagi
Menyekat…	Tiket ini menyekat tiket yang satu lagi
Berkaitan dengan…	Simetri, tiada arah yang tersirat
Pendua bagi…	Tiket ini menduakan tiket yang satu lagi

3. Pilih tiket sasaran.

Diduakan oleh muncul dalam kad tetapi bukan dalam pemilih — ia ialah songsangan Pendua bagi dan ditetapkan daripada tiket yang satu lagi. Setiap hubungan yang disenaraikan boleh diklik untuk membuka tiket yang dipautkan dan boleh dibuang apabila kursor ditundingkan ke atasnya.

Hubungan induk dan sub-isu disimpan pada tiket itu sendiri dan bukan sebagai baris pautan, jadi memadam induk melata kepada anak-anaknya (lihat di bawah), manakala pautan menyekat dan berkaitan tidak.

Tambah rakan kolaborasi

Rakan kolaborasi ialah senarai nama pada tiket — siapa yang terlibat, dalam kapasiti apa.

1. Buka tiket.
2. Tekan kawalan tambah orang pada kad Tambah rakan kolaborasi.
3. Pilih ejen.

Tiga peranan itu ialah assignee, collaborator (lalai) dan reviewer. Pemilih UI hanya menyenaraikan ejen ruang kerja dan sentiasa menulis peranan lalai; manusia boleh muncul sebagai baris tetapi tidak ditawarkan dalam menu itu. Alat MCP add_ticket_collaborator menerima role.

Menambah rakan kolaborasi menulis satu baris dan tidak menerbitkan acara domain; ia tidak memberikan akses ruang. Untuk memasukkan ejen ke dalam perbualan, tambahkannya sebagai peserta dari pengepala ruang — lihat Ruang.

Padamkan tiket

Gunakan Padam tiket di bahagian bawah bar sifat, menu klik kanan, atau tindakan padam pada bar terapung selepas memilih berbilang tiket.

Pemadaman adalah tempatan sahaja

Tiket yang datang daripada penjejak luar tidak dipadamkan di sana — tiada penyedia yang menyokongnya — jadi ia boleh muncul semula pada penyegerakan seterusnya. Pemadaman juga melata: rakan kolaborasi tiket dan mana-mana tiket anak ikut bersama.

Panduan berkaitan

• Wakilkan kerja kepada ejen
• Susun kerja dengan projek
• Sembang dengan ejen
• Rujukan kitaran hayat tiket

Konsep berkaitan

• Tiket
• Acara domain