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

Dobra prijava greške omogućava nekome drugom — programeru ili AI-ju — da vidi isti problem koji ste vidjeli, bez da vas išta pita. Treba joj konkretan naslov, tačni koraci za ponavljanje, šta ste očekivali, šta se stvarno desilo, svaka poruka o grešci prepisana doslovno, i gdje se desilo: koja stranica, browser, uređaj i korisnik. Jedna greška po prijavi, sa snimkom ekrana ako pomaže.

Većina grešaka traje duže da se razumije nego da se popravi. Jasna prijava uklanja dio razumijevanja. Ovo je još važnije s AI alatima: AI ne može postaviti dodatno pitanje o tome šta mislite pod „plaćanje je čudno“, pa nagađa — a pogrešno nagađanje može pokvariti nešto drugo.

Šablon

Kopirajte ovo i popunite:

Naslov: [Šta nije u redu, gdje] — npr. „Forma za rezervaciju odbija termine nakon 18h“

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

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

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

Ostatak vodiča objašnjava svaki dio.

Korak 1: Prvo ponovite grešku

Prije pisanja, pokušajte da greška ponovo nastane. Naučićete koji koraci su važni i da li se dešava svaki put.

• Počnite iz čistog stanja: osvježite stranicu ili se odjavite i prijavite.
• Zabilježite svaki klik i svaku stvar koju ukucate.
• Pokušajte da nađete najkraći put koji izaziva grešku.
• Probajte drugi browser ili nalog. Ako se dešava samo jednom korisniku, to je velik trag.

Za više o ovome pogledajte kako otkloniti greške u aplikaciji izrađenoj uz AI.

Korak 2: Napišite konkretan naslov

Naslov treba da kaže šta nije u redu i gdje, da neko ko pregleda listu prepozna o kojoj se greški radi.

Korak 3: Navedite tačne korake

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

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

„Probajte checkout s kodom“ izostavlja detalje koji često odlučuju: koji korisnik, koji proizvod, koji kod, da li je prvo primijenjen.

Korak 4: Očekivano naspram stvarnog

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

• Očekivano: stranica za checkout se otvara s 10% popusta prikazanim u ukupnom iznosu.
• Stvarno: dugme prikaže spinner na sekundu, pa ništa. Bez koda za popust checkout radi.

Bez „očekivano“, čitalac možda ne zna da je ponašanje pogrešno. Bez „stvarno“, ne zna šta da traži.

Korak 5: Kopirajte greške tačno

Poruke o greškama su najbrži put do uzroka. Kopirajte ih kao tekst, doslovno, bez parafraziranja.

Gdje ih naći:

• Na ekranu: svaka poruka koju aplikacija prikaže.
• Konzola browsera: otvorite alate za programere (F12, ili desni klik → Inspect) i pogledajte karticu Console za crvene linije.
• Network kartica: u alatima za programere nađite neuspješan zahtjev i zabilježite njegov URL i statusni kod (npr. POST /api/checkout → 500).
• Logovi servera, ako imate pristup.

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

Korak 6: Dodajte kontekst

• Gdje: URL stranice, okruženje (pregled, staging ili uživo).
• Ko: koji korisnik ili uloga — admin, član, odjavljen.
• Uređaj i browser: „Safari na iPhoneu“ naspram „Chrome na Windowsu“ može biti važno.
• Podaci: sve neobično u zapisu — vrlo dug tekst, posebni znakovi, veliki broj stavki.
• Kada je počelo: „poslije jučerašnje izmjene kodova za popust“ je zlato.
• Koliko često: svaki put, ili jednom u deset pokušaja.

Korak 7: Pokažite to

Snimak ekrana s zaokruženim problemom ili kratki video uklanjaju nejasnoće — posebno za greške u rasporedu. Ako vaš AI alat prihvata 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 kao prompt. Dvije dopune pomažu:

• Recite šta ne smije da se promijeni, da ispravka ne napravi novi problem.
• Zamolite da provjeri ispravku, a ne samo da je napiše.

Prijavljen kao kupac, s „Starter kit“ u korpi i primijenjenim kodom WELCOME10, klik na Checkout ne radi ništa. Očekivano: stranica za checkout se otvara s 10% popusta na ukupno. Stvarno: kratak spinner, pa ništa. Kartica Network pokazuje da je POST /api/checkout vratio 500. Checkout bez koda radi. Pronađi uzrok i ispravi ga bez mijenjanja načina na koji se računaju cijene za narudžbe bez koda. Zatim provjeri checkout s procentualnim kodom, kodom s fiksnim iznosom i bez koda.

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

Još ne mijenjaj kod. Na osnovu ove prijave, koji su vjerovatni uzroci i šta bi potvrdilo svaki od njih?

Česte greške

• „Pokvareno je.“ Nema koraka, nema očekivanog rezultata, ništa za djelovanje.
• Više grešaka u jednoj prijavi. Neke se isprave, druge se izgube.
• Parafrazirane greške. „Neka undefined stvar“ krije koristan dio.
• Nedostaje korisnik ili uloga. Mnoge greške utiču samo na admine ili samo na nove korisnike.
• Opisivanje samo rješenja koje želite („dodaj provjeru null“) umjesto problema.
• Dijeljenje tajni u snimcima ekrana ili nalijepljenim logovima.

Kontrolna lista

• Ponovio sam grešku i našao najkraće korake.
• Naslov kaže šta nije u redu i gdje.
• Koraci su numerisani i doslovni.
• Navedeni su i očekivano i stvarno.
• Poruke o greškama su tačno kopirane, sa svakim neuspješnim zahtjevom i statusnim kodom.
• Uključeni su stranica, okruženje, korisnik, uređaj i browser.
• Rekao sam koliko često se dešava i kada je počelo.
• Snimak ekrana ili snimak je priložen, s uklonjenim privatnim podacima.
• Jedna greška po prijavi.

Prijavljivanje grešaka Mythex agentu

U Mythex projektu, prijava je prompt. Nekoliko funkcija pomaže:

• Priložite snimak ekrana pregleda ili ekrana s greškom — do 5 fajlova po poruci.
• /fix usmjerava agenta da popravi grešku, a režim Plan mu dozvoljava da istraži prije izmjene.
• /test daje agentu da sam ponovi tokove u samom pregledu i prijavi šta vidi.
• Vrati na ovu tačku poništava ispravku koja je stvari pogoršala.

Stranica dokumentacije otklanjanje grešaka uz upite koristi istu strukturu: koraci / očekivano / stvarno. Za petlju ispravka-i-provjera oko toga pogledajte kako iterirati aplikaciju izrađenu uz AI.

Pitanja