Umiejętności agenta (Agent Skills & Custom Workflows)

1. Przegląd koncepcji i problem systemowy

Wraz ze wzrostem złożoności systemów agentowych, programiści często próbują wyposażyć agenta w ekspercką wiedzę we wszystkich dziedzinach jednocześnie: piszą gigantyczne reguły formatowania kodu, listy kontrolne bezpieczeństwa serwerów, wymagania dotyczące dostępności UI, składnię dialektów SQL oraz szablony dokumentacji.

Próba upchnięcia tego wszystkiego do jednego statycznego system prompt generuje trzy krytyczne problemy systemowe:

1. Katastrofalne wyczerpanie budżetu tokenów: Nawet dla banalnego zapytania typu „popraw literówkę” model jest zmuszony za każdym razem wczytywać 40 000 tokenów nieistotnej dokumentacji.
2. Rozmycie kontekstu i degradacja przestrzegania instrukcji (Instruction Drift): Im więcej sprzecznych lub heterogenicznych reguł znajduje się w kontekście, tym wyższe prawdopodobieństwo, że model zignoruje specyficzne wskazówki.
3. Brak możliwości modułowej aktualizacji: Zmiana jednej reguły w monolitycznym pliku może nieprzewidywalnie zmienić zachowanie agenta w zupełnie innych zadaniach.

Agent Skills rozwiązują ten problem poprzez zasadę proceduralnego rozdzielenia kontekstu: wiedza przechowywana jest jako izolowane moduły na dysku i ładowana do pamięci operacyjnej agenta tylko wtedy, gdy występuje odpowiednia potrzeba inżynierska.

2. Taksonomia architektoniczna i model mentalny

Współczesna architektura Agent Skill jest ustandaryzowana jako autonomiczny pakiet wiedzy proceduralnej:

• 1. Manifest i wyzwalacze aktywacji (Frontmatter Metadata): Metadane w formacie YAML na początku pliku SKILL.md. Określają nazwę, opis kompetencji oraz listę naturalnych językowo wyzwalaczy (np.: „kupiłem VPS”, „skonfiguruj firewall”, „check accessibility”).
• 2. Algorytmiczny przewodnik działań (Workflow Blueprint): Jasny, krok po kroku algorytm działań, podzielony na fazy: diagnostyka -> przygotowanie planu -> wykonanie krok po kroku -> obowiązkowa finalna weryfikacja wyniku.
• 3. Wykonywalne skrypty i narzędzia pomocnicze (scripts/): Deterministyczne skrypty Python, Bash lub Node.js, które agent wywołuje do wykonywania rutynowych obliczeń lub sprawdzeń, zamiast powolnej i podatnej na błędy generacji od zera.
• 4. Referencje i wzorcowe przykłady (references/): Złote standardy architektury, schematy konfiguracji (Nginx, Docker Compose, interfejsy TypeScript), których agent używa jako szablonu do odwzorowania.

3. Techniczny pipeline i mechanika wewnętrzna

Cykl życia aktywacji skillu przez agenta przebiega w 4 etapach:

1. Lightweight Index Discovery (Odkrywanie katalogu): Przy inicjalizacji agent otrzymuje jedynie kompaktowy indeks dostępnych skillów (2-3 zdania opisu na każdy). To zużywa mniej niż 500 tokenów.
2. Intent Matching & Trigger Interception (Dopasowanie intencji): Użytkownik stawia zadanie. Agent porównuje semantykę zapytania z manifestami skillów. Jeśli wykryto zgodność, agent podejmuje wewnętrzną decyzję o załadowaniu ekspertyzy.
3. Lazy File Ingestion (Leniwe czytanie instrukcji): Agent wywołuje narzędzie plikowe (np. view_file dla skills/<skill_name>/SKILL.md) i ładuje pełną specyfikację bezpośrednio do kontekstu roboczego.
4. Execution & Context Retirement (Wykonanie i zwolnienie kontekstu): Agent wykonuje zadanie, ściśle przestrzegając instrukcji skillu. Po zakończeniu zadania i utrwaleniu wyniku, kolejne sesje nie są przeciążone przestarzałymi szczegółami.

4. Praktyczne scenariusze inżynierskie w środowisku produkcyjnym

01. Proceduralne hardening i ochrona Linux VPS

Agent posiada skill vps-hardening. Gdy użytkownik informuje o zakupie nowego serwera, agent ładuje precyzyjną, 7-etapową listę kontrolną: generowanie kluczy SSH, konfiguracja UFW, ustawienia fail2ban, tuning sysctl oraz wyłączenie dostępu hasłem wyłącznie po weryfikacji logowania kluczem.

02. Specjalistyczny audyt designu pod kątem dostępności (WCAG 2.2)

Użytkownik prosi o ocenę markupu formularza. Agent aktywuje skill better-accessibility: sprawdza kontrast kolorów zgodnie z APCA/WCAG, obecność etykiet aria, nawigację klawiaturową (focus-visible) oraz dostępność dla czytników ekranu (screen readers).

03. Zautomatyzowana migracja bazy danych na Drizzle ORM

Skill zawiera precyzyjne zasady generowania schematów: konwencje nazewnictwa snake_case, poprawne definiowanie indeksów, zakaz surowych enum oraz tworzenie bezpiecznych plików migracji bez blokowania tabel.

5. Pułapki, typowe błędy i bezpieczeństwo

• Konflikt wyzwalaczy (Trigger Overlap): Jeśli dwa różne skille mają zbyt szerokie lub podobne opisy (np. code-review i security-audit), agent może załadować oba, rozdmuchując kontekst, albo wahać się przy wyborze. Spraw, aby opisy wyzwalaczy były wzajemnie wykluczające się i kontrastowe.
• Przestarzałe skrypty narzędziowe (Stale Tooling): Zmiany API zewnętrznych bibliotek mogą uszkodzić pomocnicze skrypty wewnątrz scripts/. Konieczne jest okresowe uruchamianie testów w celu walidacji sprawności kodu skillów.
• Brak walidacji bezpieczeństwa (Prompt Injection via Untrusted Skills): Ładowanie zewnętrznych skillów z niezaufanych repozytoriów może zawierać ukryte instrukcje służące do kradzieży prywatnych kluczy. Ufaj wyłącznie zweryfikowanym modułom wiedzy.