Derinimas padedant DI
Šiame puslapyje
Rask ir taisyk klaidas greičiau
Derinimas išlieka menas: suprasti simptomą, atsekti jį iki pirminės priežasties ir ištaisyti nieko nesugadinant. Codex padeda visuose trijuose žingsniuose, tačiau nevienodai. Pirmajame žingsnyje jis beveik nieko neprideda, nes būtent tu stebi simptomą ir žinai, kaip sistema turėtų veikti. Antrajame jis puikiai susitvarko, nes duomenų srauto atsekimas per dešimt failų yra sistemingas skaitymo darbas – būtent tai mašina atlieka geriau nei pavargęs žmogus. Trečiajame jis suteikia momentinį patikrinimą per testus.
Derinimas pagal klaidos pranešimą
Pats paprasčiausias atvejis: perduodi klaidos pranešimą tokį, koks jis yra, neperformuluodamas ir neapibendrindamas.
"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."
Tada agentas atlieka šešias operacijas iš eilės: perskaito testo failą, kad suprastų scenarijų, atidaro order.service.ts 42 eilutėje, atseka duomenų srautą, kad rastų, kur buvo įvesta undefined, nustato pirminę priežastį – trūkstamą parametrą, tipavimo klaidą ar ką nors kita –, pasiūlo ir pritaiko taisymą, tada iš naujo paleidžia testą patikrinimui. Trečioji operacija yra ta, kuri tau būtų kainavusi dvidešimt minučių tylaus skaitymo.
Netikėto elgesio derinimas
Dažnai klaidos pranešimo nėra visiškai: programa tyliai daro kažką negerai. Tai brangiausios klaidos ir tos, kuriose tavo užklausos formuluotė yra svarbiausia.
"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."
Ši instrukcija veikia, nes apibrėžia aprėptį: kas veikia, kas neveikia, ir vieną hipotezę, kuri jau atmesta, nes kainos duomenų bazėje yra teisingos. Tada Codex atseka srautą nuo HTTP užklausos iki įterpimo, izoliuoja vietą, kur skaičiavimas nukrypsta nuo kelio, ir pasiūlo taisymą. Be sakinio apie products lentelę, jis greičiausiai pradėtų tikrinti būtent tai, ką ką tik patikrinai pats.
Gamybos žurnalų analizė
Gali pradėti ir nuo gamybos pėdsakų, tiesiog įklijuodamas atitinkamą ištrauką.
"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 sujungia tris eilutes – ryšių baseinas išseko, užklausos laiko limitas viršytas, sandoris anuliuotas –, daro išvadą, kad yra duomenų bazės ryšio nutekėjimas, tada ieško kode vietų, kur ryšys atidaromas, bet tinkamai neuždaromas. Tai paprastai klaida, kurios nerodo joks testas, nes ji pasireiškia tik esant apkrovai ir išnyksta, kai tik bandai ją atkurti lokaliai.
Derinimas dalijant per pusę
Kai problema yra išsibarsčiusi, o ne lokalizuota, prašyk metodinio tyrimo, o ne greito taisymo.
"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."
Šios formuluotės vertė ta, kad ji verčia diagnozuoti klaidą po klaidos. Be instrukcijos nustatyti kilmę, agentui – kaip ir kūrėjui dienos pabaigoje – kiltų pagunda pridėti any, kol kompiliatorius nutils, taip paversdamas dvidešimt tris matomas klaidas dvidešimt trimis būsimomis klaidomis.
Efektyvūs derinimo šablonai
Tavo pateikiama medžiaga lemia viską kitą. Kiekvienam simptomų tipui reikia įtraukti specifinių įrodymų, o jų praleidimas yra lygus diagnozės prašymui be apžiūros.
| Simptomas | Codex instrukcija |
|---|---|
| Nepavykęs testas | Pateik pilną klaidos pranešimą + testo failą |
| Tipo klaida | Pateik tsc --noEmit išvestį |
| Vykdymo klaida | Pateik dėklų pėdsaką + atkūrimo veiksmus |
| Neteisingas elgesys | Aprašyk tikėtiną ir stebimą rezultatą |
| Našumo problema | Pateik metrikas (atsako laikas, lėtos užklausos) |
Ateities klaidų prevencija
Ištaisyta klaida yra tik pusiau sutvarkyta, jei niekas neleidžia jai vėl atsirasti kitur. Todėl sistemingai po taisymo atlik konsolidavimo užduotį, suformuluotą pagal tai, ką ką tik sužinojai.
"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."
Ši antroji užduotis apibendrina pamoką, kai taisymas liko lokalus: apsaugos apima visas tarnybas, o regresijos testas užtikrina, kad šis konkretus atvejis bus stebimas ir tau palikus projektą. Tai yra ėjimas, kuris skiria komandą, taisančią klaidas, nuo komandos, mažinančios jų sąrašą.
Svarbiausi punktai
- Pateik Codex maksimalų kontekstą: klaidų pranešimus, dėklų pėdsakus, žurnalus
- Codex atseka duomenų srautą, kad rastų pirminę priežastį
- Jis patikrina savo taisymą automatiškai iš naujo paleisdamas testus
- Po taisymo prašyk apsaugos priemonių ir regresijos testų
- Kuo tikslesnės tavo instrukcijos, tuo greitesnis derinimas