Wyobraź sobie kuchnię z jednym kucharzem. Główne AI jest tym kucharzem, skill jest jego książką kucharską i mówi mu, jak ugotować całe danie. Problem w tym, że kucharz jest sam, więc obiera marchewkę, miesza zupę, żeby nic nie przywarło, i jednocześnie próbuje pilnować dania głównego. Przez to potrzebuje więcej czasu na całe danie, a przy okazji ma rozproszoną uwagę, bo musi ogarnąć wszystkie czynności naraz.

Subagent to pomocnik naszego kucharza: osobne AI, któremu główny kucharz zleca jedno konkretne zadanie. Pomocnik może pracować równolegle z kucharzem, a ponieważ do obierania marchewek nie trzeba być mistrzem kuchni, subagent może używać mniejszego modelu AI niż sam kucharz.

Wyjdźmy z naszej umownej kuchni i spójrzmy na prawdziwy przykład. W lekcji o pierwszym skillu zbudowaliśmy skill układający poranny plan dnia. Jedno główne AI musiało tam zrobić wszystko samo: sprawdzić pocztę i kalendarz, a na końcu ułożyć z tego plan. Robiło to po kolei, czynność po czynności, i wszystko na tym samym modelu, na którym działała cała rozmowa. Taki skill to świetny kandydat, żeby część pracy oddać subagentom: jednego wysłać do poczty, drugiego do kalendarza. Główne AI zostaje wtedy przy najważniejszej czynności, czyli układaniu planu dnia z danych, które dostanie od subagentów.

Skill to plik z instrukcjami, które AI wczytuje dopiero wtedy, gdy są potrzebne. Całe ćwiczenie robimy na skillu plan-dnia. Jeśli jeszcze go nie masz, zapoznaj się najpierw z lekcją o pierwszym skillu, a potem wróć tutaj.

Po co w ogóle dzielić skill na subagentów

Pocztę i kalendarz może przejrzeć Haiku, czyli szybki i tani model Claude. Każde źródło dostaje osobnego subagenta na Haiku. Pierwszy przegląda skrzynkę i wypisuje maile z ostatniej doby, każdy w jednej linijce. Drugi przegląda kalendarz i wypisuje dzisiejsze spotkania. Główne AI dalej pracuje na większym modelu, na przykład na Opusie albo Sonnecie: decyduje, co jest ważne, i układa z tych dwóch list plan dnia.

Subagent czyta maile albo kalendarz we własnym kontekście. Do rozmowy głównej oddaje tylko wynik: po jednej linijce na mail zamiast pełnej treści czterdziestu wiadomości. Dzięki temu cała poczta i cały kalendarz nie zapychają rozmowy głównej.

Proponujemy tu najprostszą ścieżkę: wydzielenie subagentów z działającego skilla. To nie jedyna droga. Możesz od razu zdefiniować samych subagentów, bez skilla, albo od początku zaprojektować skill razem z subagentami. Wydzielanie z gotowego skilla jest najłatwiejsze, bo widzisz już, jak działają poszczególne elementy skilla.

Zmierz skill, potem zapytaj, co z niego wyjąć

Skill plan-dnia już działa. Otwórz nową rozmowę, uruchom w niej skill i zaraz po tym, jak skończy, wpisz /context. Claude Code pokaże kolorową siatkę: co zajmuje kontekst i ile miejsca jest jeszcze wolne. Zrób zrzut ekranu – na końcu ćwiczenia porównasz go z wersją po zmianie.

Całą dalszą pracę nad subagentami i skillem prowadź w tej samej rozmowie. Zacznij od przeglądu skilla:

Przeczytaj mój skill plan-dnia. Wypisz fragmenty, które mógłby wykonać osobny subagent, i osobno te, które muszą zostać w skillu. Przy każdym fragmencie napisz, ile materiału trzeba przeczytać, żeby go wykonać, i ile z tego trafia do planu dnia.

Ostatnie zdanie promptu pokazuje, który fragment warto wydzielić: taki, który czyta dużo, a do planu oddaje mało. Przejrzenie czterdziestu maili po to, żeby streścić każdy w jednej linijce, jest takim fragmentem. Układanie planu z gotowych list nie jest, bo to najważniejsza praca i zostaje przy głównym AI.

Na liście „zostaw w skillu” powinien znaleźć się krok z plikiem profil.md. Z profilu główne AI wie, czym się zajmujesz, i według tego decyduje, które maile są ważne.

Model wpisz wprost, bo domyślnie subagent weźmie twój

Subagent to zwykły plik tekstowy z instrukcją, tak jak skill. Pliku nie piszesz ręcznie – poproś Claude Code, na początek o subagenta do poczty:

Załóż subagenta przeglad-skrzynki, dostępnego we wszystkich moich projektach, na podstawie kroku o poczcie ze skilla plan-dnia. Subagent ma wypisać wszystkie maile z ostatniej doby, po jednej linijce na wiadomość: nadawca, temat i krótko, o co w nim chodzi. Nie ma oceniać, które maile są ważne – tę decyzję podejmuje skill. Ustaw mu model haiku, bez numeru wersji. Nie ograniczaj mu narzędzi, bo musi mieć dostęp do konektora Gmaila. Skilla plan-dnia jeszcze nie zmieniaj.

Najważniejsze jest tu zdanie o modelu. Na naszych szkoleniach kursanci często je pomijają, bo zakładają, że Claude Code automatycznie przydzieli subagentowi mniejszy model. Na to nie licz: bez tego zdania subagent zwykle pracuje na tym samym modelu co rozmowa główna i oszczędność znika.

Otwórz raz plik subagenta i zobacz, co powstało. Na górze stoi nagłówek, podobny do tego w skillu:

---
name: przeglad-skrzynki
description: Wypisuje maile z ostatniej doby, po jednej linijce na wiadomość.
model: haiku
---

Pole description mówi Claude Code, kiedy zlecić temu subagentowi pracę. Linijka model: haiku to zdanie o modelu z twojego polecenia. Samo haiku, bez numeru wersji, z czasem przechodzi na nowsze modele Haiku. Model wpisany z numerem wersji zostaje na tej wersji, dopóki go nie zmienisz.

Jeśli w nagłówku widzisz też linijkę zaczynającą się od tools:, subagent dostanie tylko narzędzia w niej wypisane. Bez konektora Gmaila na tej liście nie otworzy skrzynki. Poproś wtedy Claude Code, żeby usunął tę linijkę.

Model dobieraj od dołu: zacznij od haiku. Gdy streszczenia maili regularnie mijają się z ich treścią, poproś Claude Code o zmianę na sonnet.

Dokumentacja subagentów

Zobacz, co subagent ma zrobić i co ma oddać

Pod nagłówkiem pliku subagenta jest jego instrukcja. Przeczytaj ją i sprawdź, czy mówi dwie rzeczy.

Po pierwsze: jak ma wyglądać lista, którą subagent odda. Lista powinna mieć jedną linijkę na każdy mail: nadawcę, temat i krótko, o co w mailu chodzi. To ważne, bo do rozmowy głównej wraca tylko ta lista. Gdy instrukcja jej nie opisuje, subagent może oddać jedno ogólne zdanie, na przykład „w skrzynce są trzy zapytania i kilka faktur”. Z takiego zdania główne AI nie ułoży planu.

Po drugie: że subagent nie wybiera ważnych maili. Subagent wypisuje wszystkie maile, a ważne wybiera główne AI. Tylko główne AI zna twój profil i widzi też kalendarz. Subagent widzi samą skrzynkę.

Jeśli czegoś w instrukcji brakuje, poproś Claude Code, żeby to dopisał.

Subagenta do kalendarza założysz podobnym poleceniem:

Załóż subagenta przeglad-kalendarza, dostępnego we wszystkich moich projektach, na podstawie kroku o kalendarzu ze skilla plan-dnia. Subagent ma wypisać dzisiejsze spotkania, po jednej linijce na spotkanie: godzina, tytuł i krótko, czego dotyczy opis wydarzenia. Nie ma oceniać, które spotkania są ważne – tę decyzję podejmuje skill. Ustaw mu model haiku, bez numeru wersji. Nie ograniczaj mu narzędzi, bo musi mieć dostęp do Kalendarza Google. Skilla plan-dnia jeszcze nie zmieniaj.

Zamień fragment skilla na zlecenie

Teraz kroki o poczcie i kalendarzu wychodzą ze skilla plan-dnia, a w ich miejsce wchodzą zlecenia dla subagentów. Zmianę zleć Claude Code:

W skillu plan-dnia zamień krok o przeglądaniu poczty na polecenie, żeby maile z ostatniej doby wypisał subagent przeglad-skrzynki. Dopisz, żeby skill poczekał na jego listę, zanim zacznie układać plan. Wybór maili, które czekają na moją odpowiedź, zostaw w skillu. Dopisz też, że gdy streszczenie od subagenta nie wystarczy do decyzji, skill ma przeczytać cały mail.

Krok o kalendarzu zamień podobnym poleceniem:

W skillu plan-dnia zamień krok o kalendarzu na polecenie, żeby dzisiejsze spotkania wypisał subagent przeglad-kalendarza. Dopisz, żeby skill poczekał na jego listę, zanim zacznie układać plan. Dopisz też, że gdy streszczenie od subagenta nie wystarczy do decyzji, skill ma przeczytać cały opis wydarzenia w Kalendarzu Google.

Pełny mail albo pełny opis wydarzenia główne AI czyta tylko wtedy, gdy krótka linijka od subagenta nie wystarczy. Pierwszy krok, z plikiem profil.md, zostaje w skillu bez zmian.

Uruchom skill od nowa i sprawdź, czy subagenci zadziałali

Gdy skill jest już zmieniony, otwórz nową rozmowę, uruchom w niej skill i zaraz po tym, jak skończy, wpisz /context. Porównaj tę siatkę ze zrzutem sprzed zmiany. Wolnego miejsca powinno zostać więcej.

Nowa rozmowa jest tu konieczna. W rozmowie, w której powstawali subagenci, siatka pokazałaby też całą tę pracę i porównanie ze zrzutem nic by nie powiedziało.

Jeśli obie siatki wyglądają tak samo, sprawdź, czy skill naprawdę oddał pracę subagentom. Zapytaj Claude Code w tej samej rozmowie: „Czy pocztę i kalendarz przejrzeli subagenci, czy zrobiłeś to sam?”. Gdy odpowie, że sam, poproś go, żeby poprawił zlecenia w skillu plan-dnia.

Jeśli plan dnia wyszedł słabszy niż przed zmianą, sprawdź, co oddał subagent. Po uruchomieniu skilla widzisz gotowy plan, a nie listę od subagenta, więc zapytaj o nią wprost:

Co dokładnie wróciło od subagenta przeglad-skrzynki? Wklej jego raport końcowy bez własnego streszczenia.

Jeśli raport jest pusty albo za ogólny, poproś Claude Code o poprawkę instrukcji w pliku subagenta, nie w skillu. To ta instrukcja mówi subagentowi, co ma oddać.

Spis komend Claude Code

Dlaczego skill czeka na wynik subagenta

W zwykłej rozmowie Claude Code uruchamia subagentów w tle: pracują obok, a główne AI dostaje wynik, gdy skończą. Dlatego w zleceniu w plan-dnia stoi „poczekaj na listy, zanim zaczniesz układać plan”. Bez tego zdania główne AI mogłoby zacząć układać plan, zanim wrócą listy od subagentów.

Gdy wynik subagenta nie jest potrzebny w dalszych krokach, na przykład przy zapisaniu gotowego planu do pliku, zdanie o czekaniu możesz pominąć. Skill pójdzie wtedy dalej, a subagent skończy pracę w tle.

Subagenci w tle

Z tej lekcji zapamiętaj

  • Mniejszy model trzeba subagentowi wpisać. Bez tego subagent zwykle pracuje na tym samym modelu co rozmowa główna i oszczędność znika.
  • Subagent czyta dużo i oddaje krótką listę, a decyduje główne AI. Przejrzenie czterdziestu maili i streszczenie każdego w jednej linijce to praca dla subagenta; wybór tego, co ważne, i ułożenie planu zostają w skillu.
  • Najprościej wydzielić subagentów z gotowego skilla. To nie jedyna droga: możesz też od razu założyć samych subagentów albo zaprojektować skill razem z nimi.
  • Do rozmowy głównej wraca sam raport końcowy. Dlatego to opis wyniku w pliku subagenta decyduje, czy skill będzie miał czego użyć.
  • /context pokazuje, czy zmiana coś dała. Dwa pomiary, każdy w osobnej, nowej rozmowie: przed zmianą i po niej.

Zadania

Odhacz, gdy zrobisz. Stan zapamięta się w przeglądarce, więc możesz wrócić do tej listy jutro.

  • Skill plan-dnia gotowy do ćwiczenia
  • Lista kandydatów do wydzielenia, z podziałem na „do subagenta” i „zostaw w skillu”
  • Subagenci do poczty i kalendarza założeni, z modelem haiku i z dostępem do konektorów
  • W plikach subagentów sprawdzony opis oddawanej listy i zdanie, że subagent nie ocenia, co jest ważne
  • Kroki o poczcie i kalendarzu wycięte ze skilla i zastąpione zleceniami
  • Zużycie kontekstu porównane przed zmianą i po niej
  • Wynik subagenta sprawdzony w rozmowie głównej
  • Sprawdzone, że skill czeka na listy od subagentów, zanim ułoży plan