Три часа в одном Agent chat на рефакторинге auth: explore нашел 40 файлов, bash вывалил 200 строк логов, а в окне осталось «сделай OAuth». Пробуете subagents — плодите 15 md в `.cursor/agents/`, description расплывчатый, делегация молчит. Или агент пишет «Task tool not found» при правильных файлах — потому что выбран Auto. За вечер выберете одну подзадачу, соберете один subagent, прогоните 5 промптов на конкретной модели и перестанете терять контекст на шумных шагах.
TL;DR / Быстрый инсайт: Cursor Subagents (2.4+, январь 2026) — роли в `.cursor/agents/{name}.md` с YAML frontmatter. Parent делегирует через Task tool: `/code-reviewer` или auto-delegation по description. Встроенные explore, bash, browser уже есть — custom subagent для узкой проверки с изоляцией контекста. Task tool часто пропадает в Auto: выберите Sonnet, Opus или GPT. Subagent — не Skill и не Cloud Agent `/in-cloud`.
Тимлид на рефакторинге auth-модуля создал `code-reviewer.md` с `readonly: true` и description «Use after auth changes». Первый прогон — «Task tool not found»: стоял Auto. Переключил на Sonnet 4.6, `/code-reviewer проверь PR diff` — сработало. На пятом промпте auto-delegation молчал: description было «helps with code». Переписал на «Use when OAuth, JWT or session storage changed» — 4 из 5 PASS. Не армия агентов, а один verifier, который дешевле копипаста чек-листа после каждого «готово».
По Вордстат (июнь 2026) спрос узкий по «cursor subagents» (26 показов/мес) и «cursor субагенты» (27), но шире по «cursor agent» (734) и «cursor agent mode» (48). Статья закрывает intent «настроить делегирование в Agent mode», не только брендовый запрос subagents.
Выберите одну делегируемую задачу — не зоопарк из 15 агентов
Боль: за 20 минут Agent chat забивается explore, bash-логами и промежуточными диффами — parent пишет код, ревьюит и гоняет тесты в одном окне. Решение — встроенные subagents Cursor (explore, bash, browser) для разведки и один custom readonly-verifier для финала. Subagent — отдельный «сотрудник» с чистым окном: parent видит summary, а не простыню. Критерий отбора: задача повторяется минимум три раза в неделю и дает шумный промежуточный output. Лучше один узкий verifier, чем «general helper».
- Запишите 3-5 кандидатов: post-PR review, verifier после «готово», test-runner на CI-fix.
- Отфильтруйте по шуму: десятки строк логов в parent — в subagent; разовый креатив — оставьте parent.
- Не дублируйте explore: custom md не переопределяет built-in explore (форум Cursor 2.4).
- Один победитель на 2-4 недели: `code-reviewer`, `verifier`, `test-runner` в kebab-case.
- Лимит 1-3 subagents в репо — иначе description пересекаются и auto-delegation путает роли.
Типичная ошибка — «general helper». В реальном проекте сработал узкий verifier по auth-diff: parent получил короткий отчет, а не 40 путей из explore.
Разложите Subagents, Skills и Cloud Agent: куда класть работу
Боль: одну задачу кладут в Skill, subagent md и Cloud Agent — три механизма конфликтуют. Решение — матрица до создания файла. Skill — ящик с runbook «как деплоим staging»; subagent — эксперт с изолированным контекстом; Cloud Agent — автономная VM на часы. Запрос «cursor agents md» (41 показов/мес) — ловушка: `AGENTS.md` в корне репо — cross-tool инструкции для Cursor, Claude Code и др., это не `.cursor/agents/`.
Критерий Skill (`.cursor/skills/`) Subagent (`.cursor/agents/`) Cloud Agent (`/in-cloud`) Задача Runbook «как деплоим» Review/debug с изоляцией контекста Долгий CI/PR на VM Контекст В parent при invoke Отдельное окно, parent — summary Облачная сессия IDE MCP Локальный mcp.json Наследует MCP родителя Team MCP на cursor.com/agents Вызов `/skill-name` `/name` или Task delegation `/in-cloud`, `/babysit`
Surprising fact из docs 2.4+ и форума Cursor (2026): страница обещает «Agent includes all custom subagents in its available tools», но в IDE массовый кейс — инжектится блок `subagent_delegation_context`, а инструмент Task отсутствует. Workaround от Colin: не Auto, а Sonnet, Opus или GPT. Параллельно cloud subagents (`/in-cloud`, changelog 3.7, июнь 2026) берут MCP только с cursor.com/agents команды — локальный Wordstat MCP в облачной сессии не появится.
Итоговый вердикт: чек-лист на сценарий — Skill. Чистый review без мусора — subagent. Часы CI в облаке — Cloud Agent.
Соберите `.cursor/agents/{name}.md` с узким description
Боль: generic description, auto-delegation молчит. Решение — frontmatter как job posting по Cursor Docs. Важно: избегайте формулировок «general coding assistant» — перепишите description как объявление вакансии с глаголами Use when / After / Before.
Пример subagent md (code-reviewer): frontmatter: name code-reviewer, description Use when OAuth, JWT or session storage changed, model inherit, readonly true, is_background false; body — Strict reviewer: security, missing tests, breaking API. Return PASS/FAIL and bullets. Полный шаблон — в Cursor Docs subagents.
Поля frontmatter: name совпадает с именем файла без `.md`; description — триггер auto-delegation, глаголы и домен из реальных промптов; model: inherit берет модель parent или задайте Sonnet/Opus явно; readonly: true для reviewer/verifier — subagent не пишет в файлы; is_background: true для долгого test-runner без блокировки parent. На практике типичная ошибка — description «general coding assistant». Перепишите как объявление вакансии: «Use when…», «After auth module changes…», «Before merge to main…». Тело — короткий system prompt по шаблонам verifier/debugger из docs, не роман.
Включите Task tool: Agent mode и модель не Auto
Боль: файлы в `.cursor/agents/` лежат правильно, агент отвечает «у меня нет Task tool» или «Task tool not found». Решение — новый Agent chat, конкретная модель (Sonnet 4.6, Opus, GPT), не Auto; проверьте team blocklist Composer. Рекомендуем named model вместо Auto: на форуме (треды 149771 и 156421) подтвержден server-side provisioning — delegation context есть, Task нет, это не ошибка пути к md.
- Agent mode, не Composer без subagents.
- Named model — Auto часто не провижит Task (форум 149771, 156421).
- Тест: `/code-reviewer проверь staged diff`.
- Team policy: ограничение моделей блокирует Task server-side.
- Delegation context есть, Task нет — provisioning сессии, не путь к файлу.
Прогоните 5 промптов: `/name` и auto-delegation
Боль: `/name` работает, естественные запросы — нет. Протокол: 2 явных `/name`, 3 без слеша, лог PASS/FAIL.
Схема: named model → промпт 1-2 с `/subagent` → 3-5 без слеша → правка description → цель 4-5 из 5 PASS
- Промпт 1-2: `/code-reviewer` + задача.
- Промпт 3-5: «проверь auth diff», «review OAuth PR» без имени.
- Лог: subagent виден в чате или parent ответил сам.
- 2+ FAIL: синонимы OAuth, JWT, session в description.
- Коммит `.cursor/agents/` после 4+ PASS.
В реальном проекте смена description с «helps with code» на «Use when OAuth, JWT or session storage changed» подняла auto-delegation с 1/5 до 4/5. Советуем не плодить еще десять md — допишите синонимы в description. Убедитесь, что явный `/name` остается fallback, если auto-delegation в клиенте капризничает.
Пройдите чек-лист: MCP, nesting, cloud vs local
- 2-3 subagents max; без «general helper».
- IDE subagents наследуют MCP родителя; для `/in-cloud` — team MCP в кабинете.
- Nesting 2.5+: не глубже двух уровней (reviewer → test-writer).
- `readonly` для audit; запись в репо — у parent.
- Verifier FAIL — правит parent, не автомерж.
Success criteria: в репозитории один закоммиченный subagent с узким description; на 5 тестовых промптах parent вызывает его через `/name` или auto-delegation; в чате виден изолированный результат без мусора explore/bash; при сбое есть чек-лист (модель, Task tool, readonly/is_background); понятно, что `AGENTS.md` в корне — не папка subagents. Делайте проверку модели перед каждым прогоном 5 промптов. Итог — вы перестаете вручную просить «сначала проверь тесты, потом правь»: verifier в md работает стабильнее копипаста.
Разобрать делегирование в Cursor на neuroalex.site: одна задача, 5 промптов. Рядом: Cursor Skills и Cloud Agent для блога.
Материал проверен: эксперт Елена Ковалева (SEO/GEO).
Достоверность: Wordstat июнь 2026 (subagents 26, agent mode 48, agents md 41); Cursor Docs 2.4+ и форум на дату публикации.
Частые вопросы
Чем Subagents отличаются от Cloud Agent и Skills?
Skills — runbook «как сделать» в `.cursor/skills/`. Subagents — изолированный review/debug в `.cursor/agents/`. Cloud Agent — долгая VM-сессия для CI/PR. Не дублируйте одну задачу в трех механизмах.
Наследуют ли subagents MCP родителя?
Локальные — да, MCP IDE-сессии. Cloud `/in-cloud` — team MCP с cursor.com/agents, не локальный mcp.json.
Можно ли запускать subagent в фоне через is_background?
Да, `is_background: true` — параллельный прогон. Быстрый verifier — foreground; долгий test-runner — background.
Почему «Task tool not found»?
Auto, Composer без subagents или team blocklist. Новый Agent chat + Sonnet/Opus/GPT + `/name`. Файлы могут быть корректны.
Чем AGENTS.md отличается от `.cursor/agents/`?
`AGENTS.md` — общие инструкции репо для разных AI-инструментов. Subagents — только `.cursor/agents/*.md` с YAML и Task delegation.
Сколько subagents в репозитории?
1-3 узких агента. Больше — путаница auto-delegation. Explore, bash, browser — встроенные, своих md не нужно.