Tinjauan kode

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

Memulai tinjauan

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 working tree Anda.

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

Memilih cakupan tinjauan

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.

Menggunakan hasil tinjauan

Hasil tinjauan kode

Temuan tinjauan muncul sebagai komentar sebaris di panel tinjauan.

Secara default, tinjauan dijalankan dalam chat saat ini. Di Pengaturan > Umum > Tinjauan kode, pilih Terpisah untuk memulai chat tinjauan terpisah. Lihat pengaturan pengembang.

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.