Kaip apibūdinti klaidą AI asistentui, kad jis galėtų ją tiksliai nudiagnostikuoti?

Question

Accepted Answer

Geras klaidos pranešimas AI yra toks pat kaip geras klaidos pranešimas žmogui: suteikite jam **pakankamai konteksto, kad jis galėtų atkartoti problemą savo mintyse**, ir sumažinkite triukšmą. AI gali samprotauti tik apie tai, ką jūs įdėjote — neaiškūs aprašymai sukuria neaiškias spėliones.

## Ką įtraukti

- **Tikslią klaidos žinutę ir pilną stack trace** — nukopijuokite žodžiu į žodį, ne parafrazę. Failas ir eilutė trace yra naudingiausia užuomina.
- **Susijusį kodą** — funkciją, kuri iškelia, plius jos tiesiogius šaukiančiuosius, o ne visą repo.
- **Laukiamą vs faktinį elgesį** — "Tikėjausi X, bet gavau Y" yra bet kurio klaidos pranešimo branduolys.
- **Reprodukcijos žingsniai** — tikslus įvestis arba seka, kuri ją suaktyvina.
- **Aplinka/versijos** — kalba, sistema ir bibliotekos versijos (klaida gali būti specifinė versijai).
- **DB schema arba pavyzdiniai duomenys** — kai klaida liečia užklausą arba duomenų formą.

## Ką praleisti

Nesusijusius failus, visą konfigūraciją, paslaptis/API raktus ir "Manau, kad tai gali būti X" teorijas, kurios šališko diagnozę. Suteikite faktus, ne spėliones.

## Silpnas vs stiprus pranešimas

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

Su stipria versija AI gali tiesiogiai nukreipti į trūkstamą `undefined` patikrą ir pasiūlyti saugą, nes visos jos reikalingos faktai yra puslapyje.

## Kodėl tai svarbu

AI asistentui **nėra prieigos prie jūsų veikiančios sistemos** — jis samprotauja tik iš to, ką suteikiate. Silpnas pranešimas jį verčia spėti klaidą, kodą ir aplinką iš karto, o neteisinga spėlionė švaistė grįžimo visuomenę. Stiprus pranešimas (tikslus trace + susijęs kodas + laukiamas/faktinis + repro + versijos) diagnozę paverčia sutelktą užduotimi ir paprastai pirmą kartą gauna teisingą pataisą. Išmokus rašyti tvirtus klaidos pranešimus, jūs taip pat tampate geresniu debugeriu, nes tai verčia jus izoliuoti faktus prieš prašant.