Jak chybu popsat, aby šla opravit
Šablona, která z „nefunguje to“ udělá zadání. Nejrychlejší cesta k opravě.
10 minlekce 59/107
Po lekci umíš
- Umíš popsat chybu tak, že jde reprodukovat
- Víš, které tři informace jsou nutné
- Umíš rozlišit příznak od příčiny
Kvalita opravy je přímo úměrná kvalitě popisu. Tohle platí u Clauda stejně jako u člověka.
Tři nutné informace
Co jsem udělal
Přesné kroky. „Otevřel jsem /objednavky, klikl na první řádek, změnil množství na 3 a dal Uložit.“
Co jsem čekal
„Množství se změní a zobrazí se potvrzení.“
Co se stalo
„Stránka se překreslila, ale množství zůstalo původní. Bez chybové hlášky.“
Bez druhého bodu nemá Claude jak poznat, co je vlastně špatně. „Nefunguje to“ neříká, jestli měl formulář odeslat e-mail, nebo přesměrovat na jinou stránku.
Šablona
Hlášení chyby
Univerzální popis chyby. Zkopíruj, doplň, odešli.
Chyba v aplikaci. **Kroky:** 1. [CO JSEM UDĚLAL] 2. [DALŠÍ KROK] **Čekal jsem:** [OČEKÁVÁNÍ] **Stalo se:** [SKUTEČNOST] **Prostředí:** [prohlížeč / mobil / lokálně nebo naostro] **Chybová hláška:** [CELÝ TEXT NEBO „žádná“] **Kdy to naposledy fungovalo:** [NIKDY / PŘED POSLEDNÍ ZMĚNOU / NEVÍM] Postup: 1. Řekni mi, co si myslíš, že je příčina, a proč. 2. Ověř to – podívej se do kódu, ne jen odhaduj. 3. Až budeš mít jistotu, navrhni opravu. Neopravuj naslepo.
„Kdy to naposledy fungovalo“
Nejpodceňovanější řádek v celé šabloně.
Když víš, že to fungovalo před poslední změnou, zúžil jsi hledání z celého projektu na pár souborů. To je obrovský rozdíl.
Fungovalo to a teď ne
Když se rozbilo něco, co dřív šlo.
Tohle fungovalo a teď ne: [POPIS] Podívej se, co se v projektu změnilo od posledního commitu, a řekni mi, která z těch změn to nejpravděpodobněji způsobila. Vysvětli proč. Pokud to z posledních změn nevyplývá, řekni mi to rovnou – budeme hledat jinde.
Příznak versus příčina
Příznak je to, co vidíš. Příčina je to, co to způsobilo.
| Příznak | Možná příčina |
|---|---|
| Stránka je bílá | Chyba při vykreslování – v konzoli bude důvod |
| Data se nenačetla | Chyba v API, chybějící klíč, nebo se dotaz vůbec neposlal |
| Formulář nereaguje | Chyba v obsluze tlačítka – požadavek se neodeslal |
| Vypadá to rozházeně | Chybí styly, nebo se změnila třída |
Oprava příznaku vypadá jako úspěch a vrátí se za den. Když ti Claude navrhne „skryjeme to, když to není“, zbystři: možná to jen zamete pod koberec.
Je to oprava, nebo záplata?
Když navrhovaná oprava vypadá podezřele jednoduše.
Než tu opravu přijmu, chci vědět:
1. Opravuje to příčinu, nebo jen skrývá příznak?
2. Proč ta situace vůbec nastala?
3. Může nastat i jinde v projektu ze stejného důvodu?
Když je to jen záplata, řekni mi, jak by vypadala skutečná oprava
a co by stála za práci.Vzpomeň si na poslední problém, který jsi v projektu měl, a zpětně ho zapiš do šablony z téhle lekce.
Když u některé kolonky nevíš, co bys napsal, máš odpověď na to, proč hledání trvalo dlouho.
Co si odnést
- Tři nutné informace: co jsem udělal, co jsem čekal, co se stalo.
- „Kdy to naposledy fungovalo“ zužuje hledání nejvíc ze všeho.
- Rozlišuj příznak a příčinu. Rychlá oprava příznaku se vrací.
- Než přijmeš opravu, zeptej se, jestli řeší příčinu.
Máš to za sebou?
Označ lekci jako hotovou, ať víš, kde jsi skončil. Nic se tím neuzamkne.
Další lekceKdyž oprava nefungujeObsah aktualizován: 21. srpna 2026