Vianetsintä tekoälyn avustamana
Tällä sivulla
Löydä ja korjaa bugit nopeammin
Vianetsintä on edelleen taidelaji: ymmärrä oire, jäljitä se juurisyyhyn ja korjaa se rikkomatta muita toimintoja. Codex auttaa kaikissa kolmessa vaiheessa, mutta epätasaisesti. Ensimmäisessä vaiheessa se ei lisää juuri mitään, sillä sinä havainnoit oireen ja tiedät, miten järjestön pitäisi toimia. Toisessa vaiheessa se loistaa, koska datavirran seuraaminen kymmenen tiedoston läpi on systemaattista lukutyötä – juuri sitä, mitä kone tekee paremmin kuin väsynyt ihminen. Kolmannessa vaiheessa se tarjoaa välittömän varmistuksen testien avulla.
Vianetsintä virheilmoituksen perusteella
Yksinkertaisin tapaus: syötä virheilmoitus sellaisenaan, ilman uudelleenmuotoilua tai tiivistämistä.
"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."
Agentti suorittaa sitten kuusi operaatiota ketjussa: se lukee testitiedoston ymmärtääkseen skenaarion, avaa tiedoston order.service.ts rivillä 42, jäljittää datavirran löytääkseen kohdan, jossa undefined otettiin käyttöön, tunnistaa juurisyyt – puuttuva parametri, kirjoitusvirhe tyyppimäärityksessä tai jotain muuta –, ehdottaa ja toteuttaa korjauksen sekä ajaa testin uudelleen varmistaakseen onnistumisen. Kolmas operaatio on se, joka olisi maksanut sinulta kaksikymmentä minuuttia hiljaista lukemista.
Odottamattoman käyttäytymisen vianetsintä
Usein virhettä ei ole lainkaan: ohjelma tekee jotain väärin hiljaa. Nämä ovat kalleimpia bugeja, ja juuri niissä pyyntösi muotoilu on tärkeintä.
"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."
Tämä ohje toimii, koska se määrittelee laajuuden: mikä toimii, mikä ei, ja yhden hypoteesin, joka on jo suljettu pois, sillä tietokannan hinnat ovat oikein. Codex jäljittää sitten virran HTTP-pyynnöstä lisäykseen, eristää kohdan, jossa laskenta menee pieleen, ja ehdottaa korjausta. Ilman lausetta products-taulusta se todennäköisesti alkaisi tarkistaa juuri sen, mitä olet itse jo tarkistanut.
Tuotantologien analysointi
Voit aloittaa myös tuotantotiedoista liittämällä asiaankuuluvan otteen.
"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 yhdistää nämä kolme riviä – yhteyspooli tyhjentynyt, kyselyn aikakatkaisu, transaktio peruutettu –, päättelee kyseessä olevan tietokantayhteyden vuodon ja etsii koodista kohdat, joissa yhteys avataan mutta ei suljeta kunnolla. Tämä on tyypillisesti bugi, jota mikään testi ei paljasta, sillä se ilmenee vain kuormituksen alla ja katoaa heti, kun yrität toistaa sitä paikallisesti.
Vianetsintä jakamalla puoliksi
Kun ongelma on hajallaan eikä tarkasti paikannettu, pyydä methodista tutkimusta nopean korjauksen sijaan.
"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."
Tämän muotoilun arvo on siinä, että se pakottaa diagnosoimaan virheen kerrallaan. Ilman ohjetta tunnistaa alkuperä, agentin – kuten päivän päätteeksi väsyneen kehittäjänkin – kiusauksena on lisätä any kunnes kääntäjä vaikenee, mikä muuttaa kaksikymmentäkolme näkyvää virhettä kaksikymmeneksi kolmeksi tulevaksi bugiksi.
Tehokkaat vianetsintämallit
Toimittamasi materiaali ehdollistaa kaiken muun. Jokainen oiretyyppi vaatii mukaan tiettyjä todisteita, ja niiden pois jättäminen on kuin pyytäisi diagnoosia ilman tutkimusta.
| Oire | Codex-ohje |
|---|---|
| Epäonnistunut testi | Anna koko virheilmoitus + testitiedosto |
| Tyyppivirhe | Anna tsc --noEmit-komennon tuloste |
| Ajoaikavirhe | Anna pinonjälki (stack trace) + vaiheet virheen toistamiseen |
| Virheellinen käyttäytyminen | Kuvaile odotettu vs. havaittu tulos |
| Suorituskykyongelma | Anna mittarit (vastineaika, hitaat kyselyt) |
Estä tulevat bugit
Korjattu bugi on vain puoliksi hoidettu, jos mikään ei estä sen uudelleenilmestymistä muualla. Seuraa siksi korjausta systemaattisesti konsolidointitehtävällä, joka on muotoiltu juuri oppimasi perusteella.
"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."
Tämä toinen tehtävä yleistää opetuksen tilanteesta, jossa korjaus jäi paikalliseksi: tarkistukset kattavat kaikki palvelut, ja regressiotesti varmistaa, että tämä tietty tapaus pysyy valvonnassa myös projektista poistumisesi jälkeen. Tämä on se liike, joka erottaa tiimin, joka korjaa bugeja, tiimistä, joka pienentää niiden jälkiselvittelyruuhkaa.
Keskeiset asiat
- Anna Codexille maksimaalinen konteksti: virheilmoitukset, pinonjäljet, logit
- Codex jäljittää datavirran löytääkseen juurisyyt
- Se varmistaa korjauksensa ajamalla testit uudelleen automaattisesti
- Korjauksen jälkeen pyydä suojauksia ja regressiotestejä
- Mitä tarkempia ohjeesi ovat, sitä nopeampaa vianetsintä on