Tinjauan kode

Gunakan ChatGPT atau Codex untuk memeriksa perubahan kode sebelum Anda melakukan commit atau push.

Memulai tinjauan

Di ChatGPT Work, unggah kode yang ingin ditinjau atau sediakan kode tersebut melalui plugin sumber yang telah diinstal. Dalam prompt, tentukan pull request, branch, commit, file, dan kriteria peninjauan.

Meninjau di aplikasi

Buka panel tinjauan untuk memahami apa yang berubah, memberikan umpan balik khusus per baris, dan menentukan apa yang akan di-stage, dikembalikan, di-commit, atau di-push.

Untuk meminta Codex meninjau perubahan, ketik /review di kolom penulisan. Pilih Tinjau terhadap cabang dasar atau Tinjau perubahan yang belum di-commit. Codex melaporkan temuan yang diprioritaskan tanpa mengubah worktree Anda.

Panel tinjauan memerlukan proyek di dalam repositori Git. Jika proyek Anda belum menjadi repositori Git, aplikasi akan meminta Anda membuatnya.

Ketik /review untuk membuka preset peninjauan CLI. Codex memulai peninjau khusus yang membaca diff terpilih dan melaporkan temuan yang diprioritaskan serta dapat ditindaklanjuti tanpa mengubah worktree Anda.

Ketik /review di kotak penulisan ekstensi IDE. Pilih Tinjau terhadap cabang dasar atau Tinjau perubahan yang belum di-commit. Codex melaporkan temuan yang diprioritaskan tanpa mengubah worktree Anda.

Perintah /review hanya muncul jika proyek yang terbuka berada di dalam repositori Git.

Memilih cakupan tinjauan

Sebutkan pull request, branch, commit, atau file yang akan diperiksa dalam prompt Anda. Untuk meninjau file lokal yang tidak tersedia melalui plugin sumber yang telah diinstal, unggah file tersebut ke percakapan.

Perubahan yang ditampilkan

Panel tinjauan mencerminkan status repositori Git Anda, bukan hanya hal-hal yang diedit Codex. Ini mencakup perubahan yang dibuat oleh Codex, perubahan yang Anda buat sendiri, dan setiap perubahan lain yang belum di-commit dalam repositori.

Secara default, panel tinjauan menampilkan perubahan Belum di-stage. Gunakan Di-stage untuk indeks Git, Commit untuk commit yang dipilih, Cabang untuk diff terhadap cabang dasar Anda, atau Giliran terakhir untuk giliran asisten terbaru.

Meninjau beberapa repositori

Jika proyek lokal mencakup beberapa folder yang didukung oleh repositori Git berbeda, panel tinjauan dapat menampilkan perubahan dari setiap repositori. Buka pemilih repositori di header tinjauan untuk memeriksa repositori lain dan melihat baris yang ditambahkan atau dihapus tanpa meninggalkan panel tinjauan saat ini.

Pilih Giliran terakhir untuk melihat perubahan terbaru asisten di seluruh repositori yang disertakan. Pemilih repositori menampilkan Semua repo untuk tampilan tersebut. Cakupan tinjauan lainnya, seperti Belum di-stage, Di-stage, dan Cabang, berlaku untuk repositori yang Anda pilih.

Pilih salah satu cakupan /review berikut:

• Tinjau terhadap cabang dasar menemukan merge base dan meninjau diff branch Anda.
• Tinjau perubahan yang belum di-commit mencakup file staged, unstaged, dan untracked.
• Tinjau commit meninjau kumpulan perubahan yang tepat untuk commit yang dipilih.
• Instruksi tinjauan khusus memfokuskan peninjauan pada kriteria yang Anda berikan.

Pilih salah satu cakupan /review berikut:

• Tinjau terhadap cabang dasar membandingkan branch Anda saat ini dengan branch yang Anda pilih.
• Tinjau perubahan yang belum di-commit meninjau perubahan dalam worktree Anda.

Menggunakan hasil tinjauan

Temuan peninjauan muncul di percakapan web. Mintalah bukti, minta peninjauan tindak lanjut yang lebih sempit, atau minta ChatGPT menyiapkan file yang telah direvisi.

Hasil tinjauan kode

Temuan tinjauan muncul sebagai komentar sebaris di panel tinjauan.

Secara default, peninjauan berjalan dalam percakapan saat ini. Di Pengaturan > Umum > Tinjauan kode, pilih Terpisah untuk memulai percakapan peninjauan terpisah. Lihat pengaturan pengembang.

Peninjauan muncul sebagai satu giliran dalam transkrip. Tetapkan review_model di config.toml jika Anda ingin peninjauan menggunakan model yang berbeda dari sesi saat ini.

Secara default, peninjauan berjalan dalam percakapan saat ini. Tetapkan chatgpt.reviewDelivery ke detached jika Anda ingin /review memulai percakapan peninjauan terpisah. Lihat referensi pengaturan ekstensi IDE.

Jika Anda meminta ChatGPT menyiapkan file yang telah direvisi, alat dan izin ruang kerja yang tersedia untuk percakapan tersebut tetap berlaku.

Jika Anda meminta Codex menerapkan perbaikan yang ditemukannya, pengaturan sandbox dan persetujuan normal Anda akan berlaku.

Menavigasi panel tinjauan

• Mengeklik nama file biasanya akan membuka file tersebut di editor pilihan Anda. Anda dapat memilih editor default di pengaturan pengembang.
• Mengeklik latar belakang nama file akan memperluas atau menciutkan diff.
• Mengeklik satu baris sambil menahan Cmd akan membuka baris tersebut di editor pilihan Anda.
• Jika Anda puas dengan suatu perubahan, Anda dapat melakukan stage atau mengembalikan perubahan yang tidak diinginkan.

Komentar sebaris untuk umpan balik

Komentar sebaris memungkinkan Anda melampirkan umpan balik langsung ke baris tertentu dalam diff. Cara ini sering kali merupakan yang tercepat untuk mengarahkan Codex ke perbaikan yang tepat.

Untuk meninggalkan komentar sebaris:

1. Buka panel tinjauan.
2. Arahkan penunjuk ke baris yang ingin Anda komentari.
3. Pilih tombol + yang muncul.
4. Tulis umpan balik Anda dan kirimkan.
5. Setelah selesai memberikan umpan balik, kirim pesan kembali ke chat.

Karena komentar bersifat khusus per baris, Codex dapat merespons dengan lebih tepat dibandingkan jika diberi instruksi umum.

Codex memperlakukan komentar sebaris sebagai panduan tinjauan. Setelah meninggalkan komentar, kirim pesan tindak lanjut yang menyatakan maksud Anda secara eksplisit, misalnya, “Tangani komentar sebaris dan pertahankan cakupan seminimal mungkin.”

Tinjauan pull request

Jika Codex memiliki akses GitHub ke repositori Anda dan proyek saat ini berada di cabang pull request, aplikasi desktop ChatGPT dapat membantu Anda menangani umpan balik pull request tanpa meninggalkan aplikasi. Bilah samping menampilkan konteks pull request dan umpan balik dari peninjau, sedangkan panel tinjauan menampilkan komentar di samping diff sehingga Anda dapat meminta Codex menangani masalah dalam chat yang sama.

Instal GitHub CLI (gh) dan autentikasi dengan gh auth login agar Codex dapat memuat konteks pull request, komentar tinjauan, dan file yang diubah. Jika gh tidak tersedia atau belum diautentikasi, detail pull request mungkin tidak muncul di bilah samping atau panel tinjauan.

Gunakan alur ini jika Anda ingin mempertahankan seluruh siklus perbaikan di satu tempat:

1. Buka panel tinjauan pada cabang pull request.
2. Tinjau konteks pull request, komentar, dan file yang diubah.
3. Minta Codex memperbaiki komentar tertentu yang ingin Anda tangani.
4. Periksa diff yang dihasilkan di panel tinjauan.
5. Lakukan stage, commit, dan push perubahan ke cabang pull request saat Anda siap.

Untuk tinjauan yang dipicu GitHub, lihat Menggunakan Codex di GitHub.

Melakukan stage dan mengembalikan file

Panel tinjauan mencakup tindakan Git agar Anda dapat menyesuaikan diff sebelum melakukan commit.

Anda dapat melakukan stage, membatalkan stage, atau mengembalikan perubahan pada tingkat berikut:

• Seluruh diff: Gunakan tombol tindakan di header tinjauan, seperti Stage semua atau Kembalikan semua.
• Per file: Lakukan stage, batalkan stage, atau kembalikan satu file.
• Per hunk: Lakukan stage, batalkan stage, atau kembalikan satu hunk.

Gunakan stage jika Anda ingin menerima sebagian pekerjaan, dan gunakan pengembalian jika Anda ingin membuangnya.

Status di-stage dan belum di-stage

Git dapat merepresentasikan perubahan yang sudah dan belum di-stage dalam file yang sama. Jika hal itu terjadi, panel dapat menampilkan file yang sama di kedua tampilan. Ini adalah perilaku Git yang normal.