Supercode + Cursor: Создание гарантированных Workflow и Smart Actions
Пошаговый гайд по автоматизации Cursor AI через Supercode: создание Workflow, использование Smart Actions, Shell-команд и динамических промптов для вайбкодинга.
🎯 О чём этот конспект: Разбор инструмента Supercode для расширения возможностей Cursor AI. Автор объясняет, почему стандартные «скиллы» AI-агентов ненадежны, и показывает, как через визуальный интерфейс (UI) собрать жестко заданные цепочки действий (Workflow), которые агент обязан выполнить без отклонений.
👤 Кому будет полезно: Вайбкодерам, разработчикам на Cursor и пользователям Supercode, которые хотят автоматизировать рутинные процессы (тесты, планирование, деплой) и создавать собственных «субагентов» с узкими ролями.
✨ Что получите: Пошаговый алгоритм создания классического пайплайна «Plan & Implement», навыки работы с переменными в промптах и понимание того, как запускать внешние скрипты (Node.js, Shell) прямо внутри цикла разработки.
1. Проблема «скиллов» и преимущество Smart Actions
Контекст: Популярные AI-скиллы (как в Claude Code) — это текстовые описания возможностей. Проблема в том, что агент может проигнорировать шаг, изменить последовательность или «забыть» выполнить часть инструкции. Smart Actions в Supercode решают это через детерминированные Workflow: вы жестко задаете последовательность шагов, моделей и режимов, которым агент обязан следовать. Это превращает AI из непредсказуемого чат-бота в исполнительный конвейер.
Выгода: 100% повторяемость рабочих процессов и экономия времени на ручном переключении моделей и копировании планов.
Как применить:
Шаг 1: Установка Supercode — [Supercode] — Установите расширение/инструмент Supercode для Cursor.
Шаг 2: Доступ к UI — [Supercode Dashboard] — Перейдите в раздел Smart Actions. Теперь не нужно писать JSON/YAML конфиги вручную, всё настраивается в интерфейсе.
2. Анатомия Smart Action: от кнопок до Shell-команд
Контекст: Smart Action — это не просто промпт. Это сущность, объединяющая модель (Claude Opus, Sonnet и др.), режим (Composer, Chat, Review), системный промпт и исполняемый код. Вы можете создать кнопку в интерфейсе Cursor, которая при нажатии выполнит цепочку действий: от создания новой вкладки чата до запуска локального скрипта.
Выгода: Создание кастомных инструментов управления редактором «под себя».
Как применить:
Шаг 1: Создание действия — [UI] — Нажмите "Create Action", выберите иконку и название.
Шаг 2: Настройка триггера — [Settings] — Включите Show as button, чтобы экшен появился в боковой панели.
Шаг 3: Добавление команды — [Editor Command] — Выберите действие, например Create new composer tab, если хотите, чтобы экшен открывал чистое рабочее пространство.
3. Условное выполнение (Conditional Execution) и авто-исправление багов
Контекст: Одна из мощнейших функций — запуск экшена на основе результата выполнения Shell-команды. Например, можно настроить агент так, чтобы он запускал тесты, и только если они упали, активировал специальный режим исправления ошибок. Если тесты прошли (код возврата 0), workflow завершается.
Выгода: Автоматизация цикла «Тест — Исправление — Тест» без участия человека.
Как применить:
Шаг 1: Настройка условия — [Conditional Execution] — Пропишите команду:
npm run test
Шаг 2: Логика запуска — [Settings] — Установите запуск экшена только при неуспешном (Non-zero exit code) выполнении команды.
Шаг 3: Промпт для исправления — [System Prompt] — Укажите агенту: «Изучи логи ошибок выше и исправь код в соответствующих файлах».
4. Алгоритмические промпты и динамические переменные
Контекст: Вы можете вставлять в промпт результаты работы внешних скриптов или текущий текст пользователя через переменную $prompt. Это позволяет обогащать контекст данными из Git, таск-трекеров или даже текущей датой. Также можно использовать AI-генератор промптов (от Supercode), который переработает ваш краткий запрос в подробную инструкцию для Cursor, не тратя ваши лимиты Claude/GPT.
Выгода: Динамическое формирование контекста и автоматическая декомпозиция задач.
Как применить:
Шаг 1: Использование Shell в промпте — [Prompt Editor] — Используйте обратные кавычки или специальное поле Shell для вставки данных:
node get_jira_task.js --id 123
Шаг 2: Ссылка на ввод пользователя — [Variables] — Используйте $prompt, чтобы модифицировать запрос:
Переведи этот текст на английский и оформи как документацию: $prompt
Шаг 3: AI-модификация — [AI Generated Prompt] — Настройте промежуточный шаг, который берет ваш промпт и превращает его в пошаговый план перед отправкой в Cursor.
5. Создание Workflow «Plan & Implement» (Практический кейс)
Контекст: Классический паттерн разработки: сначала думаем (Planning), потом кодим (Coding). В обычном Cursor это два ручных этапа. В Supercode это один Workflow из двух шагов с разными моделями (например, умная Opus для плана и быстрая Sonnet для кода).
Выгода: Глубокая проработка архитектуры без риска, что агент сразу начнет писать «костыли».
Как применить:
Шаг 1: Создание шага "Advanced Plan" — [Action 1] — Выберите модель Claude 3 Opus (High Thinking), режим Architect. Промпт:
Изучи кодовую базу. Создай детальный план с архитектурными решениями для задачи: $prompt
Шаг 2: Создание шага "Implement" — [Action 2] — Выберите модель Claude 3.5 Sonnet, режим Composer. Промпт:
Выполни следующий план реализации: $prompt
Шаг 3: Сборка Workflow — [Composite Action] — Создайте новый экшен "PI", выберите тип Workflow и добавьте в Nested Actions сначала "Advanced Plan", затем "Implement".
Результат: При нажатии одной кнопки агент сначала выдаст архитектурный план, а затем сам переключится в режим написания кода и реализует его.
FAQ
В: Можно ли использовать свои кастомные режимы (Custom Modes) в Workflow?
О: Да, в настройках каждого шага (Action) можно выбрать не только стандартные режимы Cursor, но и любые ваши кастомные моды, созданные во вкладке Custom Modes в Supercode.
В: Тратятся ли токены Cursor при использовании AI Generated Prompt?
О: Нет, для предварительной модификации промптов Supercode использует собственные мощности, что позволяет экономить ваши основные лимиты в Cursor.
В: Как передать данные между шагами Workflow?
О: Переменная $prompt мутирует. Результат выполнения первого шага (например, сгенерированный план) становится входным значением $prompt для следующего шага.
В: Можно ли интегрировать внешние инструменты, например N8N или Telegram?
О: Да, через Shell-команды или URL-запросы (Fetch). Вы можете настроить экшен так, чтобы он забирал задачу по API из N8N или отправлял отчет о выполнении в Telegram.
В: Что такое Instant Run?
О: Это настройка, которая заставляет экшен выполняться немедленно после нажатия кнопки или вызова, без ожидания подтверждения пользователем или нажатия Enter.
Конспект создан на основе видео «Workflow в Cursor при помощи Supercode» канала [Dmitry Machnev]. Все права на оригинальный материал принадлежат авторам.Источник: https://www.youtube.com/watch?v=zBCbZO0hywk