▸ // spis treści
W poprzedniej lekcji sprawdzaliśmy, czy agent nie zmyśla. Teraz gorszy scenariusz: agent nie tyle się myli, co uparcie robi coś innego, niż prosisz. Trzeci raz to samo polecenie i trzeci raz nie ten efekt. To nie jest awaria narzędzia - to pięć powtarzalnych przyczyn, a każda ma swój ruch naprawczy. Wracaj do tej lekcji zawsze, gdy zaczniesz się złościć na ekran.
Krok 1: Za mało kontekstu
Po czym poznasz. Agent odpowiada ogólnie, wymyśla nazwy plików, których nie ma, albo pyta o rzeczy zapisane w twoim projekcie. Zgaduje, bo nic mu nie dałeś.
Ruch naprawczy. Podaj pliki przez @, zamiast liczyć na to, że agent sam ich poszuka. Zamiast „popraw ofertę" napisz @oferta.md @cennik.md Popraw pakiet w tej ofercie na Premium. Jeśli zadanie jest większe, zacznij od fazy pytań z lekcji 7 - niech agent najpierw dopyta, potem robi.
Krok 2: Zapchany czat
Po czym poznasz. Rozmowa ciągnie się od dwóch godzin. Agent miesza wątki, wraca do ustaleń sprzed godziny, przywraca poprawki, które już odrzuciłeś.
Ruch naprawczy. Nowy czat. Ale uwaga - najważniejszych ustaleń nie przenoś do nowego promptu, tylko do pliku. Poproś: „zapisz nasze ustalenia do notatki-projekt.md", zamknij czat, a w nowym podaj ten plik przez @. Prompt zniknie razem z rozmową, plik zostanie na dysku.
Pro-tip. Nowy czat zakładaj profilaktycznie przy każdej zmianie tematu, a nie dopiero wtedy, gdy zrobi się źle. Jeden czat to jedno zadanie. Przy okazji oszczędzasz limity, bo agent nie przetwarza za każdym razem godziny nieistotnej historii.
Krok 3: Sprzeczne reguły
Po czym poznasz. Agent stosuje zasadę, o którą go nie prosisz, albo ignoruje tę, którą właśnie podałeś w czacie. Zwykle znaczy to, że AGENTS.md mówi jedno, prompt drugie, a skill trzecie.
Ruch naprawczy. Otwórz AGENTS.md i przeczytaj go na głos, punkt po punkcie. Ta metoda wygląda głupio i działa bezbłędnie - sprzeczności słychać od razu. „Pisz zwięźle" obok „rozwijaj każdy punkt w akapit" to gotowa awaria. Wywal to, co się gryzie, i wróć do lekcji 3, jeśli chcesz odświeżyć zasady jego budowy.
Krok 4: Przeładowany skill
Po czym poznasz. Skill działa, ale tylko w pierwszej części. Agent wykonuje trzy początkowe kroki instrukcji i gubi resztę.
Ruch naprawczy. Sprawdź długość SKILL.md. Jeśli masz 300 linii w jednym pliku, agent czyta początek i rozmywa końcówkę. Skróć instrukcję do samych decyzji, a szczegóły i przykłady wynieś do osobnych plików obok. Pełną strukturę pokażę w lekcji 19.
Krok 5: Zły model do zadania
Po czym poznasz. Agent poprawnie wykonuje to, co mu podyktujesz, ale kompletnie nie radzi sobie, gdy trzeba coś wymyślić, zaplanować albo napisać instrukcję dla innego agenta.
Ruch naprawczy. Przełącz model na mocniejszy. Flash wykonuje, Pro wymyśla - różnicę i koszty rozbierałem w lekcji 5. Zanim po raz czwarty przepiszesz prompt, zmień model i puść to samo polecenie jeszcze raz.
Gdy agent uparcie wraca do starej wersji pliku
To osobny przypadek, bo wygląda jak halucynacja, a nią nie jest. Agent po prostu widzi inny plik niż ty. Dwie przyczyny, obie banalne: nie zaakceptowałeś poprzednich zmian, więc na dysku wciąż leży stara treść, albo podałeś mu plik z innego folderu o podobnej nazwie.
Sprawdź, czy nie wisi gdzieś niezatwierdzona propozycja z przyciskiem Accept, i poproś wprost: „przeczytaj jeszcze raz aktualną zawartość oferta.md i wypisz mi pierwsze trzy linie". Jeśli linie się nie zgadzają z tym, co widzisz na ekranie - masz odpowiedź.
Ważne. Jeśli objawy nie pasują do żadnego z pięciu punktów, agent przestaje odpowiadać albo błąd wraca w każdym projekcie, problem jest po stronie narzędzia, a nie po twojej. Diagnostykę takich sytuacji rozbieram w lekcji 28 - Gdy coś przestanie działać.
Zasada trzech prób
Najdroższy błąd w pracy z agentem to poprawianie tego samego promptu dziesiąty raz. Ustal sobie twardy limit: trzy podejścia.
Jeśli po trzeciej próbie nadal jest źle, przestań szlifować słowa i zmień podejście. Rozbij zadanie na mniejsze kawałki i zleć je po kolei. Albo zrób pierwszy krok ręcznie i daj agentowi gotowy wzorzec: „zrób pozostałe cztery dokładnie tak jak ten". Wzorzec działa lepiej niż najlepszy opis, bo nie zostawia miejsca na interpretację.
Podsumowanie
Masz pięć diagnoz i pięć ruchów naprawczych zamiast zgadywania, plus limit trzech prób, który chroni cię przed spalaniem godziny na jeden prompt. Dziewięć na dziesięć „awarii" agenta mieści się w tej liście.
W lekcji 12 - Własny skill od zera przechodzimy do automatyzacji: zbudujesz własnego skilla, który generuje ofertę dla klienta na podstawie twojego cennika.