🎯 О чём этот конспект: Разбор инструмента 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