Субагент — это отдельный контекст со своими инструкциями, своими инструментами и часто своей моделью; он полезен именно потому, что прочитанное им не попадает в основной разговор. Оправданность этого разделения решают два поля. Описание вызывает делегирование и конкурирует со всеми другими описанными агентами, поэтому расплывчатое либо не срабатывает никогда, либо срабатывает постоянно. Список инструментов — самый дешёвый способ удержать узкого агента узким: тот, кто умеет только читать и искать, не уйдёт править файлы. Конструктор пишет файл и проверяет оба поля, включая сочетание, которое ловит почти всех: право писать без права читать.
Возможности
Описание проверяется на фразу, вызывающую делегирование
Инструменты выбираются из настоящего списка, а не набираются по памяти
Инструменты MCP с пространством имён принимаются наравне со встроенными
Предупреждает, когда агент может писать файлы, но не может их читать
Выбор модели объяснён через то, когда каждая оправдана
Область проекта или личная, с соответствующим путём
Унаследованная модель не выписывается в файл
Скачивается как готовый .md
Как использовать Конструктор субагентов
Назовите агента и скажите, когда передавать ему работу
Выберите нужные инструменты — и только их
Выберите модель или оставьте наследование от сессии
Напишите системный промпт и скачайте файл
Пример
Ввод
tools: [Read, Grep, Glob]
Результат
description: Checks a database migration for problems that only show up in production. Use proactively whenever a migration file is added.
«Применять проактивно, когда…» заставляет агента включаться без просьбы.
Частые ошибки и устранение неполадок
Агенту ничего не делегируют. — Описание должно говорить когда, а не только что. Добавить «Используйте, когда…» или «Применяйте проактивно после…» обычно достаточно.
Два агента постоянно путают. — Их описания перекрываются. Пусть каждое называет свою ситуацию, а не свою тему.
Имя инструмента помечено как неизвестное. — Имена чувствительны к регистру и пишутся с заглавной: Read, а не read. Инструменты MCP имеют вид mcp__сервер__инструмент и принимаются как есть.
Агент правит не то, что я ожидал. — Сузьте список инструментов. Агент без Write и Edit ничего не изменит, что бы ни было в промпте.
Часто задаваемые вопросы
Когда субагент лучше, чем сделать работу на месте?
Когда работа — это «много прочитать, мало выдать»: обход кодовой базы, проверка множества файлов, исследование. Всё прочитанное остаётся в его контексте. Это же способ работать с более узким набором инструментов, чем у основной сессии.
Какую модель дать субагенту?
Наследование — хорошее значение по умолчанию. Для механических проходов, где больше проверяют, чем решают, оправдана более быстрая и дешёвая модель; там, где нужно суждение, — более сильная. Компромисс написан рядом с каждым вариантом.
Всегда ли стоит сужать инструменты?
Сужение дёшево и обратимо и надёжнее всего удерживает сфокусированного агента сфокусированным — куда надёжнее просьбы в промпте. Пустой список наследует всё, и для универсальных агентов это нормально.
Область проекта или личная?
Проектная кладёт агента в репозиторий, и у всей команды он один и тот же. Личная следует за вами между проектами. Путь обновляется по выбору.
Чем это отличается от навыка?
Навык добавляет инструкции в текущий контекст. Субагент работает в другом месте, со своим контекстом и своими инструментами, и отчитывается. Навык — чтобы изменить, как что-то делается; субагент — чтобы вынести само делание из вашего разговора.
Связанные инструменты
Конструктор навыков — Напишите SKILL.md — frontmatter проверяется по ходу ввода.