Jak popíšete chybu asistentovi s umělou inteligencí, aby ji mohl přesně diagnostikovat?

Question

Accepted Answer

Dobrá zpráva o chybě pro AI je stejná jako dobrá zpráva o chybě pro člověka: dejte jí **dost kontextu na to, aby mohla reprodukovat problém ve své hlavě**, a odstraňte šum. AI může uvažovat pouze o tom, co vložíte — nejasné popisy vedou k nejasným hádam.

## Co zahrnout

- **Přesná chybová zpráva a úplný stack trace** — zkopírujte ji doslova, ne parafrázi. Soubor a řádek v trasování jsou jednoznačně nejužitečnější vodítko.
- **Relevantní kód** — funkce, která vyvolá výjimku, plus její přímí volatelé, ne celý repozitář.
- **Očekávané vs. skutečné chování** — "Očekávám X, ale dostanu Y" je jádrem každé zprávy o chybě.
- **Kroky reprodukce** — přesný vstup nebo sekvence, která ji spustí.
- **Prostředí/verze** — jazyk, verze frameworku a knihovny (chyba může být specifická pro verzi).
- **Schéma DB nebo ukázková data** — když se chyba týká dotazu nebo tvaru dat.

## Co vynechat

Nesouvisející soubory, celou konfiguraci, tajemství/API klíče a teorie "Myslím, že by to mohlo být X", která ovlivní diagnózu. Uveďte fakta, ne domněnky.

## Slabá zpráva vs. silná zpráva

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

Silnou verzí může AI upozornit přímo na chybějící kontrolu `undefined` a navrhnout ochranu, protože všechna fakta, která potřebuje, jsou na stránce.

## Proč je důležité

Asistent s umělou inteligencí **nemá přístup k vašemu běžícímu systému** — uvažuje pouze na základě toho, co poskytnete. Slabá zpráva jej nutí hádat chybu, kód a prostředí současně, a špatný odhad ztrácí čas. Silná zpráva (přesné trasování + relevantní kód + očekávané/skutečné + kroky reprodukce + verze) změní diagnostiku na zaměřený úkol a obvykle získá správnou opravu na první pokus. Naučit se psát těsné zprávy o chybách vás také dělá lepším debuggerem, protože vás to nutí izolovat fakta, než se zeptáte.