5 Agent Skills do jakościowego programowania z AI - Claude Code LIVE DEMO
Pięć skilli, które układają pracę z agentem w proces: research, plan, przegląd planu, implementacja i code review. Do tego skill do dokumentacji i Skill Creator.
- Prowadzący
- Przemek Smyrdek, Marcin Czarkowski
Przemek Smyrdek i Marcin Czarkowski pokazali w Claude Code pięć skilli, z których sami korzystają: 10x-research, 10x-plan, 10x-plan-review, 10x-implement i 10x-impl-review-ci. Przykładem była poprawka w grze Space Explorers, napisanej w Phaserze, w której postacie wchodziły na siebie i źle poruszały się przy ścianach. Na koniec doszły dwa dodatki: skill do dokumentacji Matteo Colliny i Skill Creator od Anthropic.
Najważniejsze wnioski
10x-researchdzieli rozpoznanie problemu między subagentów pracujących równolegle. W demo główny agent rozbił zgłoszenie o kolizjach na cztery obszary: ruch gracza, ruch NPC, styk gracza z NPC i ograniczenia pozycji. Każdy subagent zużywa własne okno kontekstowe, więc research mieści się tam, gdzie jeden agent z limitem 200 tysięcy tokenów by się nie zmieścił. Wynik trafia do repozytorium jako dokument.10x-planzaczyna od pytań do programisty. Skill każe agentowi użyć narzędzia do zadawania pytań: w Claude Code to AskUserQuestion, w Codeksie request_user_input. Agent pyta o złożoność zadania i o konkretne decyzje, na przykład czy NPC ma się odbijać od ścian i czy oba problemy trafiają do jednego planu. Obok planu na kilkaset linii powstaje brief na jedną lub dwie strony, na którym łatwiej wychwycić błędne założenie.10x-plan-reviewzakłada, że plan zawiera błędy. Agent z czystym kontekstem ocenia plan w kilku wymiarach: definicja problemu i punkt końcowy, dopasowanie do architektury, ślepe punkty, kompletność, błędne założenia, spójność typów i warstw. Kiedy plan kolizji mimo przeglądu nie dał wyniku, Przemek poprosił agenta o post-mortem i dopisał do skilla ocenę tego, czy rozwiązanie pasuje do przestrzeni problemu.10x-implementprowadzi implementację fazami i pilnuje okna kontekstowego. Po każdej fazie agent podpowiada, jak sprawdzić zmianę, i pyta, czy iść dalej. Stan pracy zostaje w plikach w projekcie, więc do zadania da się wrócić następnego dnia. Skill sprawdza też zapełnienie kontekstu: według Marcina 150 tysięcy tokenów to już poziom wysoki, mimo że okno modelu ma milion. Przed implementacją można uruchomić osobny skill TDD, który na podstawie planu generuje testy z założenia nieprzechodzące.10x-impl-review-ciporównuje kod z planem i zostawia decyzje człowiekowi. W GitHub Actions uruchamia go etykieta na pull requeście. Trzech subagentów sprawdza odstępstwa od planu, bezpieczeństwo i zgodność ze wzorcami repozytorium oraz pokrycie testami. W demo review zablokowało PR: dwa błędy krytyczne, pięć ostrzeżeń i trzy obserwacje. Jeden z krytycznych dotyczył metody, której plan zabraniał używać. Lokalna wersja skilla przeprowadza przez każdą uwagę i z decyzji programisty składa nowy plan poprawek.- Krótki skill wystarcza, gdy opiera się na czymś, co model już zna. Skill do dokumentacji Matteo Colliny korzysta z frameworka Diátaxis i dzieli dokumentację na cztery typy: tutorial, how-to, referencję i wyjaśnienie. Najpierw pyta, który typ jest potrzebny. W demo powstało wyjaśnienie nowych zachowań NPC z diagramem stanów i tabelą stałych.
- Skill to opis procesu, a reguła to pojedyncza zasada. Reguła mówi agentowi, czego w projekcie unikać albo jakiej konwencji się trzymać. Skill opisuje zadanie od początku do końca. Do tworzenia i poprawiania własnych skilli prowadzący polecają Skill Creator od Anthropic, który w drugiej wersji porównuje starą i nową wersję skilla w benchmarku. Kategorie porównania trzeba dobrać samemu, bo te proponowane przez narzędzie zwykle faworyzują nową wersję.
Rozdziały
- 0:00:00 Wstęp: badanie METR, vibe coding i agentic engineering
- 0:12:11 Case study: kolizje postaci w grze Space Explorers
- 0:15:15 Czym są Agent Skills i jak układają się w proces
- 0:21:19 10x-research: subagenci i okno kontekstowe
- 0:28:22 10x-plan: pytania od agenta i brief planu
- 0:40:29 10x-plan-review: agent krytyk i post-mortem
- 0:47:32 Polski czy angielski w rozmowie z agentem
- 0:50:36 TDD i 10x-implement: fazy, checkpointy, czyszczenie kontekstu
- 1:10:54 Code review w CI: 10x-impl-review-ci
- 1:26:10 Dokumentacja: skill Matteo Colliny i Diátaxis
- 1:34:16 Skill Creator i podsumowanie procesu
- 1:40:21 Pytania: gotowe skille i pliki do komunikacji agentów
- 1:45:26 Pytania: subskrypcje, koszty i własne benchmarki
- 1:54:38 Pytania: skill a reguła, bezpieczeństwo, liczba subagentów
Materiały
- agentskills.io - specyfikacja Agent Skills
- Diátaxis - framework dokumentacji, na którym opiera się skill Matteo Colliny
- Space Explorers - gra, na której pokazano cały proces