Kako opišete napako AI asistuntu, da jo lahko pravilno diagnosticira?

Question

Accepted Answer

Dobro poročilo o napaki za AI je enako dobro poročilo o napaki za človeka: dajte mu **dovolj konteksta, da lahko težavo reproducira v svojih mislih**, in zmanjšajte šum. AI lahko razmišlja samo o tem, kar prilepite — nenavadni opisi proizvedejo nejasne ugibanja.

## Kaj vključiti

- **Natančno sporočilo o napaki in celoten sled sklada** — kopirajte besedno, ne parafrazo. Datoteka in vrstica v sledi sta najmočnejša namig.
- **Ustrezna koda** — funkcija, ki vrže napako, plus njeni neposredni klicatelji, ne celoten repozitorij.
- **Pričakovano vs dejansko vedenje** — "Pričakujem X, ampak dobim Y" je bistvo vsakega poročila o napaki.
- **Koraki za reprodukcijo** — natančen vhod ali zaporedje, ki ga sproži.
- **Okolje/verzije** — jezik, ogrodja in verzije knjižnic (napaka je lahko specifična za verzijo).
- **Shema DB ali vzorčni podatki** — ko napaka vpliva na poizvedbo ali obliko podatkov.

## Kaj izpustiti

Nerelevantne datoteke, celotna konfiguracija, skrivnosti/API ključi in "Mislim, da bi lahko bila X" teorije, ki pristranskost diagnostike. Dajte dejstva, ne slutnje.

## Šibko vs močno poročilo

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

S črto različice AI asistent lahko neposredno kaže na manjkajoči `undefined` preverk in predlaga zaščito, ker ima na strani vsa dejstva, ki jih potrebuje.

## Zakaj je to pomembno

AI asistent **nima dostopa do vašega delovanja sistema** — razmišlja samo na podlagi tega, kar navedete. Šibko poročilo ga prisili k ugibanju napake, kode in okolja hkrati, in napačno ugibanje zapravi en obhod. Močno poročilo (natančna sled + ustrezna koda + pričakevano/dejansko + koraki reprodukcije + verzije) spremeni diagnostiko v usmerjen nalog in običajno prvi poskus da pravo popravko. Učenje pisanja stisnjenih poročil o napakah vas tudi naredi boljšega razhroščevalca, ker vas prisili k izolaciji dejstev pred vprašanjem.