Cursor AI промпты: 15 шаблонов которые реально работают для вайбкодинга

Cursor AI промпты 2026: 15 шаблонов которые реально работают

Качество промпта в Cursor — это разница между мусором и рабочим кодом. Большинство людей пишут в Composer что-то вроде «сделай форму логина» и удивляются, почему получается каша. Ниже — 15 конкретных шаблонов для пяти реальных задач: создать, отрефакторить, протестировать, отладить, объяснить. Формат «сохранить в закладки».

Почему первый промпт решает всё

Это не преувеличение. Если первый промпт размытый, Cursor начнет угадывать требования и почти всегда угадает не так. Хорошая новость: есть три стратегии, которые убирают эту проблему на корню.

Q&A стратегия — перед тем как писать код, просишь Cursor задать уточняющие вопросы. Он спрашивает про типы платежей, нужен ли биллинг-дашборд, должен ли статус оплаты влиять на доступные фичи. Из диалога складывается план, который потом вставляешь в стартовый промпт следующей сессии.

Pros and cons стратегия — для выбора между инструментами или архитектурными решениями. Даешь Cursor несколько вариантов, просишь взвешенный обзор с учетом твоей кодовой базы. Resend vs Loops vs Mailgun — он сравнит цену, сложность интеграции, совместимость с твоим стеком.

Role prompt стратегия — самая мощная. Просишь Cursor надеть шляпу security advisor или database expert. Меняется подход, меняется глубина. Именно так делают профессиональный code review внутри IDE.

Максим: «Я всегда начинаю сессию в Cursor с уточняющих вопросов. Особенно если задача касается платежей или архитектуры. Пять минут на Q&A экономят три часа переделки. NanaBanana с 200 000+ пользователями мы строили именно так — сначала план, потом код.»

Анатомия хорошего промпта для Cursor

Прежде чем смотреть на шаблоны, разберем, из чего состоит эффективный промпт. Cursor работает лучше, когда промпт — это техническое задание, а не пожелание.

Инструменты Cursor, которые усиливают промпт: @file и @folder дают контекст конкретного кода, @docs позволяет ссылаться на документацию библиотек, @web включает поиск. В Composer для многофайловых изменений — всегда указывай область: «Не трогать файлы вне X».

Горячие клавиши, которые нужны сразу: Cmd+K — инлайн редактирование (быстро, одно место), Cmd+L — Chat (вопросы и объяснения), Cmd+Shift+I — Composer (многофайловые задачи).

15 промптов под реальные задачи

Создать компонент или фичу

Это самый частый сценарий. Три шаблона — от простого к сложному.

Промпт 1. Простой компонент

Создай React-компонент UserCard на TypeScript.
Пропсы: name: string, email: string, avatarUrl?: string, role: 'admin' | 'user'.
Стили: Tailwind CSS. Без внешних зависимостей кроме React.
Добавь JSDoc к интерфейсу пропсов.

Когда использовать: изолированный UI без логики. Composer здесь избыточен — достаточно Chat или Cmd+K.

Промпт 2. Фича со связями

Реализуй feature флаги для @features/config.ts.
Правила:
- Флаги читаются из переменных окружения NEXT_PUBLIC_FEATURE_*
- Дефолтные значения в defaultFeatures объекте
- Хук useFeatureFlag(flagName: string): boolean
- Провайдер FeatureFlagProvider оборачивает _app.tsx
Не трогать файлы вне /features и /hooks директорий.

Когда использовать: фича затрагивает несколько файлов. Composer в Agent mode.

Промпт 3. API-эндпоинт с валидацией

Создай POST /api/subscribe эндпоинт (Next.js App Router).
Требования:
- Zod-схема: { email: z.string().email(), plan: z.enum(['free', 'pro']) }
- Если email уже есть — вернуть 409 с сообщением
- Успех — 201, тело { id, email, createdAt }
- Добавь rate limiting через @lib/rateLimit.ts
Используй паттерн из @app/api/auth/route.ts

Когда использовать: новый эндпоинт. Показываешь существующий похожий файл через @ — модель копирует стиль.

Отрефакторить функцию или файл

Рефакторинг — это где Cursor реально экономит часы. Но без точного промпта он будет рефакторить не то.

Промпт 4. Убрать дублирование

@utils/formatters.ts — отрефакторируй этот файл.
Задача: убрать дублирование. Функции formatPrice и formatPriceWithCurrency делают одно с разными параметрами.
Объедини в одну с опциональным параметром currency?: string.
Обнови все импорты этой функции по всему проекту.
Не менять сигнатуры других функций в файле.

Лайфхак: фраза «обнови все импорты» запускает поиск по кодовой базе — Cursor найдет все места использования сам.

Промпт 5. Разбить большой компонент

@components/Dashboard.tsx — этот компонент 400+ строк.
Раздели его на:
1. DashboardHeader — шапка с навигацией
2. DashboardStats — блок с метриками
3. DashboardTable — таблица данных
4. Dashboard — оркестратор, импортирует три выше
Пропсы оставь те же, что и сейчас. TypeScript интерфейсы для каждого компонента.

Промпт 6. Миграция на новый паттерн

Перенеси все API-вызовы в @pages/ с fetch на React Query.
Используй конвенцию из @hooks/useUsers.ts как референс.
Создай хуки в /hooks/queries/.
Убрать useState для loading/error состояний — React Query управляет этим сам.
Не трогать компоненты — только хуки и их импорты.

Написать тесты

Тесты — идеальная задача для Cursor. У него есть контекст кода, он знает паттерны. Нужен только правильный промпт.

Промпт 7. Unit-тесты для утилиты

Напиши unit-тесты для @utils/calculateDiscount.ts с Vitest.
Покрой:
- Нормальный сценарий: скидка 10% на 100 = 90
- Граничный случай: скидка 0%
- Граничный случай: скидка 100%
- Ошибка: скидка больше 100% — должен бросить Error
- Ошибка: отрицательная цена — должен бросить Error
Файл: __tests__/utils/calculateDiscount.test.ts

Промпт 8. Integration-тест для API

Напиши integration-тест для POST /api/subscribe из @app/api/subscribe/route.ts.
Используй supertest. Мокай @lib/db.ts через vi.mock.
Тест-кейсы:
- Валидный запрос → 201
- Дублирующий email → 409
- Невалидный email → 400
- Отсутствует plan → 400
Следуй структуре из @__tests__/api/auth.test.ts

Промпт 9. E2E-тест с Playwright

Напиши Playwright тест для флоу регистрации.
Шаги: открыть /register → заполнить форму → отправить → проверить редирект на /dashboard.
Тест должен:
- Использовать Page Object Model из @e2e/pages/
- Мокать POST /api/auth/register
- Проверить отображение welcome message после редиректа
Файл: e2e/auth/register.spec.ts

Задебажить ошибку

Для дебага в Cursor есть специальный режим — Debug Mode. Но его можно активировать и промптом.

Промпт 10. Классический дебаг

У меня ошибка: "Cannot read properties of undefined (reading 'map')"
Место: @components/UserList.tsx, строка 34.
Стек ошибки: [вставь стек].
Данные приходят из хука useUsers из @hooks/useUsers.ts.
Найди причину. Не исправляй — сначала объясни почему это происходит.

Лайфхак из видео: просишь сначала объяснить, не исправлять. Так понимаешь проблему и не получаешь «исправление», которое ломает что-то рядом.

Промпт 11. Security review (Role prompt стратегия)

Ты — ethical hacker и bug bounty hunter.
Проверь @app/api/ на уязвимости.
Особое внимание: OWASP Top 10, SQL injection, auth bypass, rate limiting.
Формат вывода: Markdown таблица с колонками Severity | Файл | Описание | Impact.
Порядок: Critical → High → Medium → Low.
Сохрани результат в SECURITY.md

Этот промпт — прямо из практики: после каждой интеграции с платежами или внешними API делай security review. Risk score 8.5/10 на стартовом проекте — нормально, главное знать где.

Промпт 12. Performance audit

Ты — performance engineer.
Проанализируй @app/(website)/ на проблемы с производительностью.
Ищи: лишние ре-рендеры, отсутствующие memo/useCallback, большие бандлы, N+1 запросы.
Приоритизируй по impact. Конкретные файлы и строки.

Объяснить код

Понимать чужой код — это 30% работы любого разработчика. Cursor делает это быстрее.

Промпт 13. Объяснить незнакомый файл

@lib/sanity-adapter.ts — объясни что делает этот файл.
Я знаю TypeScript, но не знаком с NextAuth adapter API.
Объясни: зачем нужен адаптер, как он связан с Sanity, какие методы обязательные.
Уровень: как объяснил бы коллеге, который только начинает.

Промпт 14. Объяснить конкретную функцию

@hooks/useFeatureFlag.ts, функция useFeatureFlag — объясни построчно.
Что такое useContext здесь, зачем проверка на null, почему boolean возвращает, а не сам флаг.
Если есть потенциальные проблемы с этой реализацией — скажи.

Промпт 15. Создай обучающий Notebook

Создай Jupyter Notebook по теме "Работа с Stripe Webhooks в Next.js".
Структура:
1. Что такое webhook и зачем нужна верификация подписи
2. Код обработчика с комментариями построчно
3. Распространенные ошибки и как их отловить
4. Тест сценарий с моком Stripe-события
Уровень: разработчик, который видит Stripe первый раз.

Три режима Cursor которые меняют игру

Промпты работают по-разному в зависимости от режима. Вот что нужно знать.

Plan Mode — включи перед сложной задачей. Cursor не пишет код сразу: исследует кодовую базу, задает вопросы, составляет план с архитектурой и примерами. Когда одобряешь план — нажимаешь Build и начинается реализация. Сохраняй план в документацию проекта — потом удобно возвращаться к решениям.

Паттерн из практики: дорогую reasoning модель (например, Claude Opus 4.6) — на планирование. Быструю (Composer One) — на реализацию по готовому плану. Opus думает медленно, но качественно. Composer One вызывает инструменты в 4 раза быстрее frontier-моделей.

Debug Mode — для непонятных багов. Cursor выдвигает 2-3 гипотезы, инструментирует цепочку вызовов логами, говорит что воспроизвести. Ты воспроизводишь — он читает логи и чинит. Хорошо работает для утечек памяти и проблем с производительностью.

Background Agents (Cloud Agents) — запускаешь задачу, закрываешь IDE, агент работает в облаке Cursor на отдельной ветке. Результат приходит как Pull Request. До 8 параллельных агентов. Удобно для обновления зависимостей, бэкфилла тестов, однотипных правок по всему проекту.

Skills и Rules: как сохранить промпты навсегда

Хороший промпт не должен жить в голове или в заметках. В Cursor 2.4 появились две вещи.

Rules (.cursor/rules) — это «конституция проекта». Инструкции, которые всегда в контексте каждого диалога. Пиши туда стиль коммуникации, запрет создавать документацию без согласования, предпочтения по библиотекам.

Правила должны быть короткими. Не копируй туда всё — только то, что важно в каждой сессии. Расширяй только после того как агент несколько раз ошибся в одном месте.

Skills — динамически подключаемые наборы инструкций. Если Rules — это лампочка, которая горит всегда и жжет токены, то Skills — датчик движения: включается когда нужно. Сюда пакуй конкретные рабочие процессы: как делать PR, как запускать тесты, как форматировать код.

Команды (slash-commands /) — это сохраненные промпты для рутины: работа с Git, запуск тестов, генерация changelog. Вместо того чтобы каждый раз печатать «создай PR с описанием изменений», набираешь /pr.

Как комбинировать стратегии

Один промпт — это хорошо. Комбинация стратегий — лучше.

Сценарий: добавить новую интеграцию

1. Q&A стратегия: «Перед тем как реализовать интеграцию с Resend, задай мне вопросы о требованиях»
2. Pros and cons: «Сравни Resend, Loops и Mailgun для моего проекта @package.json с учетом Next.js и TypeScript»
3. Role prompt: «Ты — security advisor. После реализации проверь API route на уязвимости»

Сценарий: рефакторинг легаси-кода

1. Plan Mode: «Составь план рефакторинга @components/OldDashboard.tsx без написания кода»
2. Composer Agent: «Реализуй пункты 1-3 из плана»
3. Debug Mode: «Запусти тесты. Если что-то сломалось — разберись почему»

Сценарий: онбординг в новый проект

1. Объяснение: «@src/ — объясни общую архитектуру проекта. Какие паттерны используются?»
2. Детализация: «@app/api/ — как организована аутентификация? Что происходит при логине?»
3. Debug: «@middleware.ts — почему этот route protected, а этот нет?»

FAQ

Чем Composer отличается от Chat в Cursor?
Chat (Cmd+L) — для вопросов и объяснений по конкретным файлам. Composer (Cmd+Shift+I) — для изменений, которые затрагивают несколько файлов. Если правишь что-то в одном месте — Chat или Cmd+K быстрее. Если строишь фичу с нуля или рефакторишь архитектуру — Composer.

Как передать контекст файла в промпт?
Используй @ перед именем файла, папки или символа. В Chat пишешь @components/UserCard.tsx — Cursor прочитает файл и учтет в ответе. @docs подключает индексированную документацию библиотек. @web включает поиск.

Почему Cursor генерирует не тот код?
Скорее всего, промпт не содержит контекст. Добавь @ ссылки на похожие файлы в проекте — Cursor будет копировать твой стиль, а не придумывать свой. Также помогает явно указать что не трогать.

Нужно ли указывать язык и фреймворк в каждом промпте?
Нет, если настроил .cursor/rules. Туда один раз пиши «TypeScript, React 18, Next.js App Router, Tailwind». Cursor будет знать стек без повторений.

Стоит ли использовать Plan Mode для небольших задач?
Нет. Plan Mode нужен для сложных многофайловых изменений, где важно не ошибиться с архитектурой. Для простых задач (создать компонент, починить баг) это лишний шаг.

Как проверить что Cursor не сломал что-то при рефакторинге?
Прямо в промпте пиши: «После изменений запусти тесты и убедись что всё зеленое». В Agent mode Cursor выполнит команду в терминале и среагирует на ошибки.

Как сохранить промпты чтобы переиспользовать?
Частые промпты — в slash-commands. Стиль и конвенции — в Rules. Сложные рабочие процессы — в Skills. Команды и Rules коммитятся в репозиторий и становятся доступны всей команде.

Глоссарий

Composer — режим Cursor для многофайловых изменений. Описываешь задачу, он редактирует нужные файлы, ты просматриваешь диффы перед принятием.

Agent mode — Composer с автономным выполнением: читает файлы, вносит правки, запускает команды в терминале, итерирует без подтверждения каждого шага.

Plan Mode — режим без написания кода. Cursor исследует кодовую базу, составляет план с архитектурой и примерами, ждет одобрения.

Debug Mode — режим для сложных багов. Cursor выдвигает гипотезы, инструментирует код логами, анализирует вывод.

Background (Cloud) Agents — агенты, работающие в облаке Cursor на отдельной ветке. Результат — Pull Request. Можно запустить до 8 параллельных.

Skills — динамически подключаемые пакеты инструкций. Загружаются в контекст только когда нужны.

Rules — статические инструкции, которые всегда в контексте. «Конституция проекта».

LSP (Language Server Protocol) — протокол, который дает Cursor понимание кода: навигация, автодополнение, рефакторинг.

MCP (Model Context Protocol) — открытый протокол для подключения внешних сервисов к Cursor. GitHub, базы данных, браузер — через MCP.

@-ссылка — синтаксис контекста в промпте. @file дает содержимое файла, @folder — папки, @docs — документацию.

Все инструменты, которые упоминались в статье, есть в каталоге AI-инструментов VibeCoderz. Подробный обзор Cursor — с ценами, плюсами и сравнением с Windsurf и Claude Code — там же.

Если хочешь разобраться с Cursor под свой конкретный стек и задачи — запишись на консультацию к Максиму.

Обновлено: май 2026