Cursor Subagents — это специализированные ИИ-помощники, которым основной Agent делегирует работу. У каждого subagent свой context window: он получает самодостаточный промпт, работает автономно и возвращает итог родителю. Канон: cursor.com/docs/subagents. Не путать с Skills (короткие процедуры) и Hooks (скрипты на событиях).
Соседи: Rules, Background / Cloud Agents, Cursor для начинающих. Pillar — n8n / автоматизация.
Для кого Cursor Subagents
Берите subagents, когда длинный research или параллельные ветки работы раздувают главный чат. Если нужен one-shot (changelog, формат импортов) — лучше skill. Если нужен cron/PR-триггер без вашего участия — Automations.
| Режим / тип | Поведение | Лучше для | Примечание |
|---|---|---|---|
| Foreground | Ждёт завершения, сразу отдаёт результат | Последовательные шаги, нужен вывод | Блокирует родителя |
| Background | Сразу возвращает управление | Долгие задачи, параллель | is_background: true в frontmatter |
| Built-in Explore | Поиск и анализ кодовой базы | Много параллельных поисков | Быстрая модель по умолчанию |
| Built-in Bash | Серия shell-команд | Шумный вывод логов | Родитель видит итог, не весь stdout |
| Built-in Browser | Браузер через MCP | DOM/скриншоты | Фильтрует шум до релевантного |
| Custom | Markdown + YAML в .cursor/agents/ | Verifier, debugger, auditor | description решает делегирование |
*По cursor.com/docs/subagents (август 2026). Цены моделей и планов в статье не фиксируем — смотрите кабинет Cursor.
Как пользоваться: маршрут на 1 вечер
- Проверьте автоделегирование. Попросите Agent исследовать большой модуль или прогнать серию команд — часто уже поднимется Explore/Bash.
- Создайте custom. Файл
.cursor/agents/verifier.mdс frontmatter name + description и телом промпта. - Напишите description как job brief: когда вызывать («Use after tasks are marked done…», «Use proactively…»).
- Вызовите явно:
/verifier confirm auth flowили «use the verifier subagent…». - Параллель: попросите review API и docs одновременно — Agent шлёт несколько Task в одном сообщении.
- Изоляция правок: если несколько subagents правят файлы, попросите each in its own environment (worktree или cloud VM).
---
name: verifier
description: Validates completed work. Use after tasks are marked done to confirm implementations are functional.
model: inherit
readonly: true
---
You are a skeptical validator. Verify claimed work actually works:
run tests, check edge cases, report passed vs incomplete.
Frontmatter и модели
Поля: name (lowercase-hyphen), description (сигнал для делегирования), model (inherit или ID вроде composer-2), readonly (без правок файлов и state-changing shell), is_background. К model ID можно добавить параметры в скобках: claude-opus-5[effort=high]. Если модель недоступна по плану/админ-политике — Cursor откатывается на совместимую.
Расположение: project .cursor/agents/, user ~/.cursor/agents/; совместимость с .claude/agents/ и .codex/agents/. При конфликте имён project побеждает; среди project-папок приоритет у .cursor/.
Cloud: /in-cloud и /babysit
Из локальной сессии /in-cloud отправляет следующую задачу cloud subagent на отдельную VM и ветку. /babysit (или quick-action) гоняет cloud agent по PR, пока вы работаете локально. MCP у cloud subagent — из team-конфига на cursor.com/agents, не из вашего локального mcp.json.
Сильные стороны
- Изоляция шумного промежуточного вывода (поиск, shell, браузер).
- Параллельные workstreams без ожидания последовательного цикла.
- Переиспользование domain-агентов через git (`.cursor/agents/`).
- Resume по agent ID с сохранением контекста subagent.
- Readonly-режим для аудиторов без риска правок.
Типичные ошибки
- Делать subagent на one-shot задачу вместо skill.
- Пустое description — Agent не знает, когда делегировать.
- Параллельные правки в одном checkout без изоляции — перетирают друг друга.
- Ждать локальный MCP у cloud subagent — там team config.
- Путать subagents с Automations: Automations = триггеры cron/PR без вашего чата.
FAQ: Cursor Subagents
Что такое Cursor Subagents?
Cursor Subagents — специализированные помощники, которым Agent делегирует задачи. У каждого свой context window; результат возвращается родителю. Канон: cursor.com/docs/subagents.
Чем subagent отличается от skill?
Subagent нужен для изоляции контекста, параллели и многошаговой экспертизы. Skill — короткий одноразовый сценарий (changelog, формат). Если задача one-shot — берите skill.
Какие built-in subagents есть в Cursor?
Три: Explore (поиск по коду), Bash (серия shell-команд), Browser (браузер через MCP). Agent поднимает их сам, когда промежуточный вывод зашумляет главный чат.
Где лежат custom subagents?
Project: .cursor/agents/ (также .claude/agents/ и .codex/agents/ для совместимости). User: ~/.cursor/agents/. При конфликте имён побеждает project; внутри project приоритет у .cursor/.
Как явно вызвать subagent?
Синтаксис /name в промпте (например /verifier …) или естественной фразой «use the verifier subagent…». Для cloud-задачи из локальной сессии — /in-cloud; для PR — /babysit.
Работают ли subagents в Cloud Agents?
Да: editor, CLI и Cloud Agents. Cloud subagent крутится на своей VM и ветке; MCP для него берётся из team-конфига на cursor.com/agents, не из локальной сессии.
Вывод
Cursor Subagents — слой делегирования с отдельным контекстом. Старт: один verifier.md → явный /verifier → при необходимости /in-cloud. Инструкции агенту — в Rules и Skills; внешние инструменты — в MCP; общий вход — гайд новичка.
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артёма Денисова — все форматы на странице обучения. Тех-pillar — n8n для начинающих.