раздел 08

Субагенты - делегирование задач

Субагент - это специализированный Claude со своим контекстом, набором инструментов и инструкциями. Главный Claude (тимлид) делегирует ему задачу через инструмент Task. Субагент работает в изолированном окне контекста, возвращает короткий результат и закрывается. Главный контекст при этом не засоряется.

Зачем

Представьте, что вы попросили Claude найти, в каких 50 файлах кодовой базы используется устаревший API. Без субагента:

  • Claude последовательно открывает 50 файлов
  • Каждый файл целиком попадает в контекст
  • Через 20 файлов контекст переполнен, Claude теряет нить
  • После 30 файлов начинает галлюцинировать

С субагентом (типа Explore):

  • Главный Claude отправляет одну задачу: "найди все упоминания getCwd"
  • Субагент сам читает файлы, ищет, фильтрует
  • Возвращает короткий отчёт: "найдено 47 упоминаний в 12 файлах, вот список"
  • Главный контекст видит только этот отчёт - 200 токенов вместо 50 файлов

Анатомия субагента

Файл .claude/agents/code-reviewer.md (в проекте) или ~/.claude/agents/code-reviewer.md (глобально):

---
name: code-reviewer
description: |
  Делает review текущих изменений в репозитории.
  Вызывать когда: пользователь сказал "проверь", "сделай ревью",
  "найди баги в моих правках".
tools:
  - Read
  - Grep
  - Glob
  - Bash
---

Ты делаешь code review для текущих незакоммиченных изменений.

## Шаги

1. Запусти `git diff` чтобы увидеть изменения
2. Для каждого изменённого файла:
   - Прочитай файл целиком (для контекста)
   - Проверь:
     - Логические ошибки
     - Возможные null/undefined
     - Race conditions
     - Утечки памяти
     - Уязвимости (XSS, SQL injection, command injection)
3. Верни результат в формате:

Найдено проблем: N

High priority (M)

  • [file:line] описание проблемы

Medium priority (K)

  • [file:line] описание проблемы

Suggestions (L)

  • [file:line] совет по улучшению

Используй confidence-based filtering: репортуй только то, в чём
уверен на 70%+. Шум хуже, чем пропуск.

Встроенные субагенты Claude Code

Anthropic поставляет несколько готовых субагентов:

  • Explore - быстрый поиск кода по репозиторию (grep+read только нужных кусков)
  • Plan - архитектор: планирует реализацию задачи без написания кода
  • general-purpose - универсальный исследовательский агент

Плюс есть feature-dev pack:

  • feature-dev:code-architect - проектирование архитектуры новой фичи
  • feature-dev:code-explorer - глубокий анализ существующей фичи
  • feature-dev:code-reviewer - code review

Что в этом разделе

01
Создаём субагента
Markdown с frontmatter в .claude/agents/. Поля name, description, tools.
02
Как Claude решает делегировать
Триггеры по description, явный вызов через @agent, ручное направление.
03
Готовые субагенты
code-reviewer, researcher, test-writer, refactor-bot - забираем целиком.
04
Изоляция контекста и worktrees
Каждый агент - свой контекст. Файлы трогает в worktree, не ломая main.

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