Id-Debugging bl-Għajnuna tal-AI
F'din il-paġna
Sib u ssolvi l-bugs aktar malajr
Id-debugging jibqa’ arti: tifhem is-sintomu, ttraċċah lura għall-kawża primarja, u ssolvih mingħajr ma tkisser xi ħaġa oħra. Codex jgħin fit-tliet passi kollha, iżda b’mod irregolari. Fl-ewwel pass, ma jżid kważi xejn, peress li int dak li qed tosserva s-sintomu u tkun x’għandu jagħmel is-sistema. Fit-tieni, jeċċella, għax it-traċċar ta’ fluss ta’ dejta minn ġo għaxar fajls huwa xogħol sistematiku ta’ qari—eżattament dak li magna tagħmel aħjar minn bniedem għajjien. Fit-tielet, jipprovdi verifika immedjata permezz ta’ testijiet.
Iddibbuggja minn żball
L-aktar każ sempliċi: tgħaddi l-iżball kif inhu, mingħajr ma terġa’ tfasslu jew tagħmel sommarju tiegħu.
"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."
L-aġent imbagħad jikkatina sitt operazzjonijiet: jaqra l-fajl tat-test biex jifhem ix-xenarju, jiftaħ order.service.ts fil-linja 42, jitraċċa l-fluss tad-dejta biex isib fejn ġie introdott l-undefined, jidentifika l-kawża primarja—parametru nieqes, żball fit-tip, jew xi ħaġa oħra—, jipproponi u japplika s-soluzzjoni, imbagħad jerġa’ jħaddem it-test biex jivverifika. It-tielet operazzjoni hija dik li kienet se tiswielek għoxrin minuta ta’ qari silenzjuż.
Iddibbuggja mġiba mhux mistennija
Spiss ma jkun hemm l-ebda żball affattu: il-programma sempliċiment tagħmel xi ħaġa ħażina b’mod kwiet. Dawn huma l-bugs l-aktar għaljin, u dawk fejn il-mod kif tifformula t-talba tiegħek j importa l-aktar.
"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."
Din l-istruzzjoni taħdem għax tiddefinixxi l-ambitu: x’jaħdem, x’ma jaħdimx, u ipoteżi waħda diġà eskluża peress li l-prezzijiet fil-bażi tad-dejta huma korretti. Codex imbagħad jitraċċa l-fluss mit-talba HTTP sal-inserzjoni, j iżola fejn il-kalkolu joħroġ mill-binari, u jipproponi soluzzjoni. Mingħajr is-sentenza dwar it-tabella products, x’aktarx li kien jibda jiċċekkja eżattament dak li għaddejt iċċekkja int stess.
Analizza l-logs tal-produzzjoni
Tista’ wkoll tibda mit-traċċi tal-produzzjoni, sempliċiment billi tikkopja u twaħħal l-estratt rilevanti.
"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 jgħaqqad it-tliet linji—pool eżawrit, timeout tal-mistoqsija, transazzjoni mħassra—, jikkonkludi li hemm tnixxija ta’ konnessjoni mal-bażi tad-dejta, imbagħad ifittex fil-kodiċi postijiet fejn konnessjoni tinfetaħ iżda ma tingħalaqx sewwa. Dan huwa tipikament bug li l-ebda test ma jiżvela, peress li jidher biss taħt tagħbija u jisparixxi hekk kif tipprova tirriproduċih lokalment.
Id-Debugging permezz tal-bisezzjoni
Meta l-problema tkun diffusa minflok iffukata, itlob investigazzjoni metoduika minflok soluzzjoni mgħaġġla.
"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."
Il-valur ta’ din il-formulazzjoni huwa li tifforza dijanjosi żball wara żball. Mingħajr l-istruzzjoni biex tidentifika l-oriġini, it-tentazzjoni għal aġent—kif ukoll għal żviluppatur fi tmiem il-ġurnata—hija li żżid any sakemm il-kompilatur jissikket, li tbiddel tlieta u għoxrin żball viżibbli f’tlieta u għoxrin bug futur.
Mudelli effettivi ta’ debugging
Il-materjal li tipprovdi jikkundizzjona kollox ieħor. Kull tip ta’ sintomu jeħtieġ evidenza speċifika biex tiġi inkluża, u li tonqos hija bħal li titlob dijanjosi mingħajr eżami.
| Sintomu | Istruzzjoni ta’ Codex |
|---|---|
| Test li jfalli | Ipprovdi l-messaġġ sħiħ tal-iżball + il-fajl tat-test |
| Żball fit-tip | Ipprovdi l-output ta’ tsc --noEmit |
| Żball ta’ runtime | Ipprovdi t-traċċa tal-istack + il-passi biex tirriproduċiha |
| Mġiba mhux korretta | Iddeskrivi r-riżultat mistenni vs dak osservat |
| Problema ta’ prestazzjoni | Ipprovdi metriċi (ħin ta’ rispons, mistoqsijiet bil-mod) |
Evita l-bugs fil-futur
Bug issolvut huwa nofsu biss jekk xejn ma jipprevjeni li jerġa’ jidher f’post ieħor. Għalhekk, segwi sistematikament is-soluzzjoni b’kompitu ta’ konsolidazzjoni, ifformulat minn dak li għadek kemm tgħallimt.
"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."
Dan it-tieni kompitu jiġġeneralizza t-tagħlim fejn is-soluzzjoni baqgħet lokali: il-guards ikopru s-servizzi kollha, u t-test tar-regressjoni jiżgura li dan il-każ speċifiku jibqa’ mmonitorjat wara li titlaq mill-proġett. Din hija l-mossa li tiddistingwi tim li jsolvi l-bugs minn tim li jnaqqas il-lista ta’ xogħol tiegħu.
Punti Ewlenin
- Agħti lil Codex l-aktar kuntest possibbli: messaġġi ta’ żball, traċċi tal-istack, logs
- Codex jitraċċa l-fluss tad-dejta biex isib il-kawża primarja
- Jivverifika s-soluzzjoni tiegħu billi jerġa’ jħaddem it-testijiet awtomatikament
- Wara li ssolvi, itlob protezzjonijiet u testijiet tar-regressjoni
- Aktar ma jkunu preċiżi l-istruzzjonijiet tiegħek, aktar ikun mgħaġġel id-debugging