Skip to main content
Prompt

Prompt Debugging: Reproduksi Dulu

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

Oleh Matthews WongDiperbarui

Poin utama

Tempel prompt ini bersama laporan bug dan agent bekerja dengan urutan tetap: mereproduksi kegagalan dengan satu perintah atau test yang bisa diulang, mengumpulkan bukti, menyatakan penyebabnya dengan bukti itu, membuat fix terkecil, menjalankan ulang reproduksi yang sama, dan menyimpannya sebagai regression test. Bila bug tidak bisa direproduksi, agent berhenti dan meminta hal yang kurang. Ia tidak menebak fix.

1 file

File-nya

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

debugging-prompt-reproduce-first.md
Help me debug this. Do not change any code until you have reproduced the bug and can show what is wrong with evidence.

The bug: [WHAT HAPPENS, AND WHAT SHOULD HAPPEN INSTEAD]
How I trigger it: [STEPS, COMMAND, INPUT OR FAILING TEST, OR "UNKNOWN"]
What I already have: [ERROR MESSAGE, STACK TRACE, LOGS, OR "NOTHING YET"]

## Work in this order

1. **Reproduce.** Trigger the failure yourself with one concrete, repeatable command, input or test. Show me the command and its real output. A failing test is the best reproduction.
2. **Gather evidence.** Read the stack trace, logs, console output or network traffic. If they do not show the cause, add temporary logging or run with debug output. List every temporary line you add.
3. **State the cause.** In two or three sentences: what is wrong, where (file and line), and why it produces this symptom. Quote the evidence that proves it. If two causes fit the evidence, say so and name the check that would tell them apart.
4. **Fix.** Only now, make the smallest change that removes the cause. Do not refactor, rename or tidy nearby code.
5. **Re-run.** Run the exact reproduction from step 1 and show the output. Then run the existing test suite with the project's own command.
6. **Keep it.** Turn the reproduction into a regression test that fails without the fix and passes with it. Remove all temporary logging.

## If you cannot reproduce it

Stop. Do not guess a fix. Tell me what you tried and what happened, then ask for exactly what is missing: the steps, the input data, the logs, the version or the environment.

## Do not

- Do not edit code before step 3 is written down.
- Do not say "this should fix it". Say what you ran and what it printed.
- Do not silence the error: no empty catch blocks, no skipped or deleted tests, no loosened assertions.
- Do not fix other problems you notice. List them at the end.

## Report at the end

- **Reproduction:** the command
- **Cause:** one paragraph, with the evidence
- **Fix:** the files changed, and why
- **Proof:** the output before and after
- **Regression test:** its path and name
- **Noticed but not touched:** a list, or "nothing"

If you cannot run commands here, say so at the start. Then give me one command at a time and wait for the output I paste back before you move to the next step.
Cara memakainya

Dari unduh sampai jalan

Pakai saat

  • Agent sudah dua kali memperbaiki bug yang sama dan bug itu masih ada.
  • Anda punya pesan error atau stack trace, tetapi belum tahu penyebabnya.
  • Bug ada di kode production dan Anda ingin satu perubahan kecil yang bisa dijelaskan.
  • Anda ingin fix datang bersama test yang gagal tanpa fix tersebut.
  1. Isi tiga placeholder

    Jelaskan apa yang terjadi dan apa yang seharusnya terjadi, cara Anda memicunya, dan apa yang sudah Anda punya: pesan error, stack trace, atau log. Menulis unknown diperbolehkan; agent lalu harus mencari pemicunya lebih dulu.

  2. Tunggu reproduksinya

    Hal pertama yang harus Anda lihat adalah sebuah perintah beserta output aslinya yang menunjukkan kegagalan. Bila agent langsung mengubah kode, hentikan dan tunjuk langkah 1. Tanpa reproduksi, tidak ada cara untuk tahu apakah sebuah fix berhasil.

  3. Baca penyebabnya sebelum mengizinkan fix

    Agent menyatakan apa yang salah, file dan barisnya, serta kenapa itu menimbulkan gejalanya, dengan bukti yang dikutip. Periksa apakah bukti itu mendukung klaimnya. Bila ada dua penyebab yang cocok, agent menyebut pemeriksaan yang membedakannya.

  4. Bandingkan output sebelum dan sesudah

    Setelah fix, agent menjalankan ulang reproduksi yang sama persis dan test suite yang ada, lalu menampilkan kedua output. Laporan penutup memuat reproduksi, penyebab, fix, bukti, dan path regression test.

  5. Commit test bersama fix-nya

    Review diff-nya, pastikan logging sementara sudah dihapus, lalu commit fix dan regression test-nya bersama-sama. Daftar hal yang terlihat tetapi tidak disentuh menjadi tiket Anda berikutnya.

Isinya

Kenapa ditulis seperti ini

Tidak ada perubahan sebelum penyebab tertulis

Prompt ini menahan perubahan kode sampai penyebab dinyatakan dengan bukti. Agent yang dibiarkan sendiri membaca error, mencocokkannya dengan fix yang mirip, lalu mengubah kode. Hasilnya sering kali gejalanya berubah dan bug-nya tetap ada.

Reproduksi berupa satu perintah yang bisa diulang

Perintah atau test yang gagal bisa dijalankan lagi setelah fix, oleh agent maupun oleh Anda. Langkah manual yang ditulis sebagai narasi tidak bisa, dan sedikit bergeser setiap kali diulang.

Aturan berhenti untuk bug yang tidak bisa direproduksi

Bila kegagalan tidak muncul, agent melaporkan apa yang dicobanya dan meminta langkah, data, log, versi, atau environment yang kurang. Tanpa aturan ini, agent yang tidak bisa melihat bug tetap mengirim patch yang tampak masuk akal.

Menyembunyikan error dilarang

Tidak boleh ada catch block kosong, test yang dilewati atau dihapus, maupun assertion yang dilonggarkan. Masing-masing membuat kegagalan hilang dari output sementara cacatnya tetap ada di kode.

Reproduksi menjadi regression test

Test itu harus gagal tanpa fix dan lolos dengan fix. Itulah bukti bahwa fix menangani bug ini, dan itulah yang mencegah bug yang sama kembali tanpa ketahuan.

Perhatikan

Yang sering salah

  • Di jendela chat, agent tidak bisa menjalankan apa pun. Prompt ini mengalihkannya untuk memberi satu perintah setiap kali, dan itu hanya berhasil bila Anda menempel output aslinya tanpa diubah.
  • Bug yang bergantung pada data production, timing, atau beban mungkin tidak muncul di mesin Anda. Agent akan berhenti dan bertanya; beri log atau contoh data, bukan izin untuk menebak.
  • Fix terkecil tidak selalu merupakan desain yang tepat. Prompt ini sengaja menjaga perubahan tetap kecil; jadwalkan perombakan yang lebih besar sebagai tugas tersendiri.
  • Baca sendiri regression test-nya. Test yang lolos baik dengan maupun tanpa fix tidak membuktikan apa pun.
Pertanyaan

Yang sering ditanyakan

Jawaban singkat sebelum Anda mengunduhnya.

Seperti apa prompt yang baik untuk debugging kode dengan AI?

Prompt yang menetapkan urutan kerja, bukan hanya tujuannya. Prompt ini mewajibkan reproduksi dengan output asli, bukti, penyebab yang dinyatakan beserta file dan barisnya, fix terkecil, menjalankan ulang reproduksi yang sama, dan regression test. Prompt ini juga mengatur apa yang dilakukan bila bug tidak bisa direproduksi.

Kenapa AI terus memperbaiki hal yang salah?

Biasanya karena AI tidak pernah melihat bug itu gagal. Ia membaca teks error, memilih penyebab yang paling mungkin, lalu mengubah kode tanpa pembanding untuk mengujinya. Mewajibkannya mereproduksi kegagalan lebih dulu memberi setiap langkah berikutnya sesuatu untuk diuji.

Apa yang terjadi bila agent tidak bisa mereproduksi bug?

Agent berhenti. Prompt ini menyuruhnya melaporkan apa yang dicoba dan apa hasilnya, lalu meminta persis hal yang kurang: langkah, data input, log, versi, atau environment. Agent dilarang menebak fix.

Bisakah prompt debugging ini dipakai di ChatGPT atau Claude.ai?

Bisa. Bila agent tidak bisa menjalankan perintah, prompt ini menyuruhnya mengatakan hal itu, memberi Anda satu perintah setiap kali, dan menunggu output yang Anda tempel. Prosesnya lebih lambat daripada agent yang punya terminal, tetapi urutan kerjanya tetap sama.

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 Code Review: Utamakan Kebenaran

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

  • Claude Code
  • Cursor
  • Claude.ai

1 file2.3 KB.md

Semua item toolkit