Специалисты

Специалист - агент Claude Code с одной понятной ролью: ревьюер, дебаггер, архитектор, DevOps, тестировщик. Как правило один плагин содержит одного специалиста.

Из чего состоит

Специалист - markdown-файл agents/<имя>.md с настройками в начале (имя, описание, доступные инструменты, модель, обязательные skills) и телом, которое описывает работу. Работа записана фазами: у каждой есть цель, наблюдаемый результат и критерий завершения, а между критичными переходами стоят проверки. Пошаговых инструкций там нет: что делать, Claude знает, специалисту нужно сказать, что считать готовым.

Например, ревьюер MR идёт через фазы от «сбор контекста и diff» и «карта изменений» до «фальсификация находок», «калибровка» и «публикация».

Как работает

• Свой контекст. Специалист запускается как отдельный субагент со своим контекстом.
• Модель по характеру работы. У каждого специалиста модель указана явно (opus или sonnet) в зависимости от того, какое суждение ему предстоит.
• Результат со статусом. В выходе специалиста первым полем стоит статус: complete, blocked или partial. Недостающее он называет, а не придумывает.
• Вопросы идут через команду. Вызванный командой специалист не спрашивает вас сам: невыводимое он возвращает команде, и вопрос задаёт она.

Общие и стековые

Специалисты делятся по тому, где живёт специфика:

• Общие (debugger, mr-reviewer, self-reviewer, security-reviewer) не привязаны к языку. Стек они берут из манифеста проекта, а глубину им дают skills этого стека.
• Стековые (dotnet-coder, dotnet-test-writer, ts-test-writer) несут идиомы языка и библиотек в теле; стек есть в их имени.

Как поставить

Специалист без нужных ему skills запустится, но будет работать без них, поэтому ставьте его бандлом. Все специалисты по областям - в каталоге.

Полное устройство агента для авторов: AGENT_FRAMEWORK.md на GitHub.

Пример

/dex-mr-reviewer:mr-review owner/repo#42

Команда запускает специалиста mr-reviewer: он в своём контексте строит карту изменений, проверяет diff по осям риска и возвращает отчёт со статусом (complete, blocked или partial). Публикации в MR при этом нет, пока вы не дали команды: Отревьюить чужой MR или PR.

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

• Без skills хуже. Специалист, поставленный без своих skills, запустится, но стековых ловушек не увидит. Ставьте бандлом или проверьте ./install-bundle/sync-plugins.sh.
• Нужного стека нет. Кодеры и тестописатели есть для .NET и TypeScript; для других языков общие специалисты (ревью, поиск бага) работают, стековых нет.
• Вопрос задаёт команда, не специалист. Если вызванному специалисту чего-то не хватило, он вернёт blocked или partial с названием недостающего.

Как специалисты устроены в самой платформе: Основы, Специалисты.