Ladění s pomocí AI
Na této stránce
Hledej a opravuj chyby rychleji
Ladění zůstává uměním: pochopit příznak, vysledovat ho až ke kořenové příčině a opravit ho, aniž by se něco jiného rozbilo. Codex pomáhá se všemi třemi kroky, ale nerovnoměrně. V prvním kroku nepřidává téměř nic, protože právě ty pozoruješ příznak a víš, co by systém měl dělat. Ve druhém kroku vyniká, protože sledování toku dat deseti soubory je systematická práce čtení – přesně to, co stroj zvládá lépe než unavený člověk. Ve třetím kroku poskytuje okamžité ověření prostřednictvím testů.
Ladění na základě chyby
Nejpřímější případ: předáš chybu tak, jak je, bez přepisování nebo shrnování.
"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 poté řetězí šest operací: přečte si testovací soubor, aby pochopil scénář, otevře order.service.ts na řádku 42, vysleduje tok dat a zjistí, kde se objevilo undefined, identifikuje kořenovou příčinu – chybějící parametr, chyba v typech nebo něco jiného –, navrhne a aplikuje opravu a následně znovu spustí test pro ověření. Třetí operace je ta, která by tě stála dvacet minut tichého čtení.
Ladění neočekávaného chování
Často nedojde k žádné chybě: program tiše dělá něco špatně. To jsou nejdražší chyby a právě u nich nejvíce záleží na tom, jak svou žádost formuluješ.
"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."
Tento pokyn funguje, protože definuje rozsah: co funguje, co nefunguje, a jednu hypotézu, která je již vyvrácena, protože ceny v databázi jsou správné. Codex poté vysleduje tok od HTTP požadavku až po vložení, izoluje místo, kde se výpočet pokazí, a navrhne opravu. Bez věty o tabulce products by s největší pravděpodobností začal kontrolovat přesně to, co jsi právě zkontroloval ty sám.
Analýza produkčních logů
Můžeš také začít od produkčních stop jednoduše vložením příslušného úryvku.
"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 propojí tyto tři řádky – vyčerpaný pool připojení, časový limit dotazu, vrácení transakce zpět –, dospěje k závěru, že dochází k úniku databázových připojení, a následně vyhledá v kódu místa, kde je připojení otevřeno, ale není řádně uzavřeno. Typicky jde o chybu, kterou neodhalí žádný test, protože se projeví pouze pod zátěží a zmizí, jakmile se ji pokusíš reprodukovat lokálně.
Ladění půlením intervalu
Když je problém rozptýlený spíše než přesně určený, požádej o metodické vyšetřování místo rychlé opravy.
"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."
Hodnota tohoto formulování spočívá v tom, že vynucuje diagnostiku chybu po chybě. Bez pokynu identifikovat původ je pokušení pro agenta – stejně jako pro vývojáře na konci dne – přidávat any, dokud kompilátor nezmlkne, čímž se dvacet tři viditelných chyb změní ve dvacet tři budoucích chyb.
Efektivní vzorce ladění
Materiál, který poskytneš, podmiňuje vše ostatní. Každý typ příznaku vyžaduje zahrnutí specifických důkazů a jejich vynechání je jako žádost o diagnózu bez vyšetření.
| Příznak | Pokyn pro Codex |
|---|---|
| Selhávající test | Uveď celou chybovou zprávu + testovací soubor |
| Chyba typů | Uveď výstup příkazu tsc --noEmit |
| Chyba běhu | Uveď trasování zásobníku + kroky k reprodukci |
| Nesprávné chování | Popiš očekávaný versus pozorovaný výsledek |
| Problém s výkonem | Uveď metriky (doba odezvy, pomalé dotazy) |
Předcházej budoucím chybám
Opravená chyba je zpracována jen z poloviny, pokud nic nebrání jejímu opětovnému výskytu jinde. Proto systematicky doplň opravu konsolidačním úkolem formulovaným na základě toho, co jsi se právě naučil.
"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."
Tento druhý úkol zobecňuje lekci tam, kde oprava zůstala lokální: guardy pokrývají všechny služby a regresní test zajišťuje, že tento konkrétní případ zůstane pod kontrolou i poté, co projekt opustíš. To je tah, který odlišuje tým, který chyby pouze opravuje, od týmu, který snižuje svůj backlog chyb.
Klíčové poznatky
- Poskytni Codexu maximální kontext: chybové zprávy, trasování zásobníku, logy
- Codex vysleduje tok dat a najde kořenovou příčinu
- Svou opravu ověří automatickým znovuspuštěním testů
- Po opravě požádej o ochranná opatření a regresní testy
- Čím přesnější jsou tvé pokyny, tím rychlejší je ladění