Специалисты (subagents)

Subagent (в каталоге его называют специалистом или агентом) - помощник с одной задачей. Он запускается в собственном контексте со своими инструкциями, инструментами и правами, а в основной разговор возвращает только итог. Источник: Subagents, сверено 23.10.2026.

Зачем отдельный контекст

• Шумная работа (поиск по коду, чтение логов, длинные файлы) не засоряет основную беседу.
• Можно ограничить инструменты, дать узкую инструкцию и выбрать модель по характеру задачи, в том числе подешевле.
• Один и тот же помощник переиспользуется в разных проектах.

Запросы субагента идут в тот же лимит использования, что и основной разговор.

Где лежит файл

Агент - markdown-файл с настройками в начале. Если имена совпали, побеждает более приоритетное место: управляемые настройки, флаг --agents, .claude/agents/ проекта, ~/.claude/agents/, и в конце каталог agents/ плагина. Идентичность задаёт поле name, а не имя файла.

Поля в начале файла

Обязательны name и description. Остальные:

Поле	Зачем
tools, disallowedTools	Разрешённые и запрещённые инструменты
model	sonnet, opus, haiku, полный идентификатор модели или inherit
skills	Skills, которые загружаются в контекст агента сразу
maxTurns, effort, isolation	Предел ходов, глубина рассуждения, изолированная копия репозитория

Имена полей чувствительны к регистру: неизвестное поле молча игнорируется, ошибки не будет. Агенты из плагинов не используют поля hooks, mcpServers и permissionMode: так сделано из соображений безопасности.

Как вызывается

Claude передаёт задачу агенту сам, ориентируясь на description. Можно назвать агента в запросе, упомянуть его через @ (тогда он точно запустится) или открыть всю сессию как агента: claude --agent имя. Есть встроенные: Explore (поиск и чтение), Plan (исследование в режиме плана) и general-purpose.

Как это выглядит в AI KIT

Начало файла mr-reviewer из плагина dex-mr-reviewer (описание сокращено):

---
name: mr-reviewer
description: Первичное ревью чужого MR/PR, языко-агностично. ... Триггеры - review MR, ревью PR, ...
tools: Read, Grep, Glob, Bash, WebSearch, WebFetch, Skill, Agent, ToolSearch, mcp__github
model: opus
skills:
  - dex-skill-node-contract:node-contract
---

Здесь заданы узкий набор инструментов, модель по характеру работы (ревью требует суждения, поэтому opus) и skill контракта, который загружается заранее. Тело описывает работу фазами. Как каталог устроил специалистов: Специалисты.

Ограничения и ошибки

• Субагент может запускать субагентов, но глубина ограничена. По документации - до трёх слоёв ниже основного разговора, дальше инструмент Agent ему не выдаётся.
• Вопросов оператору субагент не задаёт сам. В каталоге это правило закреплено: нехватку агент возвращает вызвавшей команде.
• Опечатка в имени поля не даст ошибки. Проверяйте регистр.