Gunakan semakan berkuasa AI

Panduan ini menunjukkan cara membuat ejen penyemak menyemak sesuatu pull request dan cara menerbitkan hasilnya ke GitHub.

Mulakan semakan AI

Buka PR dan pergi ke tab Gambaran keseluruhan-nya
Buka menu limpahan ⋯ dalam baris tindakan dan pilih Tanya AI

Item itu hanya muncul semasa PR terbuka — ia tindakan sebelum cantuman. Butang yang sama ditawarkan sebagai Tanya AI pada keadaan kosong tab Semakan, sebelum sebarang semakan wujud.

Control Center memulakan pipeline pr_review yang dibenihkan dan membuka tab Semakan PR itu supaya anda boleh memantaunya. Pipeline itu:

Membuka ruang semakan PR itu sendiri, yang worktree terasingnya mempunyai PR di-checkout pada head-nya
Menyebarkan penyemak untuk tahap semakan ruang kerja — tiga secara lalai (ejen qa, architect dan engineer yang dibenihkan, secara selari). Tiada pengesanan bahasa atau domain
Mempunyai ejen ketua (CEO) mengkonsolidasikan penemuan mereka menjadi satu penerangan berpandu
Mengakhirkan: menyusun penemuan ke dalam kelompok konsensus dan mengira keputusan. Apabila perkaitan itu mencapai awaiting approval, Terbitkan ke GitHub muncul pada tab Semakan

Sejauh mana semakan itu pergi ialah tahap semakan ruang kerja — light (seorang penyemak), balanced (tiga, nilai lalai) atau thorough (kelima-limanya, menambah pakar keselamatan dan prestasi) — yang ditetapkan di Tetapan → Ruang kerja → Umum, pada kad Polisi ruang kerja. Tahap yang lebih ringan mencatat penemuan yang sama banyak; ia melaporkan lebih sedikit daripadanya di hadapan.

Semua penyemak menyiarkan ke dalam ruang semakan tunggal PR itu, dan itulah yang menjadikan penemuan mereka boleh dibandingkan. Lihat Semakan AI untuk cara bahagian-bahagiannya bersambung.

pr_review disertakan dengan pencetus manual sahaja. Untuk membolehkannya tercetus pada setiap PR yang diterbitkan, tambahkan pencetus sendiri — lihat Hantar ejen penyemak. Anda juga boleh memulakannya dari GitHub sendiri, tanpa pencetus pipeline: sebut bot pelayan itu pada PR atau tambahkan label ai-review — lihat Bercakap dengan Control Center dari PR GitHub.

Jika sesuatu toast menyatakan semakan sudah berjalan untuk pull request ini, satu memang sedang berlangsung; kekal pada tab Semakan atau buka Pipeline untuk menemuinya.

Baca penemuan

Penyemak merekodkan penemuan sebagai nod semakan dalam ruang semakan. Setiap satu membawa:

Medan	Keterangan
Jenis	`bug`, `suggestion`, `recommendation`, `question` atau `ticket`
Keutamaan	P0 (kritikal) → P3 (perkara kecil)
Kategori	`security`, `stability`, `data_integrity`, `correctness`, `performance` atau `maintainability`
Fail dan baris	Tempat penemuan itu bersauh
Kod asal	Kod yang berkaitan dengan penemuan itu
Kod dicadangkan	Pembetulan yang dicadangkan
Keyakinan	Sejauh mana keyakinan penyemak
Status	`open` → `consensus-ready` → `resolved` atau `dismissed`

Sesuatu penemuan hanya mencapai consensus-ready apabila penyemak rakan sebaya mengesahkannya. Ejen tidak boleh mengesahkan penemuannya sendiri, jadi pendapat seorang penyemak tunggal tidak pernah naik taraf sendiri.

Tab Semakan memaparkan senarai penemuan, boleh ditapis mengikut jenis dan status, dengan togol untuk penemuan yang ditutup, di sebelah artifak yang diterbitkan oleh ejen pengkonsolidasi itu. Paparan deterministik — kohort, papan pemuka berbilang paksi, diff kontrak dan visual — dikira di pihak pelayan tetapi tiada permukaan dalam apl; lihat Pengiraan semakan untuk apa yang dihasilkan oleh laluan itu.

Semak panel perselisihan

Apabila dua penyemak menyauhkan penemuan pada fail dan baris yang sama tetapi menilainya dengan sangat berbeza — keutamaan yang terpisah dua tahap atau lebih, atau seorang menyebutnya bug manakala yang lain menyebutnya suggestion — panel perselisihan muncul di atas senarai penemuan. Bacalah itu dahulu: di situlah pendapat penyemak menyimpang dan pertimbangan anda paling bernilai.

Baca keputusan

Apabila ejen ketua mengakhirkan, ia mengira satu keputusan:

Keputusan	Maksud
Ship	Tiada perkara yang menyekat ditemui
Hold	Isu yang perlu ditangani sebelum cantuman
Block	Isu kritikal yang mesti dibetulkan

Keputusan itu membawa skor keyakinan agregat dan kiraan penemuan mengikut keutamaan.

Paksi semakan kemudian dilipat masuk ke dalamnya dan ia hanya boleh menjadikannya lebih berat. Paksi berpintu yang gagal memaksa Block; paksi berpintu yang tidak dapat diselesaikan (partial) atau tidak dapat dijalankan langsung (unavailable) memaksa sekurang-kurangnya Hold. Ketiadaan bukti tidak pernah membuka pintu.

Terbitkan semakan ke GitHub

Penerbitan ialah langkah berasingan yang sengaja dikawal oleh pengguna. Pipeline pr_review menyimpan semakan itu dalam Control Center; ia tidak menyiarkan ke GitHub.

Pada tab Semakan, tunggu sehingga Terbitkan ke GitHub muncul
Tekan Terbitkan ke GitHub

Control Center menghantar satu semakan GitHub. Penemuan yang sudah diselesaikan atau ditutup dilangkau. Butang itu merangkumi setiap penemuan terbuka yang tinggal dan, pada Ship, menyerahkan APPROVE. (Alat MCP publish_review_to_github masih secara lalai hanya menggunakan penemuan yang disahkan rakan sebaya dan tidak meluluskan melainkan anda menghantar approve_on_ship.) Yang membawa sauh fail dan baris menjadi komen sebaris; semua yang lain dilipat ke dalam badan ringkasan, masing-masing dengan pengaki “— Control Center AI review” supaya sumbernya tidak kabur. Keputusan Block diserahkan sebagai REQUEST_CHANGES; Hold sebagai COMMENT; Ship sebagai APPROVE daripada butang ini. Toast kemudian memaparkan Diterbitkan. Semakan itu disiarkan di bawah identiti aplikasi pelayan.

Jika GitHub menolak sauh sebaris kerana baris itu bukan sebahagian daripada diff, seluruh semakan dihantar semula dengan setiap penemuan dilipat ke dalam badan, supaya tiada apa-apa digugurkan secara senyap.

Pipeline terbina dalam yang lain memang menyiarkan ke GitHub secara terus: cross_review, pr_triage, ticket_to_pr dan pre_merge_gate masing-masing berakhir dengan langkah komen. Hanya pr_review menahan outputnya untuk anda.

Hantar penyemak sendiri

Untuk kawalan ke atas peranan mana yang menyemak PR dan fail mana yang dilihat oleh setiap satu, gunakan alat MCP dispatch_reviewers dalam ruang semakan yang sedia ada, atau tambahkan nod penyemak pada sesuatu pipeline. Kedua-dua laluan, dengan tandatangan tepat alat itu, ada dalam Hantar ejen penyemak.