Кастомні агенти

Розробка ПЗ з Claude Code

Dani Zysman

AI Curriculum Manager @ DataCamp

Що таке агенти?

Команда спеціалізованих роботів-помічників із різними інструментами

Агенти — це спеціалізовані AI-помічники в Claude Code:

Кожен має свої можливості, працює автономно
Можуть бути вбудованими або створеними вами

Вбудовані агенти

Агент	Призначення	Коли використовувати
Explore	Дослідження коду (лише читання)	"Map this architecture"
Plan	Дослідження та стратегія	"How should we approach this?"
General	Виконання завдань з усіма інструментами	Типово для більшості робіт

Використайте /agents, щоб переглянути всі доступні агенти

Навіщо створювати кастомні агенти?

Кастомні агенти для спеціалізованих завдань

Переваги: багаторазові, послідовні, можна ділитися з командою
Типові сценарії:
- Code review — дотримання командних стандартів
- Security audit — перевірка вразливостей
- Documentation — генерація узгодженої документації
- Testing — пропозиції тестових випадків

Створення файлу агента

Розташування файлу:
- .claude/agents/code-reviewer.md
Обов'язкові розділи:
- name: Ідентифікатор агента
- description: Що його запускає
- Тіло: Інструкції у 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

Створення кастомного агента Code Reviewer

> /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.

Перегляньте та підтвердьте згенерований файл.

Проєкт наразі

music-analytics-api/
  app.py
  routes.py        # <- Ми перевірятимемо цей файл
  models.py
  analytics.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md  # <- Наш кастомний агент

Коли агенти породжуються

Без підагента (виконує напряму):

"Fix the bug in routes.py"
  -> Claude виконує

"Add validation here"
  -> Claude виконує

Створює підагента:

"Map the architecture"
  -> агент Explore

"How should we refactor?"
  -> агент Plan

Використання нашого кастомного агента

> @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?

Переваги агентів

Лупа з захисним щитом для безпечного дослідження

Окремий контекст
- Агенти працюють ізольовано
- Основна розмова лишається чистою
Безпечне дослідження
- Агент Explore працює лише для читання
- Ідеально для незнайомих кодових баз

Коли використовувати агентів

Тип запитання	Що відбувається
"What does this function do?"	Claude відповідає напряму
"How does auth work across this codebase?"	Агент Explore досліджує
"What's the best approach to refactor this?"	Агент Plan досліджує
"code review @routes.py"	Обробляє кастомний агент

Давайте потренуємось!

Розробка ПЗ з Claude Code