Cursor

НЕ ОБЯЗАТЕЛЬНО ДЛЯ НОВИЧКОВ

Способы писать код с помощью ИИ:

  • классическая IDE — код вручную;
  • веб-чат (ChatGPT, Qwen, DeepSeek, Gemini) — ответ копируют в проект;
  • локальная LLM на своём железе;
  • IDE с агентами — среда читает репозиторий, правит файлы, запускает команды и проверяет результат.

Cursor относится к последней группе. Это форк экосистемы VS Code с глубокой интеграцией LLM. В одном окне доступны автодополнение, чат по кодовой базе, Agent mode (многошаговые задачи) и встроенный браузер для проверки веб-интерфейса. Разрабатывается компанией Anysphere. Рабочий цикл — "задача → правки в репозитории → проверка → итерация"; чат помогает на промежуточных шагах, финальный результат — изменения в файлах и прохождение тестов.

Два способа работать с ИИ при разработке

Веб-чат (ChatGPT, Gemini, DeepSeek и др.) удобен для разовых вопросов. IDE с агентом (Cursor) держит проект открытым и связывает ответ модели с файлами, терминалом и тестами.

Аспект Веб-чат Cursor (Agent mode)
Контекст проекта Фрагменты кода вставляете вручную Индексация репозитория, семантический поиск по файлам
Изменения Копирование ответа в IDE Прямые правки, diff, принять или отклонить
Запуск команд Выполняете сами Терминал, тесты, браузер — по настройкам и политике
Риск автоматизации Ниже — модель сама ничего не меняет Выше — нужны ревью, .cursorignore, правила безопасности

Подсказки в строке (ghost text) — отдельный лёгкий сценарий. Tab принимает подсказку, Esc отклоняет; после правки — тесты и ревью.

Ограничения

Агент не заменяет архитектуру, безопасность и code review. Большие монорепозитории упираются в контекстное окно модели. Секреты (`.env`, ключи) исключайте через ignore-файлы. Сложный DevOps и прод-деплой по-прежнему требуют явных пайплайнов и прав доступа.

Ключевые возможности (актуальные версии)

Composer и модели

Cursor позволяет выбирать внешние модели (Claude, GPT и др.) и собственные варианты (Composer и др.) — список и лимиты зависят от тарифа. Модель подтягивает релевантные файлы по всему репозиторию через семантический поиск, поэтому контекст шире, чем у открытой вкладки редактора.

Agent mode

  • Задача формулируется на естественном языке ("добавь endpoint …", "почини падающий тест …").
  • Агент планирует шаги, создаёт/меняет файлы, запускает команды.
  • Параллельные агенты (в т.ч. через git worktrees) позволяют пробовать разные решения без поломки основной ветки.
  • Встроенный браузер помогает проверить веб-интерфейс после изменений.

Обратная связь по коду

Выделение фрагмента + комментарий → предложение патча. Удобно для точечного рефакторинга без полного переписывания модуля.

Установка и первый запуск

Скачать — cursor.com/download.

Платформа Формат
Windows x64 установщик
macOS Intel / Apple Silicon
Linux .deb, .rpm, AppImage

Первый запуск:

  1. Установите и войдите (GitHub, Google или email).
  2. Откройте папку проекта (File → Open Folder).
  3. Для агента: New Agent → опишите задачу → просмотрите diff перед принятием.
  4. Настройте Rules (.cursor/rules или UI) — стиль кода, стек, запреты.

Расширенные функции и лимиты запросов зависят от тарифа; бесплатный tier обычно ограничен по объёму.

Архитектура

  • Основа — форк VS Code. Знакомые горячие клавиши и расширения; совместимость не со всеми плагинами Marketplace.
  • Контекст — индексация кодовой базы и подбор релевантных файлов для промпта.
  • Изоляция — git worktrees и отдельные ветки для экспериментов агентов.
  • Проверка — терминал, тест-раннеры, встроенный Chromium для веб-проектов.

Контекст агента в репозитории

ИИ-агент не помнит прошлые сессии. Всё, что должно работать стабильно от задачи к задаче, хранят в файлах рядом с кодом. Подробная карта типов контекста — Контекст агента — AGENTS, skills, rules.

Три уровня инструкций:

Уровень Файл Что задаёт
Rules .cursor/rules/*.mdc Постоянные ограничения — стиль, git safety, запреты
AGENTS.md корень или docs/ Контракт репозитория — сборка, структура, границы
Skills .cursor/skills/<имя>/SKILL.md Пошаговая процедура под одну типовую задачу

Рабочий набор файлов в проекте:

  • AGENTS.md — правила команды для всех ИИ-агентов;
  • .cursorrules — проектные инструкции для Cursor;
  • .cursorignore и .cursorindexingignore — что не попадает в контекст и индекс;
  • ARCHITECTURE.md — целевая архитектура и ограничения по слоям.

Практика для команды:

  1. Держать AGENTS.md в Git и обсуждать изменения в pull request.
  2. Личные предпочтения — в AGENTS.local.md, файл в .gitignore.
  3. Перед Agent mode сверять AGENTS.md и .cursorrules на расхождения.
  4. В ревью просить у агента отчёт по пунктам из AGENTS.md.

Skills для Agent mode

Skill (навык агента) — markdown-файл SKILL.md с пошаговой инструкцией.

Слой Содержание
Rules Запреты и формат
AGENTS.md Описание репозитория
Skill Процедура под одну задачу — spec, PR, тесты, ревью

Типовой жизненный цикл разработки с навыками (по мотивам открытого набора addyosmani/agent-skills):

  • spec — зафиксировать требования до кода;
  • plan — разбить работу на маленькие шаги;
  • build — реализовать один срез за раз;
  • test — доказать, что код работает;
  • review — проверить качество перед merge;
  • ship — безопасно выкатить в прод.

Структура SKILL.md:

  • Триггер — при какой формулировке задачи подключать навык ("почини CI", "создай PR").
  • Процесс — нумерованные шаги без пропусков.
  • Red flags — сигналы остановиться и позвать человека (падающие тесты, доступ к prod, неясные требования).
  • Verification — список доказательств готовности (логи тестов, diff, метрики, скриншот UI).

Навыки лежат в .cursor/skills/ или копируются из внешнего репозитория в .cursor/rules/. В Cursor можно вызвать skill явно через @skill или положиться на auto-discovery.

Термины
  • Workflow — повторяемая последовательность шагов (спецификация → план → код → тест).
  • Quality gate — обязательная проверка перед следующим этапом (тесты зелёные, ревью пройдено).
  • Verification evidence — артефакты в отчёте агента (вывод pytest, ссылка на CI, diff файла).

Один и тот же инженерный контур на каждом PR снижает число хрупких правок. Подход стыкуется с AgentOps и вайб-кодингом — скорость плюс фиксированные шаги проверки.

Короткий шаблон задачи для Cursor Agent:

Проверь репозиторий по правилам из AGENTS.md

Шаги
1. Проверь измененные статьи на запрещенные языковые паттерны
2. Проверь структуру разделов - вступление, объяснение, выводы, связи
3. Верни отчет - нарушения по приоритету, затем конкретные правки
Практика в команде
  • какие каталоги агент не трогает;
  • обязателен ли npm test или pytest перед merge;
  • кто принимает diff.

Cursor ускоряет черновик; merge подтверждает человек.

Когда Cursor уместен

  • Быстрые прототипы, скелет API, миграции шаблонного кода.
  • Рефакторинг с хорошим покрытием тестами.
  • Изучение незнакомой кодовой базы (навигация + объяснения).

Менее уместен как единственный инструмент в жёстко регулируемых средах (банк, ГОСТ), когда политика запрещает облачные LLM. Тогда остаются локальные модели или классическая IDE без отправки кода наружу.

Официальный сайт — cursor.com.

См. также