Bagaimanakah anda menerangkan pepijat kepada pembantu AI supaya ia dapat mendiagnosisnya dengan tepat?

Question

Accepted Answer

Laporan pepijat yang baik kepada AI sama dengan laporan pepijat yang baik kepada manusia: berikan ia **konteks yang cukup untuk mereproduksi masalah di kepalanya**, dan kurangkan kebisingan. AI hanya dapat memberi alasan tentang apa yang anda tampal — deskripsi yang kabur menghasilkan tekaan yang kabur.

## Apa yang perlu disertakan

- **Mesej ralat yang tepat dan jejak timbunan penuh** — salin secara harfiah, bukan parafrasa. Fail dan baris dalam jejak adalah petunjuk yang paling berguna.
- **Kod yang relevan** — fungsi yang melempar plus pemanggil langsungnya, bukan seluruh repo.
- **Tingkah laku yang diharapkan vs sebenarnya** — "Saya menjangkakan X, tetapi saya mendapat Y" adalah teras setiap laporan pepijat.
- **Langkah-langkah pengeluaran semula** — input tepat atau urutan yang mencetuskannya.
- **Persekitaran/versi** — bahasa, rangka kerja, dan versi perpustakaan (pepijat boleh khusus versi).
- **Skema DB atau data sampel** — apabila pepijat menyentuh pertanyaan atau bentuk data.

## Apa yang perlu ditinggalkan

Fail yang tidak berkaitan, semua konfigurasi, rahasia/kunci API, dan teori "saya fikir ia mungkin X" yang membuatkan diagnosis. Berikan fakta, bukan tekaan.

## Laporan yang lemah vs kuat

```text
❌ WEAK: "My login is broken, it throws an error. Why?"
   → no error text, no code, no repro → the AI can only guess

✅ STRONG:
   Error (verbatim):
     TypeError: Cannot read properties of undefined (reading 'id')
       at getUser (auth.js:42)
   Code (auth.js:40-43):
```

```js
function getUser(token) {
  const session = sessions.find(s => s.token === token); // returns undefined if not found
  return session.user.id; // line 42: crashes when session is undefined
}
```

```text
   Expected: return null for an unknown token.
   Actual:   throws TypeError above.
   Repro:    call getUser('expired-token').
   Env:      Node 20, no framework.
```

Dengan versi yang kuat, AI dapat menunjuk terus ke pemeriksaan `undefined` yang hilang dan mencadangkan pengawal, kerana setiap fakta yang diperlukannya ada di halaman.

## Mengapa ia penting

Pembantu AI **tidak mempunyai akses ke sistem anda yang sedang berjalan** — ia hanya memberi alasan daripada apa yang anda berikan. Laporan yang lemah memaksanya meneka ralat, kod, dan persekitaran sekaligus, dan tekaan yang salah membuang perjalanan pulang. Laporan yang kuat (jejak tepat + kod relevan + dijangkakan/sebenarnya + repro + versi) mengubah diagnosis menjadi tugas yang tertumpu dan biasanya mendapat pembetulan yang betul pada percubaan pertama. Belajar menulis laporan pepijat yang ketat juga menjadikan anda debugger yang lebih baik, kerana ia memaksa anda mengasingkan fakta sebelum bertanya.