раздел 08 · подстраница 1

Создаём субагента

Субагент - это отдельный Claude со своим системным промптом, своим набором инструментов и своим контекстом. Лежит в .claude/agents/<имя>.md и подгружается автоматически, когда главный Claude решает делегировать задачу.

Концепция

Файл субагента - это обычный Markdown с YAML-frontmatter в начале. Frontmatter описывает агента для Claude, тело файла - системный промпт, который будет передан агенту при запуске.

Минимальная схема:

---
name: код-ревьюер
description: Делает ревью текущего git diff. Запускать после правок перед коммитом.
tools: Read, Grep, Bash
model: sonnet
---

Ты - старший разработчик, делающий ревью кода...

Поля frontmatter:

  • name - уникальное имя агента, по нему можно явно вызывать через @имя.
  • description - когда вызывать. Главный сигнал для Claude. Чем конкретнее - тем лучше делегирование.
  • tools - какие инструменты доступны агенту (опционально, по умолчанию все).
  • model - какая модель: haiku, sonnet, opus. Опционально, по умолчанию текущая.

Где хранить

.claude/agents/code-reviewer.md    # проектный, коммитится в репо
~/.claude/agents/researcher.md     # глобальный, доступен везде

Проектные агенты приоритетнее глобальных, если имя совпадает.

Пример: code-reviewer

Создайте .claude/agents/code-reviewer.md со следующим содержимым:

---
name: code-reviewer
description: Ревью текущего git diff перед коммитом. Запускать ПОСЛЕ того, как разработчик внёс правки и сказал "проверь" или "ревью".
tools: Read, Grep, Bash
model: sonnet
---

Ты - senior-разработчик, делающий код-ревью. Твоя задача - найти проблемы, которые сломают прод или замедлят команду.

Алгоритм:

1. Выполни `git diff --stat` и `git diff` чтобы увидеть все изменения.
2. Прочитай каждый изменённый файл целиком - без контекста ревью бессмысленно.
3. Проверь по списку:
   - Логические ошибки и race conditions
   - Утечки секретов (API-ключи, пароли, токены)
   - Отсутствие обработки ошибок там, где может упасть
   - Нарушения существующих паттернов проекта
   - Дублирование кода, который уже есть в репо
4. Выдай отчёт в формате:
   - КРИТИЧНО - найдённые баги, нужно чинить до коммита
   - ВАЖНО - стилистика, паттерны, можно отложить
   - НИТПИК - мелочь, на усмотрение

Не пиши воду. Каждый пункт - конкретный файл и строка.

Создание через интерфейс

Если не хочется писать руками - попросите Claude:

> Создай мне субагента test-writer. Он должен писать тесты pytest
  для FastAPI-эндпоинтов. Запускать когда я говорю "напиши тесты".
  Доступ только к Read, Write, Bash.

Claude создаст файл сам и положит в .claude/agents/.

Антипаттерны

  • Размытое description вроде "помогает с кодом". Claude не поймёт, когда вызывать.
  • Слишком длинный системный промпт - агент тормозит и больше токенов жжёт.
  • Давать агенту Bash без ограничений, если он "ревьюер" - read-only задачи не требуют исполнения команд.
  • Класть в один агент несколько ролей. Лучше два узких агента, чем один универсальный.

Полезные ссылки