Razhroščevanje s pomočjo umetne inteligence
Na tej strani
Hitrejše iskanje in odpravljanje napak
Razhroščevanje ostaja umetnost: razumi simptom, izsledi ga do vzroka in ga odpravi, ne da bi pokvaril kaj drugega. Codex pomaga pri vseh treh korakih, a neenakomerno. Pri prvem koraku ne doda skoraj nič, saj si tisti, ki opazuješ simptom in veš, kaj bi sistem moral početi. Pri drugem koraku odlično opravi svoje delo, saj je sledenje toku podatkov skozi deset datotek sistematično bralno delo – točno tisto, kar stroj opravi bolje kot utrujen človek. Pri tretjem koraku zagotovi takojšnjo preverbo s testi.
Razhroščevanje na podlagi napake
Najpreprostejši primer: napako posreduješ takšno, kot je, brez preoblikovanja ali povzemanja.
"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 nato poveže šest operacij: prebere testno datoteko, da razume scenarij, odpre order.service.ts na vrstici 42, izsledi tok podatkov, da ugotovi, kje je bil vnesen undefined, identificira osnovni vzrok – manjkajoč parameter, napaka pri tipizaciji ali kaj drugega –, predlaga in uporabi popravek, nato ponovno zažene test za preverbo. Tretja operacija je tista, ki bi te stala dvajset minut tihega branja.
Razhroščevanje nepričakovanega obnašanja
Pogosto sploh ni napake: program tiho dela nekaj narobe. To so najdražje napake in tiste, pri katerih je način oblikovanja tvoje zahteve najbolj pomemben.
"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."
To navodilo deluje, ker določa obseg: kaj deluje, kaj ne, in eno hipotezo, ki je že ovržena, saj so cene v bazi podatkov pravilne. Codex nato izsledi pot od HTTP zahteve do vnosa, izolira mesto, kjer izračun zaide s prave poti, in predlaga popravek. Brez stavka o tabeli products bi najverjetneje začel preverjati točno tisto, kar si pravkar preveril sam.
Analiza produkcijskih dnevnikov
Začnete lahko tudi s produkcijskimi sledmi, tako da preprosto prilepite ustrezen izsek.
"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 poveže tri vrstice – izčrpan bazen povezav, časovni potek poizvedbe, povrnjena transakcija –, sklepa, da gre za puščanje povezav do baze podatkov, nato pa v kodi išče mesta, kjer je povezava odprta, a ni pravilno zaprta. To je tipična napaka, ki je ne razkrije noben test, saj se pokaže le pod obremenitvijo in izgine, takoj ko jo poskušaš reproducirati lokalno.
Razhroščevanje z bisekcijo
Ko je problem razpršen in ne točno določen, namesto hitrega popravka zahtevaj metodično preiskavo.
"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."
Vrednost tega oblikovanja je v tem, da prisili diagnosticiranje napaka za napako. Brez navodila za identifikacijo izvora bi bila skušnjava za agenta – tako kot za razvijalca ob koncu dneva –, da dodaja any, dokler se prevajalnik ne umiri, s čimer se triindvajset vidnih napak spremeni v triindvajset prihodnjih napak.
Učinkoviti vzorci razhroščevanja
Gradivo, ki ga zagotoviš, določa vse ostalo. Vsaka vrsta simptoma zahteva vključitev specifičnih dokazov, njihovo izpuščanje pa je kot zahteva po diagnozi brez pregleda.
| Simptom | Navodilo za Codex |
|---|---|
| Neuspešen test | Navedi celotno sporočilo o napaki + testno datoteko |
| Napaka tipa | Navedi izpis ukaza tsc --noEmit |
| Napaka med izvajanjem | Navedi sled sklada + korake za reprodukcijo |
| Nepravilno obnašanje | Opiši pričakovani rezultat v nasprotju z opaženim |
| Težava z zmogljivostjo | Navedi metrike (odzivni čas, počasne poizvedbe) |
Preprečevanje prihodnjih napak
Odpravljena napaka je obravnavana le na pol, če nič ne prepreči njene ponovitve drugje. Zato popravku sistematično sledi naloga utrditve, oblikovana na podlagi tega, kar si pravkar spoznal.
"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."
Ta druga naloga posploši lekcijo, kjer je popravek ostal lokalni: varovala pokrivajo vse storitve, regresijski test pa zagotavlja, da ta specifičen primer ostane pod nadzorom, ko projekt zapustiš. To je poteza, ki loči ekipo, ki odpravlja napake, od ekipe, ki zmanjšuje svoj seznam nerešenih težav.
Ključne ugotovitve
- Codexu zagotovi maksimalen kontekst: sporočila o napakah, sledi sklada, dnevnike
- Codex izsledi tok podatkov, da najde osnovni vzrok
- Svoj popravek preveri z samodejnim ponovnim zagonom testov
- Po odpravi napake zahtevaj zaščito in regresijske teste
- Bolj natančna kot so tvoja navodila, hitrejše je razhroščevanje