Kako napisati dobar izveštaj o grešci (za AI ili developera)

Dobar izveštaj o grešci omogućava nekome drugom, developeru ili AI-ju, da vidi isti problem koji ste videli, bez postavljanja pitanja. Potrebni su mu konkretan naslov, tačni koraci za reprodukciju, šta ste očekivali, šta se umesto toga desilo, svaka poruka o grešci prepisana reč po reč i gde se desilo: koja stranica, pregledač, uređaj i korisnik. Jedna greška po izveštaju, sa snimkom ekrana ako pomaže.

Većina grešaka traje duže da se razume nego da se ispravi. Jasan izveštaj uklanja deo sa razumevanjem. To važi još više kod AI alata: AI ne može da postavi dodatno pitanje o tome šta ste mislili pod "plaćanje je čudno", pa nagađa, a pogrešno nagađanje može da pokvari nešto drugo.

Šablon

Kopirajte ovo i popunite:

Naslov: [Šta nije u redu, gde] — npr. "Forma za rezervaciju odbija termine posle 18h"

Koraci za reprodukciju:
1. ...
2. ...
3. ...

Očekivano: [šta bi trebalo da se desi]
Stvarno: [šta se desilo umesto toga]

Poruka o grešci: [tačan tekst, ako postoji]
Gde: [stranica/URL, pregledač, uređaj, prijavljen kao koji korisnik]
Koliko često: [uvek / ponekad / jednom]
Snimak ekrana ili snimak: [priložen]

Ostatak vodiča objašnjava svaki deo.

Korak 1: Prvo reprodukujte grešku

Pre pisanja pokušajte da ponovo izazovete grešku. Saznaćete koji koraci su bitni i da li se dešava uvek.

• Počnite od čistog stanja: osvežite stranicu ili se odjavite i prijavite ponovo.
• Zabeležite svaki klik i sve što ukucate.
• Pokušajte da nađete najkraći put koji izaziva grešku.
• Probajte drugi pregledač ili nalog. Ako se dešava samo jednom korisniku, to je veliki trag.

Za više o ovome pogledajte kako ispraviti grešku u aplikaciji napravljenoj uz AI.

Korak 2: Napišite konkretan naslov

Naslov treba da kaže šta nije u redu i gde, da neko ko pregleda listu odmah zna o kojoj se grešci radi.

Korak 3: Navedite tačne korake

Numerišite ih. Budite doslovni: koja stranica, koje dugme, šta ste ukucali.

1. Prijavite se kao kupac (test nalog: customer@example.com).
2. Dodajte "Starter kit" u korpu.
3. Unesite kod za popust WELCOME10 i kliknite Apply.
4. Kliknite Checkout.

"Probajte plaćanje sa kodom" izostavlja detalje koji često odlučuju: koji korisnik, koji proizvod, koji kod, da li je kod prvo primenjen.

Korak 4: Očekivano naspram stvarnog

To je srž izveštaja. Navedite oba, jer je razlika upravo greška.

• Očekivano: stranica za plaćanje se otvara sa 10% popusta prikazanim u ukupnom iznosu.
• Stvarno: dugme se sekund prikazuje sa kružićem za učitavanje, a onda se ništa ne dešava. Bez koda za popust, plaćanje radi.

Bez "očekivanog", čitalac možda ne zna da je ponašanje pogrešno. Bez "stvarnog", ne zna šta da traži.

Korak 5: Prepišite greške tačno

Poruke o greškama su najbrži put do uzroka. Kopirajte ih kao tekst, reč po reč, ne parafrazirajte.

Gde ih naći:

• Na ekranu: svaka poruka koju aplikacija prikazuje.
• Konzola pregledača: otvorite alate za developere (F12, ili desni klik → Inspect) i pogledajte karticu Console za crvene linije.
• Kartica Network: u alatima za developere pronađite neuspešan zahtev i zabeležite njegov URL i statusni kod (na primer POST /api/checkout → 500).
• Logovi servera, ako imate pristup.

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

Korak 6: Dodajte kontekst

• Gde: URL stranice, okruženje (pregled, staging ili uživo).
• Ko: koji korisnik ili uloga: admin, član, odjavljen.
• Uređaj i pregledač: "Safari na iPhone-u" naspram "Chrome na Windows-u" može biti bitno.
• Podaci: sve neobično u zapisu: veoma dug tekst, specijalni znakovi, veliki broj stavki.
• Kad je počelo: "posle juče izmene kodova za popust" je zlata vredno.
• Koliko često: svaki put, ili jednom na deset pokušaja.

Korak 7: Pokažite to

Snimak ekrana sa zaokruženim problemom ili kratak snimak ekrana uklanja nejasnoću, naročito za greške u rasporedu. Ako vaš AI alat prihvata slike, priložite jednu. Isecite sve privatno, uključujući ključeve i tuđe podatke.

Pisanje izveštaja za AI alat za pravljenje

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

• Recite šta ne sme da se promeni, da ispravka ne izazove novi problem.
• Zamolite da proveri ispravku, a ne samo da je napiše.

Prijavljen kao kupac, sa "Starter kit" u korpi i primenjenim kodom WELCOME10, klik na Checkout ne radi ništa. Očekivano: stranica za plaćanje se otvara sa 10% popusta na ukupan iznos. Stvarno: kratak kružić za učitavanje, pa ništa. Kartica Network pokazuje da je POST /api/checkout vratio 500. Plaćanje bez koda radi. Pronađi uzrok i ispravi ga bez promene načina na koji se računaju cene za porudžbine bez koda. Zatim proveri plaćanje sa procentualnim kodom, kodom sa fiksnim iznosom i bez koda.

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

Još ne menjaj kod. Na osnovu ovog izveštaja, koji su verovatni uzroci i šta bi potvrdilo svaki od njih?

Česte greške

• "Pokvareno je." Nema koraka, nema očekivanog rezultata, nema šta da se uradi.
• Više grešaka u jednom izveštaju. Neke se isprave, a druge se izgube.
• Parafrazirane greške. "Neka undefined stvar" skriva koristan deo.
• Izostavljen korisnik ili uloga. Mnoge greške pogađaju samo admine ili samo nove korisnike.
• Opisivanje samo željene ispravke ("dodaj proveru null vrednosti") umesto problema.
• Deljenje tajni u snimcima ekrana ili nalepljenim logovima.

Kontrolna lista

• Reprodukovao sam grešku i našao najkraće korake.
• Naslov kaže šta nije u redu i gde.
• Koraci su numerisani i doslovni.
• Navedeni su i očekivano i stvarno.
• Poruke o greškama su tačno prepisane, sa neuspešnim zahtevom i statusnim kodom.
• Dodati su stranica, okruženje, korisnik, uređaj i pregledač.
• Navedeno je koliko često se dešava i kad je počelo.
• Snimak ekrana ili snimak je priložen, sa uklonjenim privatnim podacima.
• Jedna greška po izveštaju.

Prijavljivanje grešaka Mythex agentu

U Mythex projektu, izveštaj je prompt. Nekoliko funkcija pomaže:

• Priložite snimak ekrana pregleda ili ekrana sa greškom, do 5 fajlova po poruci.
• /fix usmerava agenta na ispravku greške; režim Plan mu omogućava da istraži pre menjanja.
• /test agent reprodukuje tokove u samom pregledu i prijavljuje šta vidi.
• Revert to this point poništava ispravku koja je pogoršala stvari.

Stranica debugging with prompts u dokumentaciji koristi istu strukturu koraci / očekivano / stvarno. Za petlju ispravke i provere oko toga pogledajte kako iterirati na aplikaciji napravljenoj uz AI.

Pitanja