Skip to main content
Prompt

Prompt Code Review: Utamakan Kebenaran

Prompt review yang melaporkan bug lengkap dengan file, baris, skenario gagal, severity, dan fix, tanpa komentar soal gaya.

Oleh Matthews WongDiperbarui

Poin utama

Tempel prompt ini bersama diff, branch, atau pull request. Agent membaca file yang berubah secara utuh, lalu mencari bug, edge case yang rusak, error handling yang kurang, celah keamanan, dan test yang belum ada. Setiap temuan memuat severity, file dan baris, skenario gagal yang konkret, dan saran fix. Soal gaya tidak dikomentari kecuali menyembunyikan bug, dan agent berkata terus terang bila tidak menemukan apa pun.

1 file

File-nya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

code-review-prompt.md
Review this change for correctness. I want the bugs, not a style pass.

What to review: [THE DIFF, BRANCH, PULL REQUEST OR FILES]
What the change is meant to do: [ONE OR TWO SENTENCES, OR THE TICKET TEXT]

## Before you judge

Read every changed file in full, not only the changed lines. Read the callers of anything whose behavior or signature changed, and the tests that cover it. If you only have the diff and need more to be sure, ask for the file instead of assuming what it contains.

## Look for, in this order

1. **Bugs:** wrong logic, wrong conditions, off-by-one errors, null or undefined values, wrong types, race conditions, broken callers.
2. **Broken edge cases:** empty input, zero, very large input, duplicates, retries, time zones, concurrent requests, partial failure.
3. **Missing error handling:** swallowed errors, unchecked results, no timeout, no rollback, failures the user never sees.
4. **Security:** unvalidated input, injection, missing authorization checks, secrets in code or logs, data shown to the wrong user.
5. **Missing tests:** changed behavior with no test, or tests that would still pass if the code were wrong.
6. **Intent:** compare the change with what it is meant to do, and name anything missing or extra.

## Report each finding like this

- **Severity:** blocker (wrong result, data loss, security), major (fails in a realistic case) or minor (unlikely, or low impact)
- **Where:** file path and line
- **What fails:** a concrete scenario: this input or this sequence, the result now, the result expected
- **Fix:** the smallest change that solves it, as a short snippet or a clear description

Start the reply with one line: the count per severity, and whether you would merge it. Then list the findings, blockers first.

## Do not

- No style, naming or formatting comments, unless the style hides a bug. If it does, say which bug.
- No finding without a failure scenario. If you cannot describe how it breaks, put it under "Questions", not under findings.
- Do not report a bug because you did not read the code that handles it. Check first.
- Do not pad the list. If you find nothing, say "No correctness problems found", then list what you checked.
- Do not edit any file. This is a review.

End with "Not verified": anything you could not confirm, such as code you could not see or tests you could not run.
Cara memakainya

Dari unduh sampai jalan

Pakai saat

  • Anda ingin pemeriksaan kedua atas branch sendiri sebelum membuka pull request.
  • Perubahan ditulis oleh agent dan Anda butuh review dari pihak yang tidak menulisnya.
  • Review dari AI terus berisi komentar penamaan dan format, sementara bug-nya terlewat.
  • Anda me-review pull request rekan dan ingin daftar hal yang perlu diverifikasi sendiri.
  1. Berikan perubahannya

    Di Claude Code atau Cursor, sebutkan branch atau rentang commit dan biarkan agent membaca filenya. Di jendela chat, tempel diff-nya dan, untuk bagian yang penting, file lengkap yang berubah juga.

  2. Jelaskan tujuan perubahannya

    Isi placeholder kedua dengan satu atau dua kalimat, atau teks tiketnya. Tanpa tujuan, agent bisa memeriksa apakah kodenya konsisten, tetapi tidak bisa menilai apakah kode itu melakukan hal yang benar.

  3. Baca baris pertama, lalu blocker-nya

    Balasan dibuka dengan jumlah temuan per severity dan apakah agent akan me-merge-nya. Temuan menyusul, blocker lebih dulu. Tiap temuan memberi skenario yang bisa dijadikan test: input, hasil sekarang, dan hasil yang diharapkan.

  4. Verifikasi sebelum memperbaiki

    Coba skenario gagal untuk setiap temuan blocker dan major. Model review bisa keliru tentang kode yang dibacanya terlalu cepat. Perbaiki yang sudah Anda konfirmasi, lalu jalankan prompt ini lagi pada diff yang baru.

Isinya

Kenapa ditulis seperti ini

Membaca file utuh, bukan hanya diff

Agent membaca setiap file yang berubah secara utuh, pemanggil dari apa pun yang perilakunya berubah, dan test yang mencakupnya. Banyak bug nyata berada di luar baris yang berubah: pemanggil yang masih mengirim argumen lama, atau test yang tidak lagi menguji apa pun.

Urutan pemeriksaan yang tetap

Bug, edge case, error handling, keamanan, test, lalu tujuan. Urutan ini menempatkan hal yang menimbulkan insiden di depan yang lain, dan daftar di bawah tiap butir menyebut kasus konkret seperti retry, zona waktu, dan kegagalan sebagian.

Tidak ada temuan tanpa skenario gagal

Setiap temuan harus menyebut input atau urutan mana yang membuatnya rusak, hasil sekarang, dan hasil yang diharapkan. Bila agent tidak bisa menjelaskan cara rusaknya, butir itu masuk ke Questions. Aturan ini menyingkirkan sebagian besar peringatan yang samar dari daftar.

Severity punya definisi

Blocker berarti hasil yang salah, kehilangan data, atau masalah keamanan. Major gagal pada kasus yang realistis. Minor kecil kemungkinannya atau dampaknya rendah. Dengan definisi, bagian atas daftar adalah hal yang wajib diperbaiki sebelum merge.

Boleh tidak menemukan apa pun

Prompt ini melarang agent memperpanjang daftar dan menyuruhnya menulis No correctness problems found, diikuti apa saja yang diperiksa. Bagian penutup Not verified memuat hal yang tidak bisa dikonfirmasi, jadi hasil yang bersih tidak mengklaim lebih dari cakupannya.

Perhatikan

Yang sering salah

  • Bila hanya diberi diff, agent tidak bisa melihat pemanggil maupun test-nya. Bagian Not verified akan lebih panjang, dan tempel file yang dimintanya.
  • Temuan adalah klaim, bukan fakta. Jalankan skenario gagalnya sebelum mengubah kode karena temuan itu.
  • Review oleh sesi yang sama dengan penulis kodenya cenderung setuju dengan dirinya sendiri. Mulai sesi baru untuk review.
  • Prompt ini tidak menggantikan reviewer manusia, test, maupun CI. Kode tidak dijalankan kecuali Anda minta, dan agent tidak tahu keputusan yang tidak pernah dituliskan.
Pertanyaan

Yang sering ditanyakan

Jawaban singkat sebelum Anda mengunduhnya.

Seperti apa prompt yang baik untuk code review dengan AI?

Prompt yang menyebut apa yang dicari, urutannya, dan apa isi sebuah temuan. Prompt ini mengutamakan kebenaran dan mewajibkan severity, file dan baris, skenario gagal yang konkret, serta saran fix untuk setiap temuan. Prompt ini juga memberi tahu agent apa yang tidak perlu dilaporkan.

Bagaimana cara menghentikan AI mengomentari gaya kode saat review?

Tuliskan di prompt dan beri ukuran untuk apa yang boleh dilaporkan. Prompt ini melarang komentar soal gaya, penamaan, dan format kecuali gaya itu menyembunyikan bug, serta mewajibkan skenario gagal untuk setiap temuan. Komentar tentang nama variabel tidak bisa lolos ukuran itu.

Sebaiknya menempel diff atau file lengkapnya?

Berikan keduanya bila memungkinkan. Diff menunjukkan apa yang berubah, dan file lengkap menunjukkan apakah perubahan itu benar di lingkungannya. Di agent yang bisa membaca repository, sebutkan branch-nya dan agent akan membaca file serta pemanggilnya sendiri.

Bisakah hasilnya dipercaya bila tidak ada temuan?

Percayai sebatas apa yang tercantum sebagai sudah diperiksa, tidak lebih. Balasan ditutup dengan bagian Not verified yang menyebut kode yang tidak terlihat dan test yang tidak bisa dijalankan. Review bersih atas sebuah diff lebih lemah daripada test yang lolos, jadi pertahankan keduanya.

Pelajari lebih dalam

Pelajari apa yang dikemas file ini

Pelajaran dan artikel gratis di situs ini yang menjelaskan gagasan di baliknya.

Lainnya dari toolkit

Ambil ini juga

PromptGratis

Prompt Rencana Sebelum Coding

Prompt perencanaan yang mencakup bisnis, domain, tech design, dan langkah kerja, lalu mendaftar keputusan yang perlu Anda ambil.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

PromptGratis

Prompt untuk Memahami Codebase Baru

Prompt read-only yang memetakan repository asing: fungsinya, cara menjalankannya, alur request, dan area yang berisiko.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

PromptGratis

Prompt Debugging: Reproduksi Dulu

Prompt debugging yang mewajibkan agent mereproduksi bug dan membuktikan penyebabnya sebelum menyentuh kode.

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

Semua item toolkit