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 вечер

  1. Проверьте автоделегирование. Попросите Agent исследовать большой модуль или прогнать серию команд — часто уже поднимется Explore/Bash.
  2. Создайте custom. Файл .cursor/agents/verifier.md с frontmatter name + description и телом промпта.
  3. Напишите description как job brief: когда вызывать («Use after tasks are marked done…», «Use proactively…»).
  4. Вызовите явно: /verifier confirm auth flow или «use the verifier subagent…».
  5. Параллель: попросите review API и docs одновременно — Agent шлёт несколько Task в одном сообщении.
  6. Изоляция правок: если несколько 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 для начинающих.