Kako opisati grešku AI asistentу kako bi je mogao precizno dijagnosticirati?

Question

Accepted Answer

Dobar izvještaj o grešci za AI je isto kao dobar izvještaj o grešci za čovjeka: daj mu **dovoljno konteksta da reproducira problem u svojoj glavi** i ukloni buku. AI može samo razmišljati o onome što zalijepиš — nejasni opisi proizvode nejasne pretpostavke.

## Što uključiti

- **Točna poruka greške i potpuna stack trace** — kopiraj je doslovno, ne parafraziraj. Datoteka i redak u traci su jedan od najkorisnijih tragova.
- **Relevantni kod** — funkcija koja baca iznimku plus njeni neposredni pozivači, ne cijelo repozitorij.
- **Očekivano nasuprot stvarnom ponašanju** — "Očekujem X, ali dobivam Y" je jezgra svakog izvještaja o grešci.
- **Koraci za reprodukciju** — točan unos ili slijed koji je izaziva.
- **Okruženje/verzije** — verzije jezika, framework-a i biblioteka (greška može biti specifična za verziju).
- **DB shema ili primjeri podataka** — kada greška dodiruje upit ili oblik podataka.

## Što izostavio

Nepovezane datoteke, cijelu konfiguraciju, tajne/API ključeve i teorije "Mislim da bi moglo biti X" koja pristrane dijagnozu. Daj činjenice, ne pretpostavke.

## Slaba nasuprot snažna izvještaj

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

Sa snažnom verzijom, AI može pokazati pravo na nedostajuću provjeru `undefined` i predložiti zaštitu, jer je svaka činjenica koju treba na stranici.

## Zašto je važno

AI asistent **nema pristup vašem sustavu koji se izvršava** — razmišlja samo od onoga što pružiš. Slaba izvještaj prisiljava ga da pogađa grešku, kod i okruženje istovremeno, a pogrešna pretpostavka baca vremenske krugove. Snažan izvještaj (točna trace + relevantni kod + očekivano/stvarno + repro + verzije) pretvara dijagnozu u fokusirani zadatak i obično dobija ispravku pri prvom pokušaju. Učenje pisanja čvrstih izvještaja o greškama također te čini boljim debuggerom, jer te prisiljava da izolirаš činjenice prije nego što pitaš.