Triage kotak masuk

Panduan ini menunjukkan cara mengerjakan kotak masuk: satu permukaan yang mengumpulkan semua hal yang memblokir Anda atau secara eksplisit meminta Anda — persetujuan agen yang tertunda, sinkronisasi tiket yang gagal, dan setiap pull request yang melibatkan Anda sebagai peninjau atau penulis.

Buka kotak masuk

1. Klik Kotak masuk di bilah sisi. Lencananya menghitung persetujuan agen yang tertunda, sinkronisasi yang gagal, dan PR terbuka yang menunggu tinjauan Anda.
2. Atau tekan ⌘K dan jalankan perintah navigasi Kotak masuk.
3. Atau buka langsung melalui tautan dalam ke /workspaces/<workspace-id>/inbox.

Entri di bilah sisi selalu menampilkan jumlah terkini, sehingga Anda dapat melihat pekerjaan triage menumpuk tanpa membuka halamannya.

Baca tingkat keparahan sekilas

Pindai dari atas ke bawah; kotak masuk sudah diurutkan berdasarkan tingkat urgensi:

1. Strip Perlu perhatian Anda yang disematkan berada di atas bagian-bagian PR. Setiap kartu membawa chip tingkat keparahan. Sumber terdaftar (agen yang tersangkut pada permintaan konfirmasi, sinkronisasi tiket yang cerminan vendornya basi) memancarkan Terblokir.
2. Di dalam strip, tingkat keparahan yang paling mendesak tampil lebih dulu; jika seri, item yang paling lama menunggu didahulukan.
3. Di bawah strip, PR dikelompokkan ke dalam bagian siklus hidup tinjauan yang tetap — Perlu tinjauan Anda, Dikembalikan ke Anda, Disetujui, Draf, Menunggu peninjau, Sedang digabung dan baru saja digabung, Menunggu penulis. Bagian teratas adalah yang membutuhkan Anda; sisanya menunjukkan posisi PR Anda. Perlu tinjauan Anda mencakup PR yang masih meminta tim tempat Anda bernaung di forge yang mendukungnya (GitHub menghapus tim itu setelah salah satu rekan tim meninjau).

Sebuah item hanya masuk ke kotak masuk jika ia memblokir sesuatu atau secara eksplisit meminta Anda. Strip kosong plus daftar bagian yang kosong hanya menampilkan Semua sudah tertangani bila kekosongan itu dapat dipercaya.

Satu kotak masuk di semua forge

Jika ruang kerja memuat repo di lebih dari satu host kode, kotak masuk menggabungkannya menjadi satu aliran — pull request GitHub dan pull request Bitbucket berada di bagian yang sama, diurutkan berdasarkan waktu alih-alih dikelompokkan menurut vendor. Meta repo #number pada baris itulah yang membedakannya.

“Milik Anda” diselesaikan per forge, karena Anda adalah akun yang berbeda di masing-masing forge. Sebuah pull request hanya dianggap milik Anda, atau meminta tinjauan Anda, jika cocok dengan identitas Anda pada forge tempat repo itu benar-benar berada.

Forge yang sedang down atau tidak terhubung tidak menyumbang apa pun dan membiarkan sisa kotak masuk tetap utuh — satu koneksi yang rusak tidak pernah mengosongkan seluruh daftar. Status kosong menyebutkan peringatan alih-alih Semua sudah tertangani ketika setiap login forge masih belum terselesaikan (Tidak bisa mengonfirmasi akun GitHub Anda — teksnya tetap menyebut GitHub), ketika githubstatus.com melaporkan insiden, atau ketika instalasi GitHub App yang mencakup repo tertaut ditangguhkan.

Bersihkan strip perhatian

Setiap kartu di strip memiliki satu tindakan lanjutan:

1. Jika sebuah kartu adalah konfirmasi agen yang tertunda, klik Tinjau — Anda akan dibawa ke space agen tersebut dengan konfirmasi yang tertunda. Setujui atau tolak di sana (lihat Chat dengan agen).
2. Jika sebuah kartu menyatakan Sinkronisasi gagal untuk suatu vendor, klik Terbuka — Anda akan dibawa ke Pengaturan → Ruang kerja → Umum, yang kartu Kesehatan sinkronisasi-nya menampilkan sinkronisasi terakhir setiap koneksi, rentetan kegagalan berturut-turut, dan hasil terbarunya. Hanya kegagalan terbaru per vendor yang muncul di kotak masuk, sehingga sinkronisasi yang pulih akan membersihkan kartunya.
3. Kartu hilang dengan sendirinya begitu status yang mendasarinya terselesaikan (agen sudah dijawab, sinkronisasi pulih) — tidak ada yang perlu ditutup secara manual.

Ini konfirmasi per giliran, bukan persetujuan tata kelola

Kartu “persetujuan agen” adalah agen yang sedang berjalan yang berhenti sejenak untuk meminta izin atas satu tindakan, di percakapannya sendiri. Ini berbeda dari catatan Approval tata kelola yang dibuat agen dengan alat MCP persetujuan — catatan itu tidak punya layar manusia di mana pun dalam aplikasi dan tidak pernah muncul di sini.

Kesehatan sinkronisasi bersifat hanya-baca

Kartu ini melaporkan koneksi sinkronisasi tiket; selain tombol Sinkronkan sekarang, kartu ini tidak dapat membuat, mengedit, atau menyambungkan ulang sebuah koneksi, dan tidak ada layar lain yang bisa melakukannya juga. Tanpa koneksi yang dikonfigurasi, kartu ini hanya menampilkan “Belum ada koneksi sinkronisasi”, seperti yang ditampilkan ruang kerja baru.

Saring hingga yang memblokir

1. Tekan f (saat tidak ada kolom teks yang difokuskan) untuk membuka menu filter, atau klik tombol filter di bilah alat.
2. Pilih kombinasi apa pun dari status, penulis, reviewer, konten, pemilik/nama repo, rentang tanggal, atau cepat ditinjau. Jumlah faset di menu menunjukkan berapa banyak item kotak masuk yang cocok dengan setiap opsi.
3. Filter aktif muncul sebagai chip di bilah di atas daftar; klik ✕ pada chip untuk menghapus kriteria itu.
4. Gunakan rel kiri untuk melompat antarbagian — setiap entri menampilkan jumlah terkini dan sorotannya mengikuti posisi gulir Anda. Klik tajuk bagian untuk menciutkan bagian yang tidak Anda triage (misalnya Draf saat membereskan tinjauan).
5. Klik tajuk kolom (judul, perubahan, atau diperbarui) untuk mengurutkan setiap bagian; klik lagi kolom yang aktif untuk membalik arahnya. Tombol opsi tampilan mengatur visibilitas draf, jendela baru saja digabung, properti baris, pengurutan, dan pengelompokan (hanya pengelompokan menurut penulis yang mengubah tata letak kotak masuk).

Filter di sini independen dari antrean PR — mempersempit kotak masuk tidak pernah mengubah filter antrean, dan sebaliknya.

Bertindak atas item PR

1. Klik baris mana pun untuk membuka halaman detail PR.
2. Jika PR berada di Perlu tinjauan Anda, tinjau PR itu dan kirimkan keputusan Anda — lihat Meninjau dan menggabungkan PR.
3. Jika PR berada di Dikembalikan ke Anda (perubahan diminta atau CI gagal), push perbaikan dari checkout Anda atau serahkan tindak lanjutnya kepada agen.
4. Jika PR berada di Disetujui, gabungkan dari halaman detailnya.
5. Jika Anda lebih memilih mendelegasikan tinjauan daripada melakukannya sendiri, lihat Kirim agen peninjau dan siklus hidup pengiriman.

Setelah status yang mendasarinya berubah (tinjauan Anda masuk, PR digabungkan), pengklasifikasi memindahkan PR ke bagian barunya secara otomatis.

Urungkan tindakan yang keliru

1. Tekan ⌘Z untuk mengurungkan tindakan terakhir, ⌘⇧Z untuk mengulanginya.
2. Jika kolom teks sedang difokuskan, ⌘Z mengedit teks kolom itu — klik di luar kolom terlebih dahulu untuk mengurungkan tindakan tingkat aplikasi.

Cari pintasan di tempat

Tekan ? (saat tidak ada kolom teks yang difokuskan) untuk membuka lembar contekan keyboard. Lembar itu mencantumkan setiap pengikatan yang aktif di rute saat ini, termasuk pintasan filter f milik kotak masuk. Peta lengkapnya ada di referensi pintasan keyboard.

Kendalikan dari palet perintah

1. Tekan ⌘K di mana saja untuk membuka palet perintah.
2. Ketik Kotak masuk untuk melompat ke halaman itu, atau ketik judul PR — palet mencantumkan pull request yang cocok dan membuka yang Anda pilih.
3. Saat kotak masuk terbuka, jalankan Salin tautan halaman ini untuk menyalin URL tersebut untuk dibagikan. Perintah ini menyalin rute saat ini, jadi URL-nya adalah URL kotak masuk hanya ketika Anda berada di halaman ini.

Segarkan sesuai permintaan

Kotak masuk diperbarui secara langsung, tetapi jika Anda menduga datanya basi, klik kontrol segarkan di bilah alat — tindakan ini memaksa penyapuan sisi server secara langsung atas setiap forge yang terhubung dan mengambil ulang overlay yang digabungkan/ditinjau. Ikonnya berputar hingga setiap pengambilan selesai.

Panduan terkait

• Meninjau dan menggabungkan PR
• Chat dengan agen
• Kirim agen peninjau

Konsep terkait

• Siklus hidup pengiriman