Правила, скиллы, субагенты или команда агентов: что выбрать, когда агент начинает тупить

Коротко: агент тупеет не от сложной задачи, а от перегруженного контекста. Поэтому в правилах держи только то, что нужно всегда; повторяемую процедуру — в скилл, он подгружается по требованию; шумный этап — субагенту, который вернёт только итог. Команда агентов — для случая, когда исполнители должны координироваться сами.

Это ответ на вопрос «что такое субагенты в Claude Code и когда они нужны» по двум докладам NeyroSummit 16 (16 апреля 2026 года). Глеб Кудрявцев, ex-CPO Skyeng, который пишет код агентами и строит на них пайплайны, объяснил, почему агент тупеет и как по ступенькам уходить от правил к скиллам и субагентам. Никита Велс, практик по агентным системам в Claude Code, разобрал файл агента и вживую запустил команду агентов. Что изменилось в продуктах с апреля, редакция сверила с документацией Claude Code и Codex на 22 октября 2026 года; где проверить не удалось — так и сказано.

Почему агент тупеет: перегруженный контекст

Ты пишешь агенту «сделай сайт». Под капотом твой текст, объясняет Глеб, не уходит в нейросеть сам по себе — он пристёгивается к большому шаблону, системному промпту. Там уже лежат правила, список файлов проекта, описания инструментов: как сходить в интернет, как поменять файл, какие подключены MCP-серверы. Всё это модель читает на каждом шаге.

Дальше классика. Агент отвечал по-английски, ты написал правило «пиши по-русски». Агент поработал, ты дал новую задачу, он опять что-то сделал — и, по словам Глеба, «через пять-шесть сообщений он вам вдруг начинает писать по-английски». Почему? «На коротком контексте… у них внимание хорошее, они все помнят». А дальше: «Чем больше у нас уже есть информации в чате, тем это внимание ухудшается». Короткое правило агент ещё держит, а правила «на страницу, на 2, на 10» начинает частично игнорировать — и, как говорит Глеб, «по нашим меркам он начинает тупить».

Его сравнение: дай человеку 20 правил, положи рядом половину «Войны и мира» и попроси сделать выдержку с учётом всех правил. «Да вы тоже, в общем-то, не шибко хорошо ответите». И вывод Глеба: «Это не решается более умной нейросетью».

От редакции: исследования Lost in the Middle (Лю и соавторы, 2023) и Context Rot (Chroma, 2025) показывают, что модели хуже используют информацию из середины длинного входа и с ростом входа работают менее надёжно. Отсюда осторожный вывод: перегруженный контекст может ухудшать результат даже сильной модели, поэтому сначала стоит разгрузить контекст, а не только менять модель. Подробнее — в разборе контекст-инжиниринга для ИИ-агентов.

Субагенты в Claude Code: чем отличаются от правил и скиллов — лестница выбора

Глеб рассказывает лестницу как «естественное эволюционное развитие»: каждая ступень появилась, потому что предыдущая упёрлась в тот же перегруженный контекст. Сначала просто правила. Потом, говорит он, «если правила перестают помещаться к нам в контекст и начинает агент тупить из-за правил, мы начинаем запускать скиллы». Скиллы работают, но если процесс длинный — «нам надо реально добиться работоспособности какой-нибудь большой фичи» — и агент тупит уже со скиллами, переходим на субагентов. Четвёртую ступень, команду агентов, показывал Велс.

Ступень	Что это	Когда нужна	Claude Code	Codex
Правила	Короткие инструкции, которые всегда в контексте	С первого дня	CLAUDE.md (или AGENTS.md*)	AGENTS.md
Скиллы	Инструкция, у которой в контексте только название и описание, а тело грузится по требованию	Правила разрослись, а часть из них нужна «иногда»	.claude/skills/<имя>/SKILL.md	.agents/skills/<имя>/SKILL.md
Субагенты	Отдельный исполнитель со своим контекстом, возвращает итог	Этап длинный и шумный: тесты, логи, поиск, скриншоты	.claude/agents/*.md	.codex/agents/*.toml
Команда агентов	Несколько исполнителей с общим списком задач, которые сами берут работу и переписываются	Исполнителям надо самим координироваться: делить задачи, спорить, проверять друг друга	Agent Teams (экспериментальная)	—

* Claude Code читает AGENTS.md сам, только если в рабочей папке и выше нет CLAUDE.md или CLAUDE.local.md; прямое чтение — с версии 2.1.277. Есть и CLAUDE.md, и AGENTS.md — подключи второй импортом из первого или поменяй настройку Project instructions (документация).

Пути — по документации: скиллы, субагенты и Agent Teams в Claude Code; AGENTS.md, скиллы и субагенты в Codex.

Лестница Глеба — история о том, как растёт система, а не обязательный маршрут. От редакции: выбирай самый простой механизм, которого хватает для задачи. Ступени сочетаются: у одного проекта одновременно правила, пара скиллов и субагент-тестировщик. А изолированный разбор логов может сразу требовать субагента, без остановки на скиллах. Каждая следующая ступень сложнее в отладке, а субагенты и особенно команда ещё и дороже по токенам.

Схема выбора: четыре вопроса (от редакции)

1. Это нужно агенту в каждой задаче? Язык ответа, где лежат файлы, «пиши тесты после задачи» → правило.
2. Это повторяемая процедура, которая нужна иногда? Как деплоить, как собирать отчёт, как работать с сервисом → скилл.
3. Работа шумная, а тебе нужен только итог? Логи, скриншоты, длинный поиск, которые больше не понадобятся → субагент в отдельном контексте.
4. Исполнителям нужно координироваться самим? Делить работу из общего списка задач, оспаривать находки друг друга → команда агентов.

Ни один ответ не «да» — оставь работу в основном диалоге. Документация Claude Code советует то же, когда задача требует частого «туда-обратно» и общего контекста между фазами.

Сквозной пример: лендинг

Возьмём пример самого Глеба — лендинг, который ты делаешь с агентом, — и пройдём им по ступеням (раскладка — редакции).

• Правила. В CLAUDE.md или AGENTS.md — то, что верно для каждой задачи: «пиши по-русски», где лежат файлы лендинга, «пиши тесты после задачи».
• Скилл. Как проверять лендинг — что запускать, что смотреть, что считать ошибкой. Это нужно не в каждой задаче, а только когда дошло до проверки, поэтому — скилл.
• Субагент. Проверок много: «Мы сделали, проверяем, сделали, проверяем», — описывает Глеб. Если гонять их в основном треде, логи и скриншоты каждый раз оседают в контексте. Отдаёшь проверку агенту-тестировщику — он работает у себя и возвращает итог: тест проходит или нет, а если нет — что упало и где полный отчёт.
• Команда. Нужна не всегда. Сценарий, где она сильнее, документация Agent Teams описывает так: причина бага неясна, и несколько участников проверяют разные гипотезы и пытаются опровергнуть друг друга. Если лендинг ломается непонятно почему — это тот случай. Для «сделал → проверил» хватит тестировщика.

Правила: коротко и всегда в контексте

Правило — то, что агент должен помнить всегда. Во всех агентских системах — Cursor, Codex, Claude — правила живут в специальных файлах. Путь, который описывает Глеб, знаком каждому: сначала правил нет, агент косячит, правил становится всё больше, больше, и в итоге «здоровые такие правила» сами начинают мешать.

По документации Claude Code CLAUDE.md загружается в каждую сессию, и файл лучше держать до 200 строк — длинный съедает контекст и хуже соблюдается. Правила для части проекта можно вынести в .claude/rules/ с полем paths: — они загрузятся, только когда агент работает с подходящими файлами. Codex читает AGENTS.md перед началом работы, суммарный лимит этих файлов по умолчанию — 32 КиБ.

Признак, что пора на следующую ступень: правило нарушается не потому, что оно плохое, а потому, что вокруг него слишком много всего.

Скилл — правило, которое подгружается по требованию

Как объясняет Глеб, «умные люди придумали такую историю»: большую инструкцию — например, как заливать в GitHub, на сто страниц — не держать в контексте всё время, ведь агенту она нужна только иногда. «Таким образом не будем ему мозги забивать ненужной информацией, когда она ему не нужна».

Устроено так. В контексте остаются только название и суть скилла плюс системное правило «если задача совпала с описанием — догрузи скилл». Попросил нарисовать картинку — про GitHub ничего не грузится, контекст остаётся коротким. Попросил залить в GitHub — агент видит совпадение и подтягивает тело скилла. Тело может быть очень большим, а рядом с текстом могут лежать скрипты, которые агент запускает. На эфире Глеб открыл в Codex сырой файл своего скилла «проектирование стартапа»: короткий заголовок, который всегда в контексте, и длинная инструкция под ним.

Так можно держать десятки скиллов. По словам Глеба, можно сделать 50 скиллов, и агент будет «не очень сильно тупить». Но есть оговорка: чтобы система воспользовалась скиллом, ставить задачу приходится чётко, теми словами, что в описании, а завуалированную постановку агент может пропустить. Почему? Потому что много скиллов — «это то же самое, что слишком много правил»: контекст снова начинает забиваться. Отсюда практический вывод: описание скилла пиши теми словами, которыми сам ставишь задачу. Описания и правда занимают место: в Claude Code каждое обрезается на 1 536 символах, в Codex весь список скиллов по умолчанию ограничен 2 % контекстного окна.

Ставить скилл Глеб советует словами: открываешь агента и пишешь «загрузи глобально» или «в рамках проекта» плюс ссылку на GitHub или папку. Где брать скиллы и как ставить их руками — в разборе скиллов Claude на GitHub.

Примечание: при сжатии Claude Code прикрепляет последний вызов каждого скилла — первые 5 000 токенов, на все скиллы вместе до 25 000.

Субагент — отдельный исполнитель, который возвращает только итог

Следующую ступень Глеб выводит из той же беды: при длинном процессе всё, что агент делал по скиллам, остаётся в основном разговоре, и он снова тупеет. Решение — не догружать знания в имеющийся разговор, а запустить «отдельный процесс»: субагенту передают сжатый контекст и системный промпт с ролью, он работает отдельно и возвращает только итог.

Тот самый тестировщик из примера с лендингом. Логи тестов, по словам Глеба, — «это реально большое количество контекста». Субагент поработает у себя и в конце скажет: «тест проходит или тест не проходит». Все промежуточные рассуждения, скриншоты и попытки отбрасываются, а главный агент остаётся «с незасоренным контекстом, а значит, он остаётся умнее».

Вторая аналогия Глеба — босс. Представь, что задача проходит много стадий: дизайн, вёрстка, выкладка. Если ты делаешь каждую сам и ещё помнишь все этапы, «у вас башка забивается очень быстро». А если ты босс, ты поручаешь дизайн дизайнеру и потом только смотришь результат: «ну вроде красиво, окей». Голова не забивается, и ты можешь позволить себе процесс «не из трех шагов», а из 33.

Граница — по документации Claude Code: субагент нужен, когда побочная задача засыплет основной разговор логами и файлами, которые больше не понадобятся; если задача требует частого «туда-обратно» и общего контекста между фазами, оставайся в основном разговоре.

Оркестратор агентов и критик

Субагентов может быть много, и чаще всего им раздают роли по ходу задачи. Цепочка из ответа Глеба: дизайнер → критик дизайна → разработчик → критик разработки. Главного агента, который всем этим управляет, называют оркестратором, и правила у него простые: за разработчиком пускай критика; принял — новый цикл; не принял — на доработку. «Очень важно вот концепты агентов-критиков делать», — подчёркивает Глеб. Так выстраивается «цепочка-гусеница», которая последовательно прорабатывает задачу.

Может ли субагент запускать своих субагентов? В Claude Code — да, по умолчанию до трёх уровней ниже основного разговора; глубину меняет переменная CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH. В документации Codex про вложенность не сказано. Совет Глеба — «научитесь сначала делать вот односоставную такую историю»: один оркестратор и его субагенты. Когда субагенты запускают субагентов, начинаются «нелинейные всякие истории», и систему можно загнать в состояние, из которого непонятно, как выйти.

Воркшоп Никиты Велса: как это выглядит в работе

Глеб объяснил, когда переходить на ступень выше. Как это устроено руками, на том же NeyroSummit 16 показал второй нейрохакер — Никита Велс. Он занимается автоматизацией бизнес-процессов с 2020 года, с нейросетями работает с 2023-го и строит агентные системы в Claude Code, которые каждый день работают в его команде. Его доклад — «Практический воркшоп по созданию агентных систем в Claude Code»: Никита разобрал, из чего состоит файл агента, и вживую запустил команду агентов. Дальше — что из этого взять.

🎧 Трек к докладу Никиты Велса

▶

Агенты в сети

песня к его докладу · NeyroSummit 16 — включи и читай дальше

Из чего состоит файл агента

У Никиты агентная система в Claude Code — не код, а текстовые файлы. Главный — CLAUDE.md: что за проект, какие папки и агенты, где что лежит. «Если вы напишете слово привет, он в любом случае будет читать этот файл». Рядом — папка с агентами, у каждого свой файл: роль, инструменты (MCP-серверы и сервисы), процесс по шагам, формат отчёта, правила — ограничения и тонкости. Урок из его демо: генератор отчётов выдал PDF с кириллицей «точками», потому что в инструкции не был указан шрифт, — такие детали пиши в файл агента сразу.

По документации Claude Code файл субагента — Markdown с шапкой YAML. Обязательны name и description — по описанию Claude решает, когда звать агента; по желанию — tools, model, MCP-серверы и скиллы. Тело — системный промпт с анатомией Велса:

---
name: news-digest
description: Собирает новости по теме за сутки и сохраняет отчёт в markdown. Зови, когда просят дайджест или сводку новостей.
tools: WebSearch, WebFetch, Write
model: sonnet
---

Роль: ты редактор новостного дайджеста по теме, которую даст оркестратор.
Процесс: найди 10–15 свежих материалов, отсей повторы, проверь даты.
Формат отчёта: markdown-файл в папке outputs/ — заголовок, 5–7 пунктов, ссылки.
Правила: только первоисточники; без источника пункт не включай.

Пример — реконструкция редакции по формату документации, а не файл из демо.

Где сохранить. Файл news-digest.md кладёшь в .claude/agents/ проекта (агент для этого проекта, можно хранить в git) или в ~/.claude/agents/ (для всех проектов). Claude Code следит за этими папками и подхватывает новый файл за несколько секунд, без перезапуска. Главное исключение — самый первый файл в только что созданной папке agents: после него перезапусти сессию.

Как вызвать. Три способа по документации: Claude сам позовёт агента, если задача совпала с описанием; можно назвать его в запросе — «Используй субагента news-digest: дайджест по теме ИИ за сутки»; или набрать @ и выбрать агента из списка.

Что ожидать. Субагент работает в своём контексте и возвращает в основной разговор сводку. Он стартует с чистого листа: видит свой промпт, задание от главного агента и CLAUDE.md, но не историю твоего разговора — всё нужное клади в его файл или в задание.

Субагенты в Codex

В Codex субагенты включены по умолчанию. Свой агент — файл TOML в .codex/agents/ или ~/.codex/agents/ с полями name, description и developer_instructions; по желанию — model и уровень рассуждений (документация). Это подтверждает слова Глеба, что каждому субагенту можно назначить свою модель, дорогую или дешёвую, и так экономить. В локальном Codex они запускаются по твоей прямой просьбе или по инструкции в AGENTS.md или скилле и тратят больше токенов, чем один агент.

Как собрать целую систему агентов по спецификации, Велс показал через три месяца — разбор в статье «Агентная система в Claude Code».

Agent Teams: когда агентам надо координироваться самим

Agent Teams, объясняет Велс, — «те же самые субагенты», только агенты могут общаться между собой. По документации Claude Code граница тоньше: субагенты, которым Claude дал имя, тоже могут написать друг другу. Разница команды — в самостоятельной координации: у участников общий список задач, они сами берут из него работу и договариваются через сообщения, а у субагентов всей работой управляет главный агент (сравнение в документации).

На эфире Велс дал одну команду — найти новости по теме AI, сделать отчёт, выдать PDF, запустить агентов в режиме Agent Teams, — и главный агент сам создал две задачи (вторая ждала первую) и открыл окна агентов, а те переписывались через «@». Главное, по Велсу: можно переключиться на любого агента, остановить его и дописать указание — раньше с агентами говорили только через главного. На момент доклада, 16 апреля 2026 года, Велс называл функцию тестовой: только в терминале, не в расширении Claude Code, окна агентов — через tmux.

Правило выбора по документации: субагенты — для сфокусированных задач, где важен только результат; команда — когда участникам нужно делиться находками, оспаривать друг друга и координироваться самим. Для последовательной задачи вроде «нашёл новости → сделал PDF» хватит оркестратора с субагентами.

Скилл, MCP или CLI: инструкция отдельно, доступ к сервису отдельно

Это два разных вопроса. Скилл отвечает на «как делать»: процедура, порядок шагов, тонкости. MCP и CLI отвечают на «как достучаться до сервиса» — Google Таблиц, почты, браузера. Они сочетаются: скилл может описывать, какие команды CLI запускать или как пользоваться инструментами MCP.

Про MCP оба спикера предупреждают об одном и том же — это их наблюдения на апрель. Глеб: каждый MCP-сервер пристёгивает к разговору своё описание; у сервера GitHub оно, по его оценке, — «40 что-то там килобайт», и если подключить четыре таких, система, говорит он, работать перестаёт. На совет «включать там MCP, надо побольше» он отвечает прямо: «Ну, не работает». Велс: у крупных сервисов MCP «по умолчанию будут нас съедать огромное количество токенов», поэтому для Apify и похожих инструментов он берёт скилл, если тот есть.

У CLI своя цена. По словам Велса, CLI экономит токены и гибче, но агент «по умолчанию не знает всех команд» — их надо описывать, а у MCP описания инструментов (форматирование, покраска ячеек) уже есть. Новичку он советует MCP.

Вопрос	Что ставить	Чем платишь
Как делать?	Скилл (или правило, если нужно всегда)	Описание в контексте всегда, тело — после вызова
Как достучаться до сервиса — быстро, без своих инструкций?	MCP	Описания инструментов и ответы сервиса в контексте
Как достучаться до сервиса — гибко, под свою задачу?	CLI	Время на инструкцию: какие команды и как запускать (её удобно положить в скилл)

Плагин — упаковка, а не пятая ступень. По Глебу, плагин привязан к программе-оболочке — Codex, Cursor, — а скилл переносится: «скилл, сделанный для, например, Codex, очень легко переделать для Claude… У них формат один и тот же. Просто в разных они должны папках лежать». Плагин в Claude Code — папка, где одним пакетом лежат скиллы, субагенты, хуки и MCP-серверы; имена и описания скиллов и агентов включённого плагина висят в контексте на каждом ходу (документация). Поэтому ненужные плагины выключай. Сам Глеб призывает «чаще пользоваться скиллами»: так больше понимаешь, что происходит.

Новый диалог на каждый этап

Велс не рекомендует один бесконечный диалог: «каждое следующее твое сообщение загружает контекст предыдущего», а при переполненном контексте модель, по его словам, превращается из «очень умной машины» в «очень тупую». Его правило: закончил этап — план, реализацию, фичу — открыл новый диалог; помнить проект должны файлы, а не переписка. Свой ориентир в расширении VS Code он описывает так: кружок индикатора стал оранжевым — значит, контекст заполнен больше чем наполовину, пора в новый чат.

До /compact, который сжимает разговор в пересказ, Велс советует не доводить. В статье про Claude Code через API мы советовали сжимать историю на паузах между задачами; вместе это два режима: на границе этапа — новая сессия, посреди той же задачи — /compact между шагами. После сжатия корневой CLAUDE.md перечитывается с диска, а договорённости из чата могут потеряться, так что важное — в файлы.

С чего начать сегодня

Вопросы и ответы

Q1Что такое субагенты простыми словами?Кратко: Отдельные исполнители со своим контекстом: главный агент даёт им задачу, а получает обратно только итог.＋

Субагенты в ИИ-агентах — как сотрудники, которым босс поручил кусок работы: получают роль и сжатое задание, работают у себя и возвращают только результат — например, «тест проходит». Их промежуточные логи в голову главного агента не попадают. В Claude Code субагенты — файлы в .claude/agents/, в Codex — файлы TOML в .codex/agents/.

Q2Чем скилл отличается от субагента?Кратко: Скилл добавляет знания в текущий разговор, субагент выносит работу из него.＋

Скилл нужен, когда агент должен сам знать, «как правильно»: после вызова он остаётся в основном разговоре. Субагент нужен, когда длинная шумная работа не должна засорять разговор: он работает в отдельном контексте и возвращает итог. Их можно сочетать: в Claude Code скилл с context: fork запускается в отдельном субагенте.

Q3Agent Teams в Claude Code уже можно включить?Кратко: Да, но это по-прежнему экспериментальная функция, выключенная по умолчанию.＋

Включается переменной CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1, дальше просишь Claude собрать команду и описываешь роли. Ограничения доступа только по API-ключу документация не называет (документация).

Q4Есть ли субагенты в Codex?Кратко: Есть: они включены по умолчанию, свои агенты описываются в файлах TOML.＋

Файл кладёшь в .codex/agents/ или ~/.codex/agents/. Результаты собирает главный поток: режима, где агенты сами координируются через общий список задач, как в Agent Teams, на странице про субагентов Codex не описано.

Q5Сколько скиллов можно поставить, чтобы агент не тупил?Кратко: Десятки — но каждое описание тоже занимает место, поэтому пиши их чётко и выключай лишнее.＋

Глеб Кудрявцев говорит, что 50 скиллов — рабочее количество, если задачу ставить чётко. Редко нужное ставь в проект, а не глобально — Никита Велс так и делает: «обычно я устанавливаю под каждый проект отдельно набор».

Разбери материал журнала «Нейрохакер» «Правила, скиллы, субагенты или команда агентов: что выбрать, когда агент начинает тупить»: https://neyrohacker.com/skilly-i-subagenty-chto-ispolzovat/

1. Перескажи главную мысль в трёх предложениях.
2. Выпиши приёмы, которые можно применить сразу, — по шагам.
3. Задай мне три вопроса о моей задаче и адаптируй метод под мои ответы.