Niestandardowe agenty

Tworzenie oprogramowania z Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Czym są agenty?

Zespół wyspecjalizowanych robotów-asystentów z różnymi narzędziami

Agenty to wyspecjalizowani asystenci AI w Claude Code:

każdy ma swoje możliwości i działa niezależnie
mogą być wbudowane lub tworzone na zamówienie

Wbudowane agenty

Agent	Cel	Kiedy używać
Explore	Analiza kodu w trybie tylko do odczytu	„Zmapuj tę architekturę"
Plan	Analiza i tworzenie strategii	„Jak powinniśmy to zrobić?"
General	Wykonywanie zadań z pełnym dostępem do narzędzi	Domyślny dla większości zadań

Użyj /agents, aby wyświetlić listę dostępnych agentów

Po co tworzyć niestandardowe agenty?

Niestandardowe agenty do konkretnych zadań

Zalety: wielokrotne użycie, spójność, możliwość dzielenia się z zespołem
Typowe zastosowania:
- Przegląd kodu – egzekwowanie standardów zespołu
- Audyt bezpieczeństwa – wykrywanie luk
- Dokumentacja – generowanie spójnej dokumentacji
- Testowanie – sugerowanie przypadków testowych

Tworzenie pliku agenta

Lokalizacja pliku:
- .claude/agents/code-reviewer.md
Wymagane sekcje:
- name: identyfikator agenta
- description: co go uruchamia
- Treść: instrukcje w markdown

___
# code-reviewer.md
name: code-reviewer
description: Reviews code for 
best practices
___
Check for:
1. Clear naming conventions
2. Proper error handling
3. Performance concerns

Tworzenie niestandardowego agenta do przeglądu kodu

> /agents

> [Select] Create new agent

> [Select] Project level (.claude/agents)

> [Select] Generate with Claude (recommended)

>  Create a code reviewer agent that reviews code for naming, error handling, 
and performance.

Przejrzyj i zatwierdź wygenerowany plik.

Stan projektu

music-analytics-api/
  app.py
  routes.py        # <- We'll review this file
  models.py
  analytics.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md  # <- Our custom agent

Kiedy uruchamiane są subagenty

Bez subagenta (działanie bezpośrednie):

"Fix the bug in routes.py"
  -> Claude handles it

"Add validation here"
  -> Claude handles it

Uruchamia subagenta:

"Map the architecture"
  -> Explore agent

"How should we refactor?"
  -> Plan agent

Korzystanie z naszego niestandardowego agenta

> @code-reviewer review @routes.py

Review Complete

Quick Fixes:
- Remove unused `session` import (line 3)
- Replace hardcoded `* 5` popularity metric with a named constant

Structural Issues:
- Album dictionaries built twice in get_album_stats() and
  get_average_tracks() extract to a shared helper
- get_artist_albums() returns empty list if artist doesn't exist;
  validate artist first
- No range validation on artist_id parameter

Would you like me to fix any of these?

Zalety agentów

Lupa z tarczą ochronną symbolizująca bezpieczne eksplorowanie

Oddzielny kontekst
- agenty działają w izolacji
- główna rozmowa pozostaje przejrzysta
Bezpieczne eksplorowanie
- agent Explore działa tylko w trybie odczytu
- idealny do nieznanego kodu

Kiedy korzystać z agentów

Typ pytania	Co się dzieje
„Co robi ta funkcja?"	Claude odpowiada bezpośrednio
„Jak działa autoryzacja w tym kodzie?"	agent Explore analizuje kod
„Jakie jest najlepsze podejście do refaktoryzacji?"	agent Plan prowadzi analizę
„przegląd kodu @routes.py"	obsługiwane przez niestandardowego agenta

Czas na praktykę!

Tworzenie oprogramowania z Claude Code