Debugowanie wspomagane przez AI
Na tej stronie
Szybsze znajdowanie i naprawianie błędów
Debugowanie to wciąż sztuka: musisz zrozumieć objaw, dotrzeć do przyczyny źródłowej i naprawić błąd, nie psując przy tym czegoś innego. Codex pomaga we wszystkich trzech krokach, ale w różnym stopniu. W pierwszym kroku wnosi niewiele, ponieważ to Ty obserwujesz objaw i wiesz, jak system powinien działać. W drugim kroku sprawdza się znakomicie, ponieważ śledzenie przepływu danych przez dziesięć plików to systematyczna praca polegająca na czytaniu – dokładnie to, co maszyna robi lepiej niż zmęczony człowiek. W trzecim kroku zapewnia natychmiastową weryfikację dzięki testom.
Debugowanie na podstawie błędu
Najprostszy przypadek: przekazujesz błąd taki, jaki jest, bez przerabiania go czy streszczania.
"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 wykonuje następnie sześć operacji w łańcuchu: odczytuje plik testowy, aby zrozumieć scenariusz, otwiera order.service.ts w linii 42, śledzi przepływ danych, aby znaleźć miejsce, w którym wprowadzono wartość undefined, identyfikuje przyczynę źródłową (brakujący parametr, błąd typowania lub coś innego), proponuje i stosuje poprawkę, a następnie ponownie uruchamia test, aby ją zweryfikować. Trzecia operacja to ta, która kosztowałaby Cię dwadzieścia minut cichego czytania.
Debugowanie nieoczekiwanego zachowania
Często nie ma żadnego błędu: program po cichu robi coś źle. To najdroższe błędy i właśnie w ich przypadku sposób sformułowania prośby ma największe znaczenie.
"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."
Ta instrukcja działa, ponieważ definiuje zakres: co działa, co nie działa, oraz jedną hipotezę, którą już wykluczono, skoro ceny w bazie danych są poprawne. Codex śledzi następnie przepływ od żądania HTTP do insercji, izoluje miejsce, w którym obliczenia idą nie tak, i proponuje rozwiązanie. Bez zdania o tabeli products najprawdopodobniej zacząłby od sprawdzenia dokładnie tego, co sam już sprawdziłeś.
Analiza logów produkcyjnych
Możesz również zacząć od śladów produkcyjnych, po prostu wklejając odpowiedni fragment.
"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 łączy te trzy linie – wyczerpanie puli połączeń, przekroczenie limitu czasu zapytania, wycofanie transakcji – i wnioskuje, że mamy do czynienia z wyciekiem połączeń do bazy danych. Następnie przeszukuje kod w poszukiwaniu miejsc, w których połączenie jest otwierane, ale nie zamykane poprawnie. To typowy błąd, którego żaden test nie wykryje, ponieważ ujawnia się tylko pod obciążeniem i znika, gdy tylko spróbujesz go odtworzyć lokalnie.
Debugowanie metodą podziału na pół
Gdy problem jest rozproszony, a nie zlokalizowany, poproś o metodyczne dochodzenie zamiast szybkiej naprawy.
"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."
Wartość tego sformułowania polega na tym, że wymusza diagnozowanie błąd po błędzie. Bez instrukcji identyfikacji źródła pokusa dla agenta – tak jak dla programisty pod koniec dnia – polega na dodawaniu typu any, dopóki kompilator nie ucichnie. To zamienia dwadzieścia trzy widoczne błędy w dwadzieścia trzy przyszłe problemy.
Skuteczne wzorce debugowania
Materiał, który dostarczasz, warunkuje wszystko inne. Każdy rodzaj objawów wymaga dołączenia specyficznych dowodów, a ich pominięcie jest jak proszenie o diagnozę bez badania.
| Objaw | Instrukcja dla Codex |
|---|---|
| Nieudany test | Podaj pełny komunikat błędu + plik testowy |
| Błąd typów | Podaj wynik polecenia tsc --noEmit |
| Błąd wykonawczy | Podaj ślad stosu + kroki reprodukcji |
| Nieprawidłowe zachowanie | Opisz wynik oczekiwany kontra zaobserwowany |
| Problem z wydajnością | Podaj metryki (czas odpowiedzi, wolne zapytania) |
Zapobieganie przyszłym błędom
Naprawiony błąd jest tylko w połowie obsłużony, jeśli nic nie zapobiegnie jego ponownemu pojawieniu się gdzie indziej. Dlatego systematycznie uzupełniaj naprawę zadaniem konsolidującym, sformułowanym na podstawie tego, czego się właśnie dowiedziałeś.
"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."
To drugie zadanie uogólnia wniosek tam, gdzie naprawa pozostała lokalna: strażniki typów obejmują wszystkie usługi, a test regresji zapewnia, że ten konkretny przypadek pozostanie monitorowany, nawet gdy opuścisz projekt. To ruch, który odróżnia zespół naprawiający błędy od zespołu redukującego ich zaległości.
Kluczowe wnioski
- Dostarczaj Codexowi maksymalny kontekst: komunikaty błędów, ślady stosu, logi
- Codex śledzi przepływ danych, aby znaleźć przyczynę źródłową
- Weryfikuje swoją poprawkę, automatycznie ponownie uruchamiając testy
- Po naprawie poproś o zabezpieczenia i testy regresji
- Im precyzyjniejsze są Twoje instrukcje, tym szybsze jest debugowanie