Otkrivanje i ispravljanje grešaka uz pomoć AI-a
Na ovoj stranici
Brže pronalaženje i ispravljanje grešaka
Ispravljanje grešaka (debugging) ostaje umjetnost: razumiješ simptom, pratiš ga do korijenskog uzroka i popraviš ga bez kvarenja nečeg drugog. Codex pomaže u sva tri koraka, ali nejednako. U prvom koraku gotovo da ništa ne dodaje jer ti promatraš simptom i znaš što bi sustav trebao raditi. U drugom koraku izvrsno se snalazi jer je praćenje toka podataka kroz deset datoteka sustavan posao čitanja – točno ono što stroj radi bolje od umornog čovjeka. U trećem koraku osigurava trenutnu provjeru putem testova.
Ispravljanje grešaka na temelju poruke o pogrešci
Najjednostavniji slučaj: proslijediš poruku o pogrešci kakva jest, bez preformuliranja ili sažimanja.
"The test src/api/routes/orders.test.ts fails with:
TypeError: Cannot read properties of undefined
(reading 'id')
at createOrder (src/services/order.service.ts:42)
Find the cause and fix the bug."
Agent zatim povezuje šest operacija: čita datoteku s testom kako bi razumio scenarij, otvara order.service.ts na retku 42, prati tok podataka kako bi otkrio gdje je uveden undefined, identificira korijenski uzrok – nedostajući parametar, pogreška u tipizaciji ili nešto drugo –, predlaže i primjenjuje ispravak, a zatim ponovno pokreće test radi provjere. Treća operacija je ona koja bi te koštala dvadeset minuta tihog čitanja.
Ispravljanje neočekivanog ponašanja
Često uopće nema poruke o pogrešci: program tiho radi nešto pogrešno. To su najskuplje greške i one kod kojih način na koji formuliraš svoj zahtjev najviše znači.
"The POST /api/orders route creates the order in the
database, but the total is always 0. Product prices are
correct in the products table. Find why the total
calculation fails."
Ova uputa funkcionira jer definira opseg: što radi, što ne radi i jednu hipotezu koja je već odbačena jer su cijene u bazi podataka ispravne. Codex zatim prati tok od HTTP zahtjeva do umetanja, izolira mjesto gdje proračun skreće s pravog puta i predlaže ispravak. Bez rečenice o tablici products, vjerojatno bi počeo provjeravati upravo ono što si već sam provjerio.
Analiza produkcijskih zapisa
Možeš krenuti i od produkcijskih tragova, jednostavnim lijepljenjem relevantnog isječka.
"Here's an excerpt from production logs. The application
intermittently returns 500 on /api/checkout:
[2026-04-01 14:23:01] ERROR: Connection pool exhausted
[2026-04-01 14:23:01] WARN: Query timeout after 30s
[2026-04-01 14:23:02] ERROR: Transaction rollback
Analyze the checkout route code and identify the connection
leak."
Codex povezuje tri retka – iscrpljen skup veza, istek vremena upita, poništena transakcija –, zaključuje da postoji curenje veze s bazom podataka, a zatim pretražuje kod u potrazi za mjestima gdje je veza otvorena, ali nije pravilno zatvorena. To je tipična greška koju nijedan test ne otkriva jer se pojavljuje samo pod opterećenjem i nestaje čim je pokušaš reproducirati lokalno.
Ispravljanje grešaka metodom polovičnog dijeljenja
Kada je problem raspršen umjesto točno određen, zatraži metodičnu istragu umjesto brzog popravka.
"The TypeScript build fails with 23 type errors since the
last dependency update. Analyze each error, identify whether
it's an API change in a dependency, and fix the code to be
compatible with the new versions."
Vrijednost ovakvog formuliranja je u tome što prisiljava dijagnosticiranje grešku po grešku. Bez upute da se identificira podrijetlo, napast za agenta – kao i za programera na kraju dana – jest dodavanje any dok se kompajler ne smiri, čime se dvadeset tri vidljive greške pretvaraju u dvadeset tri buduće greške.
Učinkoviti obrasci za ispravljanje grešaka
Materijal koji dostaviš uvjetuje sve ostalo. Svaka vrsta simptoma zahtijeva uključivanje specifičnih dokaza, a njihovo izostavljanje je kao traženje dijagnoze bez pregleda.
| Simptom | Uputa za Codex |
|---|---|
| Test koji ne prolazi | Navedi punu poruku o pogrešci + datoteku s testom |
| Pogreška tipa | Navedi izlaz naredbe tsc --noEmit |
| Pogreška u izvršavanju | Navedi praćenje stoga (stack trace) + korake za reprodukciju |
| Netočno ponašanje | Opiši očekivani nasuprot opaženom rezultatu |
| Problem s performansama | Navedi metrike (vrijeme odgovora, spori upiti) |
Sprječavanje budućih grešaka
Ispravljena greška je samo napola obrađena ako ništa ne sprječava njezino ponovno pojavljivanje negdje drugdje. Stoga sustavno prati ispravak zadatkom konsolidacije, formuliranim na temelju onoga što si upravo naučio.
"The bug came from an unchecked null userId. Add type
guards in all functions in src/services/ that receive a
userId. Also add a regression test for this case."
Ovaj drugi zadatak generalizira lekciju tamo gdje je ispravak ostao lokaliziran: zaštitne provjere pokrivaju sve servise, a regresijski test osigurava da ovaj specifični slučaj ostane pod nadzorom nakon što napustiš projekt. To je potez koji razlikuje tim koji ispravlja greške od tima koji smanjuje svoju zaostalu listu grešaka.
Ključne točke
- Daj Codexu maksimalan kontekst: poruke o pogreškama, praćenje stoga, zapise
- Codex prati tok podataka kako bi pronašao korijenski uzrok
- Svoj ispravak provjerava automatskim ponovnim pokretanjem testova
- Nakon ispravka zatraži zaštitne mjere i regresijske testove
- Što su tvoje upute preciznije, ispravljanje grešaka je brže