Blog JSystems - uwalniamy wiedzę!

Szukaj

Claude Code

Claude Code: workflow wieloetapowy - jak zorganizować

W skrócie

  • Masz w Claude Code duże, wieloetapowe zadanie (audyt, migracja, seria powiązanych zmian) i nie wiesz, jak je poukładać, żeby agent nie gubił kolejności ani kontekstu.
  • Wrzucenie wszystkiego w jedno polecenie sprawia, że model gubi kroki, a kontekst zapełnia się szczegółami z etapów pośrednich.
  • Rozwiązanie: dobierz właściwy mechanizm do skali zadania - lista zadań i tryb planowania dla pojedynczej sesji, subagenci do delegacji, a workflow dynamiczny do dziesiątek równoległych kroków.

Claude Code, oficjalne narzędzie CLI od Anthropic do programowania z AI, radzi sobie ze złożonymi zadaniami, ale sposób ich organizacji mocno wpływa na wynik. Jeśli poprosisz o "przerób cały moduł, dodaj testy, zaktualizuj dokumentację i popraw importy" jednym zdaniem, model łatwo pominie któryś etap albo zużyje kontekst na drobiazgi. Klucz to świadomy podział pracy i dobranie narzędzia do rozmiaru zadania. Poniżej pokazujemy, jak zorganizować workflow wieloetapowy tak, żeby był powtarzalny i przewidywalny.

Jak to wygląda w praktyce

Zlecasz agentowi kilka rzeczy naraz. Efekt: robi pierwszą i trzecią, o drugiej zapomina; albo wykonuje wszystko po kolei, ale w połowie kontekst jest już tak zapchany logami i fragmentami plików, że jakość spada, a odpowiedzi robią się chaotyczne. Przy naprawdę dużych zadaniach (migracja setek plików) jedna rozmowa po prostu nie mieści całej roboty i agent zaczyna się gubić. Widać to po tym, że musisz go raz po raz naprowadzać "wróć do kroku drugiego" albo "nie skończyłeś aktualizacji dokumentacji".

Dlaczego Claude Code tak działa

Model pracuje w ramach okna kontekstu o skończonym rozmiarze - im więcej szczegółów z kroków pośrednich w nim ląduje, tym mniej miejsca zostaje na właściwe rozumowanie. Dlatego Claude Code daje kilka mechanizmów, które różnią się tym, kto trzyma plan. Przy zwykłej rozmowie plan trzyma model, decydując krok po kroku. Subagenci wynoszą część pracy do osobnych okien, dzięki czemu szczegóły nie zaśmiecają głównej rozmowy. Workflow dynamiczny idzie dalej: to skrypt, który Claude pisze, a osobne środowisko wykonuje, orchestrując wiele agentów naraz - wyniki pośrednie żyją w zmiennych skryptu, a do rozmowy wraca tylko finalny efekt. Wybór złego mechanizmu do skali zadania jest najczęstszą przyczyną chaosu.

Jak to rozwiązać krok po kroku

  1. Rozbij zadanie na etapy w samym poleceniu, najlepiej numerowaną listą. Jasny podział sprawia, że agent zaczyna prowadzić własną listę zadań i odhacza je po kolei.
  2. Dla nietrywialnej zmiany wejdź w tryb planowania (przełącz tryby uprawnień klawiszem Shift+Tab, aż zobaczysz "plan mode on"). Agent przeanalizuje kod i przedstawi plan, zanim cokolwiek zmieni - masz szansę poprawić kolejność przed startem.
  3. Etapy, które da się wykonać w izolacji (przegląd, research, przeszukanie repozytorium), deleguj do subagentów. Odciążasz główną rozmowę, a każdy subagent oddaje zwięzły wynik.
  4. Przy zadaniach masowych (ten sam krok dla wielu plików, migracja, audyt całego repozytorium) poproś o workflow: wystarczy napisać "użyj workflow, żeby...". Claude napisze skrypt orchestrujący wielu agentów i uruchomi go w tle, a sesja pozostanie responsywna. Postęp obserwujesz komendą /workflows.
  5. Gdy dany etap wymaga Twojej akceptacji przed kolejnym, potraktuj każdy etap jako osobne uruchomienie - workflow nie zatrzymuje się w połowie na pytanie do Ciebie, więc naturalne punkty kontrolne rozdziel na oddzielne kroki.
  6. Jeśli układ etapów sprawdza się i będziesz go powtarzać (np. przegląd na każdej gałęzi), zapisz go: w widoku /workflows wybierz uruchomienie i naciśnij s. Powstanie własna komenda /nazwa, którą odpalisz następnym razem jednym poleceniem.

Jak sprawdzić, że zadziałało

Dobrze zorganizowany workflow poznasz po tym, że agent sam prowadzi widoczną listę zadań i kończy wszystkie etapy bez Twojego naprowadzania. Podczas pracy zerknij na listę zadań (skrót Ctrl+T pokazuje ją w statusie) - powinny być odhaczone kolejno. Dla workflow dynamicznego otwórz /workflows i sprawdź, czy każda faza ma status ukończonej i czy finalny raport faktycznie pokrywa wszystkie pliki albo elementy, które miały być objęte. Na końcu przejrzyj zmiany komendą /diff, żeby potwierdzić, że żaden etap nie został po cichu pominięty.

Wróć do listy: 100 najczęstszych problemów z Claude Code

Szkolenie Claude Code - od zera do zespołu agentów AI, prowadzi Łukasz Matuszewski (JSystems)

Szkolenie Claude Code - od zera do zespołu agentów AI -->

Szkolenie Claude Code - od zera do zespołu agentów AI

Tryb planowania, tryby uprawnień, komendy, MCP, hooki i systemy multi-agent - wszystko na żywym kodzie podczas trzydniowego szkolenia. Prowadzi Łukasz Matuszewski. Szkolenie ma terminy gwarantowane - odbędzie się niezależnie od liczby zgłoszeń.

Sprawdź szkolenie Claude Code

To szkolenie może być dofinansowane dla Ciebie z KFS lub BUR.

★★★★★Średnia ocena naszych szkoleń w Google: 5/5

Najczęściej zadawane pytania

Jak najlepiej zorganizować wieloetapowe zadanie w Claude Code?
Rozbij zadanie na etapy w samym poleceniu, najlepiej numerowaną listą, a przy nietrywialnej zmianie wejdź w tryb planowania klawiszem Shift+Tab. Do etapów, które da się wykonać w izolacji, użyj subagentów, a do zadań masowych na dziesiątkach plików poproś o workflow dynamiczny.
Czym różni się subagent od workflow dynamicznego w Claude Code?
Różnica polega na tym, kto trzyma plan. Przy subagentach plan trzyma model, decydując krok po kroku, a wyniki lądują w oknie kontekstu. Workflow dynamiczny to skrypt, który Claude pisze i który osobne środowisko wykonuje, orchestrując wielu agentów naraz - wyniki pośrednie żyją w zmiennych skryptu, a do rozmowy wraca tylko finalny efekt.
Jak uruchomić workflow dynamiczny w Claude Code?
Wystarczy w poleceniu napisać na przykład użyj workflow, żeby przeprowadzić audyt wszystkich plików w danym katalogu. Claude napisze skrypt orchestrujący agentów i uruchomi go w tle, a sesja pozostanie responsywna. Postęp obserwujesz komendą /workflows.
Czy mogę zapisać układ etapów, żeby powtarzać go w przyszłości?
Tak. W widoku /workflows wybierz uruchomienie i naciśnij klawisz s - powstanie własna komenda w formie /nazwa, którą odpalisz następnym razem jednym poleceniem. Skrypt zapisze się w katalogu .claude/workflows/ w projekcie albo w katalogu domowym.

Komentarze (0)

Musisz być zalogowany by móc dodać komentarz. Zaloguj się przez Google

Brak komentarzy...