Unajaje kuelezea hitilafu kwa msaada wa AI ili iweze kuagiza kwa usahihi?

Question

Accepted Answer

Ripoti nzuri ya hitilafu kwa AI ni sawa na ripoti nzuri ya hitilafu kwa binadamu: itikie **muktadha wa kutosha ili kurudia tatizo katika akili yake**, na kuacha kelele. AI inaweza kufikiria tu juu ya kile unachobandika — maelezo yasiyoeleweka huuzisha tabakataka yasiyoeleweka.

## Kile cha kujumuisha

- **Ujumbe halisi wa kosa na stack trace kamili** — kunakili kwa uhalisi, si muhtasari. Faili na mstari katika stack ni kidokezo muhimu zaidi.
- **Koodi inayohusiana** — chaguo la kuomba litakatotupa pamoja na waita wake wa karibu, si hazina yote.
- **Takazo haba na takazo ya kweli** — "Nataka X, lakini ninapata Y" ni msingi wa ripoti yoyote ya hitilafu.
- **Hatua za kurudia** — ingizo halisi au mlolongo unaouzzisha.
- **Mazingira/matoleo** — lugha, matoleo ya muundo na maktaba (hitilafu inaweza kuwa maloezi-spesific).
- **Mschemo wa DB au data ya sampuli** — wakati hitilafu inakamatia hoja au umbo la data.

## Kile cha kuacha

Faili zisizohusiana, muktadha yako mzima, siri/funguo za API, na "Nafikiri inaweza kuwa X" nadharia zinazokuvuta diagnizi. Itikie ukweli, si subira.

## Ripoti nyinyi haba dhidi ya imara

```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.
```

Ku kuvutia toleo imara, AI inaweza kuashiria moja kwa moja kwenye kaji ya `undefined` inayokosa na kupendekezwa kuzuia, kwa sababu kila ukweli unastakiwa uko katika ukurasa.

## Kwa nini inakubalika

Msaada wa AI hauna **ufahamu wa mfumo wako wa kuendesha** — inafikiria tu kutoka kile unachotoa. Ripoti nyinyi inazuia kuweka AI kubahatisha kosa, koodi, na mazingira yote kwa wakati mmoja, na tabakataka isiyofaa huzaa mzunguko. Ripoti imara (trace halisi + koodi inayohusiana + takazo/kweli + kurudia + matoleo) inabadili diagnizi kuwa kazi iliyofokuswa na kawaida huanzisha mwenyeji sahihi hapo kwa mara ya kwanza. Kujifunza kuandika ripoti nzuri ya hitilafu pia inakufanya kuwa debugger bora wewe mwenyewe, kwa sababu inakazimu kutenga ukweli kabla ya kuuliza.