Kako napisati dobru prijavu greške (za AI ili programera)

Dobra prijava greške omogućuje nekome drugome, programeru ili AI-ju, da vidi isti problem koji ste vi vidjeli, bez postavljanja dodatnih pitanja. Treba joj specifičan naslov, točni koraci za ponavljanje, što ste očekivali, što se dogodilo, poruka o grešci kopirana doslovno te gdje se to dogodilo: koja stranica, preglednik, uređaj i korisnik. Jedna greška po prijavi, po potrebi s snimkom zaslona.

Većini grešaka je dulje trebati da ih se razumije nego da se isprave. Jasna prijava uklanja dio s razumijevanjem. To je još važnije s AI alatima: AI ne može postaviti dodatno pitanje o tome što ste mislili pod „naplata je čudna”, pa pogađa, a pogrešno pogađanje može pokvariti nešto drugo.

Predložak

Kopirajte ga i popunite:

Naslov: [Što nije u redu, gdje] — npr. „Obrazac za rezervaciju odbija termine nakon 18h”

Koraci za ponavljanje:
1. ...
2. ...
3. ...

Očekivano: [što bi trebalo da se dogodi]
Stvarno: [što se dogodilo umjesto toga]

Poruka o grešci: [točan tekst, ako postoji]
Gdje: [stranica/URL, preglednik, uređaj, prijavljeni korisnik]
Koliko često: [svaki put / ponekad / jednom]
Snimka zaslona ili snimka ekrana: [priložena]

Ostatak vodiča objašnjava svaki dio.

Korak 1: Prvo ga ponovite

Prije pisanja pokušajte ponovno izazvati grešku. Naučit ćete koji koraci su bitni i događa li se svaki put.

• Krenite iz čistog stanja: osvježite stranicu ili se odjavite i ponovno prijavite.
• Zabilježite svaki klik i svaki unos.
• Pokušajte pronaći najkraći put koji izaziva grešku.
• Probajte drugi preglednik ili račun. Ako se događa samo jednom korisniku, to je velik trag.

Za više o tome pogledajte kako ispraviti grešku u aplikaciji izrađenoj uz AI.

Korak 2: Napišite specifičan naslov

Naslov treba reći što nije u redu i gdje, da netko tko pregledava popis odmah zna o kojoj je greški riječ.

Korak 3: Navedite točne korake

Numerirajte ih. Budite doslovni: koja stranica, koji gumb, što ste upisali.

1. Prijavite se kao kupac (testni račun: customer@example.com).
2. Dodajte „Starter kit” u košaricu.
3. Unesite popust WELCOME10 i kliknite Primijeni.
4. Kliknite Blagajna.

„Pokušaj platiti s kodom” izostavlja detalje koji često odlučuju: koji korisnik, koji proizvod, koji kod i je li kod prvo primijenjen.

Korak 4: Očekivano naspram stvarnog

Ovo je srž prijave. Navedite oba, jer je razlika upravo greška.

• Očekivano: Stranica blagajne se otvara s prikazanim popustom od 10% u ukupnom iznosu.
• Stvarno: Gumb se pola sekunde vrti, a zatim se ništa ne događa. Bez koda za popust blagajna radi.

Bez „očekivanog” čitatelj možda ne zna da je ponašanje pogrešno. Bez „stvarnog” ne zna što treba tražiti.

Korak 5: Kopirajte poruke o grešci točno

Poruke o grešci najbrži su put do uzroka. Kopirajte ih kao tekst, riječ po riječ, bez parafraziranja.

Gdje ih naći:

• Na ekranu: svaka poruka koju aplikacija prikaže.
• Konzola preglednika: otvorite alate za programere (F12, ili desni klik → Inspect) i pogledajte karticu Console za crvene retke.
• Kartica Network: u alatima za programere pronađite neuspjeli zahtjev i zabilježite njegov URL i statusni kod (na primjer POST /api/checkout → 500).
• Zapisi poslužitelja, ako imate pristup.

Redak poput TypeError: Cannot read properties of undefined (reading 'percent') at checkout.ts:48 često odmah pokazuje na problem.

Korak 6: Dodajte kontekst

• Gdje: URL stranice, okruženje (pregled, testno ili uživo).
• Tko: koji korisnik ili uloga: administrator, član, odjavljen.
• Uređaj i preglednik: „Safari na iPhoneu” naspram „Chrome na Windowsu” može biti važno.
• Podaci: sve neobično u zapisu: vrlo dug tekst, posebni znakovi, velik broj stavki.
• Kad je počelo: „nakon jučerašnje promjene kodova za popust” je zlato.
• Koliko često: svaki put ili jednom od deset pokušaja.

Korak 7: Pokažite to

Snimka zaslona s označenim problemom ili kratka snimka ekrana uklanja nejasnoću, posebno kod grešaka u rasporedu. Ako vaš AI alat prihvaća slike, priložite jednu. Izrežite sve privatno, uključujući ključeve i tuđe podatke.

Pisanje prijava za AI alat za izradu

Ista struktura radi i kao upit. Dva dodatka pomažu:

• Recite što ne smije ostati promijenjeno, kako ispravak ne bi uveo novi problem.
• Zamolite ga da provjeri ispravak, a ne samo da ga napiše.

Prijavljen kao kupac, s „Starter kit” u košarici i primijenjenim kodom WELCOME10, klik na Blagajna ne radi ništa. Očekivano: stranica blagajne se otvara s 10% popusta na ukupan iznos. Stvarno: kratak krug učitavanja, pa ništa. Kartica Network pokazuje da je POST /api/checkout vratio 500. Blagajna bez koda radi. Pronađi uzrok i ispravi ga bez promjene načina računanja cijena za narudžbe bez koda. Zatim provjeri blagajnu s postotnim kodom, kodom s fiksnim iznosom i bez koda.

Ako niste sigurni u uzrok, prvo zatražite dijagnozu:

Još ne mijenjaj kod. Na temelju ove prijave, koji su mogući uzroci i što bi potvrdilo svaki od njih?

Česte greške

• „Pokvareno je.” Nema koraka, nema očekivanog rezultata, ništa za što se može djelovati.
• Više grešaka u jednoj prijavi. Neke se isprave, a druge se izgube.
• Parafrazirane poruke. „Neka undefined stvar” skriva koristan dio.
• Izostavljen korisnik ili uloga. Mnoge greške pogađaju samo administratore ili samo nove korisnike.
• Opisivanje samo željenog ispravka („dodaj provjeru null”) umjesto problema.
• Dijeljenje tajni u snimkama zaslona ili zalijepljenim zapisima.

Popis za provjeru

• Ponovio sam grešku i pronašao najkraće korake.
• Naslov kaže što nije u redu i gdje.
• Koraci su numerirani i doslovni.
• Navedeni su i očekivano i stvarno.
• Poruke o grešci su kopirane točno, s neuspjelim zahtjevom i statusnim kodom.
• Stranica, okruženje, korisnik, uređaj i preglednik su navedeni.
• Rečeno je koliko često se događa i kad je počelo.
• Priložena je snimka zaslona ili snimka ekrana, bez privatnih podataka.
• Jedna greška po prijavi.

Prijavljivanje grešaka Mythexovu agentu

U Mythex projektu prijava je upit. Nekoliko značajki pomaže:

• Priložite snimku zaslona pregleda ili poruke o grešci, do 5 datoteka po poruci.
• /fix usmjerava agenta na ispravljanje greške, a način Plan mu omogućuje istragu prije uređivanja.
• /test ima agenta da sam ponovi tokove u pregledu i prijavi što vidi.
• Vrati na ovu točku poništava ispravak koji je pogoršao stvari.

Stranica ispravljanje grešaka s upitima u dokumentaciji koristi istu strukturu: koraci, očekivano, stvarno. Za petlju ispravka i provjere oko toga pogledajte kako iterirati na aplikaciji izrađenoj uz AI.

Pitanja