Bagaimanakah anda menggunakan pembantu AI untuk memahami pangkalan kod yang besar atau tidak dikenali yang baru anda warisi?

Question

Accepted Answer

AI bagus untuk **orientasi** dalam kod yang tidak dikenali — tetapi hanya jika anda memastikannya **berasas pada fail sebenar** daripada membiarkannya menggambarkan versi generik tentang apa yang sistem mungkin lakukan. Tunjukkan kepada jalur sebenar dan minta ia membaca sebelum menjelaskan.

## Strategi, daripada luas kepada khusus

- **Minta peta peringkat tinggi dan titik masuk** — "Di manakah permintaan bermula? Apakah modul utama dan bagaimana hubungan mereka?" Ini memberi anda gambaran keseluruhan sebelum anda menyelam.
- **Jejak satu ciri dari hujung ke hujung** — pilih satu ciri sebenar (cth "log masuk pengguna") dan biarkan AI menjejaknya dari laluan, melalui pengawal dan perkhidmatan, ke pangkalan data. Penjejakan mengalahkan gambaran keseluruhan abstrak.
- **Ringkaskan satu modul pada satu masa** — "Ringkaskan apa yang `src/billing/` bertanggungjawab," bukan seluruh repo sekaligus.
- **Jelaskan kod yang tidak dikenali** — tampal fungsi yang rumit dan tanya apa yang dilakukannya dan mengapa, baris demi baris.
- **Hasilkan gambaran keseluruhan kebergantungan** — apa yang mengimport apa, modul mana yang pusat, di mana gandingannya.

## Pastikan ia berasas

```text
❌ UNGROUNDED: "How does authentication usually work in a Node app?"
   → generic textbook answer; may not match THIS codebase at all

✅ GROUNDED: "Read src/auth/login.js and src/middleware/session.js.
             Trace what happens when POST /login is called, step by step,
             citing the functions involved."
   → the AI must read the actual files → its explanation maps to YOUR system
```

Versi berasas memaksa AI untuk mendasarkan jawapannya pada kod anda, jadi anda dapat mengesahkan setiap langkah terhadap fail sebenar daripada mempercayai generaliti yang boleh dipercaya.

## Mengapa ini penting

Mewarisi pangkalan kod yang besar adalah terutamanya **masalah membaca dan memetakan**, dan itulah tepat di mana AI mempercepatkan anda — ia boleh meringkaskan modul, mengesan aliran, atau menjelaskan fungsi kripto dalam beberapa saat, mengubah hari membaca sejuk menjadi penerokaan berpandu. Risikonya ialah gesaran yang tidak berasas memberi anda jawapan yang percaya diri, generik yang tidak sepadan dengan kod sebenar. Menambat setiap soalan kepada **laluan fail sebenar** dan mengesahkan jejakannya terhadap fail tersebut mengekalkan kecepatan AI tanpa mewarisi halusinasinya — anda membina model mental yang tepat lebih cepat, dan anda boleh mempercayainya kerana anda memeriksanya terhadap sumber.