Pemecahan masalah Code Review

Perbaiki Code Review yang tidak dimulai, gagal, atau dilewati karena anggaran, temukan temuan yang hilang, dan selesaikan masalah penyiapan dan REVIEW.md.

Ketika Code Review tidak berjalan sesuai harapan Anda pada sebuah pull request, mulailah dengan check run Claude Code Review. Judulnya menunjukkan sejauh mana review telah berjalan.

Periksa sejauh mana review telah berjalan

Temukan check run Claude Code Review pada pull request Anda, lalu cocokkan judulnya dengan salah satu judul umum berikut:

Review tidak dimulai

Periksa kasus-kasus berikut ketika tidak ada check run Claude Code Review yang muncul, atau ketika Claude memposting komentar yang menyatakan bahwa review dilewati.

Perintah komentar tidak memulai review

Setelah Anda memberi komentar @claude review, cari check run Claude Code Review berjudul Code review queued... atau Code review in progress... pada pull request. Reaksi 👀 pada komentar Anda tidak memastikan bahwa review akan berjalan. Jika tidak ada check run yang muncul, periksa setiap penyebab berikut:

• Code Review tidak diaktifkan untuk repositori ini: Claude tidak memposting komentar maupun check run sebagai respons terhadap perintah tersebut. Minta seorang Owner untuk menambahkan repositori.
• Komentar tidak memenuhi suatu syarat: komentar tersebut merupakan komentar inline atau isi review, bukan komentar tingkat atas yang baru, atau perintahnya tidak berada di awal komentar. Mengedit komentar sebelumnya alih-alih memposting komentar baru juga tidak dihitung, dan pull request harus dalam keadaan terbuka. Lihat syarat untuk perintah komentar dan posting komentar baru yang memenuhinya.
• Anda tidak memiliki akses tulis: Anda memerlukan izin write, maintain, atau admin pada repositori. Pada pull request dari fork, izin yang berlaku adalah izin pada repositori dasar. Kecuali pull request tersebut milik Anda, Claude dapat membalas dengan tip: "No review was started: manual reviews can only be requested by someone with write access to this repository." Minta seseorang yang memiliki akses tulis untuk memberi komentar.
• Anggaran habis: Claude memposting komentar yang diawali dengan "⚠️ Code review skipped". Lihat Review tidak berjalan dan PR menampilkan pesan anggaran.

Review tidak berjalan dan PR menampilkan pesan anggaran

Ketika anggaran organisasi Anda tidak dapat menutupi sebuah review, Code Review melewati review tersebut dan Claude memposting komentar pada pull request yang diawali dengan "⚠️ Code review skipped". Dalam beberapa kasus ini, check run berjudul Code review declined juga muncul.

Komentar tersebut menautkan ke claude.ai/admin-settings/usage, tempat admin memulihkan anggaran. Kata-katanya menunjukkan batas mana yang tercapai:

• "has reached its monthly code review spending cap": batas pengeluaran bulanan untuk Code Review telah tercapai. Review akan berjalan kembali pada awal periode penagihan berikutnya. Untuk mendapatkannya lebih cepat, minta admin untuk menaikkan batas tersebut.
• "has no extra usage available to pay for this review": saldo kredit penggunaan organisasi Anda kosong, atau batas pengeluaran bulanan keseluruhannya telah tercapai. Minta admin untuk menambahkan kredit penggunaan atau menaikkan batas tersebut.
• "is too low to start another review": sisa anggaran atau saldo kurang dari perkiraan biaya satu review. Minta admin untuk menaikkan batas atau menambahkan kredit penggunaan.

Setelah anggaran dipulihkan, beri komentar @claude review pada pull request untuk mendapatkan review yang dilewati. Syarat untuk perintah komentar berlaku, sehingga pemberi komentar memerlukan akses tulis.

Picu ulang review yang gagal atau kehabisan waktu

Jika ringkasan check run menyatakan "The review session was interrupted before it could finish. A new review of this commit has been queued automatically.", Anda tidak perlu melakukan apa pun. Review tersebut dicoba ulang satu kali secara otomatis.

Selain itu, ketika judul check run adalah Code review failed atau Code review timed out, jalankan review lagi dengan komentar atau re-run:

• Beri komentar @claude review: posting sebagai komentar tingkat atas pada pull request. Ini memulai review baru tanpa membuat pull request berlangganan ke push berikutnya.
• Klik Re-run: jika pull request tidak berasal dari fork, klik Re-run pada check Claude Code Review di tab Checks GitHub. Re-run mencakup head commit pull request saat ini dan juga tidak membuat pull request berlangganan.

Temukan masalah yang tidak ditampilkan sebagai komentar inline

Jika judul check run menyatakan bahwa masalah ditemukan tetapi Anda tidak melihat komentar review inline pada diff, periksa lokasi lain berikut tempat temuan ditampilkan:

• Details check run: klik Details di sebelah check Claude Code Review di tab Checks. Tabel tingkat keparahan mencantumkan temuan beserta file, baris, dan ringkasannya, terlepas dari apakah komentar inline diterima atau tidak.
• Anotasi Files changed: buka tab Files changed pada PR. Temuan yang memiliki baris tetapi tidak diposting sebagai komentar inline muncul di sana sebagai anotasi pada baris yang bersangkutan.
• Isi review: temuan yang tidak memiliki lokasi inline, atau yang berada di luar diff saat ini, muncul di bawah judul Additional findings dalam isi review.

Check run menyebutkan REVIEW.md

Berikut adalah empat dari pesan yang dapat dimuat check run tentang REVIEW.md:

• "This review applied the repository's review instructions (REVIEW.md) from its default branch, which is not protected against direct pushes.": review hanya membaca file root. Lihat Dari branch mana REVIEW.md dibaca untuk mengetahui apa yang berubah dengan memproteksi branch tersebut.
• "were not applied to this review: branch protection could not be confirmed": review tidak membaca REVIEW.md apa pun.
• "they link to a file this pull request modifies, or carry more links than the review checks": review melewati REVIEW.md root, atau sejumlah file REVIEW.md subdirektori sesuai angka yang disebutkan dalam pesan. Periksa file yang dilewati untuk setiap penyebab. Untuk REVIEW.md root, periksa juga file yang disertakannya:
  • Terlalu banyak tautan: file memuat lebih dari 64 tautan Markdown. Kurangi tautan menjadi 64 atau kurang.
  • Tautan yang tidak dapat diurai oleh review: file memiliki tautan Markdown yang formatnya salah. Perbaiki atau hapus tautan tersebut.
  • Tautan ke file yang diubah: file menautkan ke file atau folder yang diubah oleh pull request ini, dan review tidak dapat mengecualikan hanya baris yang berisi tautan tersebut. Tulis aturan tersebut langsung di REVIEW.md.
• "include line(s) in the root REVIEW.md were skipped on this review": REVIEW.md root Anda diterapkan, tetapi file yang disebutkan oleh baris-baris tersebut tidak diterapkan. Periksa daftar di bawah Menyertakan file lain di REVIEW.md dan, untuk skill, di bawah Menyertakan file skill.

Masalah penyiapan

Kasus-kasus ini muncul bagi Owner saat menyiapkan Code Review.

Repositori tidak tercantum di Add a repository

Cari repositori berdasarkan nama terlebih dahulu, karena dialog tidak memuat daftar yang panjang secara penuh. Dialog hanya mencantumkan repositori jika Claude GitHub App dapat mengaksesnya. Klik Install GitHub App dan berikan akses ke repositori tersebut kepada aplikasi. Ketika tidak ada repositori yang tercantum, Install GitHub App berupa tombol di dalam dialog. Jika tidak, tombol tersebut berada di bagian bawah menu filter organisasi GitHub pada dialog.

Tidak ada check run yang muncul pada pull request uji

Pastikan bahwa Allow code review aktif, bahwa repositori tercantum di bawah Repositories di bagian Code review, dan bahwa Claude GitHub App memiliki akses ke repositori tersebut. Review otomatis melewati draft pull request, dan repositori yang diatur ke Manual (@claude review) memerlukan komentar @claude review untuk memulai review pertama.

Sumber daya terkait

• Membaca dan meminta review pada pull request: arti temuan dan check run, serta perintah komentar
• Menyiapkan Code Review: untuk Owner, aktifkan Code Review dan kelola repositori
• Biaya dan penggunaan Code Review: batas pengeluaran di balik pesan anggaran
• Menyesuaikan Code Review: salinan REVIEW.md mana yang dibaca oleh review