Скилл агента для работы с флоу

Скилл flow-generator позволяет вашему AI-инструменту создавать и редактировать флоу. Опишите, что нужно сделать, на обычном языке — инструмент считает конфиг билдера через Adapty CLI или Adapty MCP сервер, перепишет его, отрендерит превью и сохранит черновик после вашего подтверждения.

Скилл — это набор инструкций, которые ваш AI-инструмент загружает по запросу. Этот скилл охватывает части конфига флоу, в которых легче всего ошибиться: какие правки блокируют публикацию, какие ссылки ломаются при удалении экрана, и что рендер-превью может и не может доказать.

Important

Скилл flow-generator экспериментальный и сохраняет изменения напрямую во флоу в вашем дашборде. Запускайте его на черновике или копии и проверяйте каждое изменение во Flow & Paywall Builder перед публикацией.

Перед началом работы

  • Инструмент ИИ с плагином Adapty: агент-кодировщик — Claude Code, Codex, Copilot CLI или Gemini CLI — либо claude.ai. Скилл предпочитает использовать Adapty CLI. Если доступен только MCP-сервер, он предложит настроить CLI; если вы откажетесь, продолжит работу через MCP и укажет, какие шаги локальной проверки не были выполнены.
  • Продукты в каталоге Adapty: прежде чем проектировать экран с продажами, скилл выведет список ваших продуктов и уточнит, какие из них должны на нём отображаться. Если подходящих нет, он может создать их по идентификаторам продуктов из стора — но сначала спросит.

Что вы можете с этим делать

Создание флоу с нуля

  • По описанию: «Пейвол для моего фитнес-приложения, два тарифа, годовой выбран по умолчанию». Скилл сам выбирает композицию, собирает её из проверенных паттернов — табы, карточки тарифов, переключатели, таймеры, прогресс-бары, нижние шторки — и использует продукты, которые вы выбрали из своего каталога.
  • По скриншоту или макету: Передайте ему референс — он воспроизведёт раскладку, цвета, типографику и стиль иконок, а затем перечислит все расхождения, которые не удалось устранить. Референсом может быть пейвол конкурента, один из ваших собственных экранов или фрейм из вашего дизайн-инструмента. Если ваш AI-инструмент подключён к этому инструменту через MCP, он читает фрейм напрямую — не нужно экспортировать скриншот или заново описывать дизайн словами.
  • С оценкой по конверсии: Если вы не предоставили макет, скилл прогоняет собранный экран через библиотеку paywall-teardown Adapty и исправляет то, что получило наиболее критичные оценки, — до того, как вы это увидите. Вы получаете экран, построенный по паттернам, которые продают в вашей категории, а не универсальную раскладку.

Изменение существующего флоу

  • Локализация для новых рынков: добавляет локаль и заполняет все локализуемые поля — заголовки, подписи к кнопкам, описания тарифов, слоты для изображений и плейсхолдеры полей ввода. Это самый быстрый способ перевести один рабочий пейвол на десять языков.
  • Переработка текстов сразу во всех локалях: меняет формулировки, не затрагивая структуру, и редактирует текст вокруг переменных с ценами, а не сквозь них — цены продолжают подставляться корректно.
  • Реструктуризация флоу: добавляет, удаляет и переставляет экраны, затем восстанавливает сломанную навигацию и сообщает о недостижимых экранах.
  • Добавление квизов и ветвлений: создаёт группы с выбором, идентификаторы вариантов и условные действия, которые направляют каждый ответ на свой экран — шаг персонализации, превращающий онбординг в целевой визит на пейвол.
  • Создание вариантов для теста: дублирует рабочую версию флоу в новый флоу, затем применяет нужное изменение. Экраны, тема, шрифты, локали, продукты и Remote Config переносятся, поэтому вариант отличается только там, где вы этого хотели.
  • Рестайлинг под сезон или кампанию: берёт цвета из референсного изображения и применяет новую тему ко всему флоу, вместо того чтобы менять стиль каждого экрана вручную.
  • Откат к более ранней версии: находит нужную версию в истории версий флоу и восстанавливает её как черновик или копирует в новый флоу. После этого скилл продолжает редактирование с этой версии.

Что вы получите

Пейвол с временной шкалой плана

A generated finance paywall: a three-step numbered timeline connected by a green rail, then a selected Annual plan card showing a per-month equivalent beside its yearly price, an unselected Monthly card, and a Continue button

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

Пейвол из одного предложения

A generated dark-themed fitness paywall: headline, three benefit rows with icons, a selected Yearly card badged Best value, an unselected Monthly card, and a Start training button

Задание было «добавить экран с пейволом» — без референса, без исходного флоу. $0.00 — это заглушка для предпросмотра, а бейдж Best value появился, потому что никто не указал скидку.

Флоу из трёх экранов

Три сгенерированных экрана рядом: квиз с выбором цели тренировки (выбран второй вариант), восьминедельный план разбит на три фазы, и экран с предложением с обратным отсчётом над карточкой Yearly

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

Установите скилл

Скилл входит в состав плагина Adapty.

Если вы уже установили плагин Adapty, этот скилл у вас есть. Если агент его не отображает, обновите плагин командой для вашего агента из README плагина.

Чтобы установить плагин в агент для разработки, выполните в терминале:

npx adapty skills install

Перезапустите агента, чтобы плагин загрузился. Чтобы установить плагин в claude.ai или Claude desktop, см. Установка плагина. Другие способы установки описаны в README плагина.

Claude Code не обновляет плагин автоматически. Чтобы получать новые скиллы по мере их выхода, в Claude Code выполните /plugin, откройте Marketplaces, выберите adapty и нажмите Enable auto-update. Команду обновления для других агентов можно найти в README плагина.

Затем опишите, что вы хотите сделать, простыми словами. Большинство запросов относятся к одной из этих категорий:

  • Опишите флоу: что делает приложение, что продаётся на экране, какой план выбрать по умолчанию.
  • Укажите дизайн: скриншот, один из ваших экранов или фрейм в инструменте дизайна.
  • Попросите о конкретном изменении: назовите флоу и что нужно изменить — новую локаль, другой текст, дополнительный экран, ветку по ответу в квизе.
  • Отвечайте на вопросы: оно спрашивает, какие продукты разместить на экране, и не выдумывает реальные цифры самостоятельно.

Как это работает

Всё, что скилл создаёт, сохраняется в локальный файл. До дашборда ничего не доходит до последнего шага.

  1. Настройка и аутентификация. Скилл устанавливает или обновляет Adapty CLI, если нужно, затем проверяет авторизацию в Adapty и считывает ID вашего приложения. Если вы не авторизованы, скилл откроет браузер для входа и дождётся завершения.

  2. Выбор или создание флоу. При редактировании скилл получает конфигурацию флоу и сообщает, что нашёл — экраны, локали, продукты и граф навигации, — чтобы ошибочный флоу был обнаружен до внесения каких-либо изменений. Перед редактированием скилл сохраняет копию полученной конфигурации в качестве резервной. История версий хранит каждую опубликованную версию, но не предыдущие состояния черновика, поэтому для черновика, который никогда не публиковался, копия — единственный способ вернуться назад. При создании нового флоу скилл создаёт чистый флоу, а не генерирует поверх уже существующего контента.

  3. Проверьте конфиг. Скилл выполняет две локальные проверки файла и одну через Adapty. Локальные проверки подтверждают, что внутренние ссылки согласованы и свойства корректно сформированы. adapty flows config validate запускает тот же сервис, который контролирует публикацию, — зелёный результат означает, что конфиг готов к публикации. Ни одна из трёх проверок ничего не сохраняет.

  4. Предпросмотр и итерации. Скилл рендерит каждый изменённый экран в виде скриншота и анализирует его. Если вы предоставили референсное изображение, он сравнивает результат рендера с файлом поэлемент за элементом — цвет, шрифт, стиль иконок, пропорции — и устраняет найденные расхождения. Всё, что выглядит неправильно, возвращает скилл к шагу 3, что обходится одним скриншотом, а не сохранением.

  5. Утвердите и сохраните. Перезапись существующего конфига требует явного подтверждения. Скилл показывает отображение «до и после» для каждого затронутого экрана, перечисляет изменения, у которых нет визуального представления, открывает один экран в браузере и указывает имя файла резервной копии. Только после этого происходит запись.

После запуска

Скилл оставляет вам сохранённый черновик. Чтобы показать его пользователям:

  1. Откройте флоу в Flow & Paywall Builder. Если флоу уже был открыт во вкладке браузера, обновите страницу — Flow & Paywall Builder не подхватывает изменения, сделанные через CLI.
  2. Просмотрите, что изменилось. Adapty помечает флоу, который был Published до сохранения, как Dirty, и этот статус видят все участники команды. Пользователи по-прежнему видят последнюю опубликованную версию.
  3. Протестируйте на реальном устройстве. В статье Предпросмотр флоу описан процесс сканирования QR-кода через мобильное приложение Adapty. Проверьте всё, что скилл отметил как непроверенное: ветвление, переключатели и все локали, кроме той, которую он отрендерил.
  4. Опубликуйте. Нажмите Publish to Live в правом верхнем углу Flow & Paywall Builder или выполните команду adapty flows publish в терминале. Флоу, не добавленный в плейсмент, недоступен ни для кого, а флоу в статусе Draft нельзя добавить в плейсмент — поэтому сначала опубликуйте его. См. Сохранение и публикация флоу.

Если результат не устраивает, попросите скилл откатить его. Скилл выведет список версий флоу, восстановит выбранную вами как черновик и покажет результат. Восстановление заменяет текущий черновик, поэтому перед заменой скилл уточнит у вас и предложит дублировать черновик в новый флоу. Если черновик ни разу не публиковался, более ранней версии в истории нет — попросите скилл записать его резервную копию обратно. Также вы можете исправить флоу вручную в Flow & Paywall Builder. В любом случае сохранённый черновик ничего не меняет для ваших пользователей.

The version history also undoes a bad publish. Ask the skill to go back to the version that was live before: it restores that version as the draft, and you publish the draft when you’re ready.

Примеры промптов

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

Перевести пейвол

Add Brazilian Portuguese to my "Summer 2026" paywall. Translate every
localizable field, not just the headline, and tell me what you couldn't.

Собрать по дизайну

Build a new paywall flow from the "Winter promo" frame in our Figma file.
Show me my products first and let me pick which ones go on it.

Добавить квиз с ветвлением

Add a quiz screen before my paywall: "What's your main goal?" with three
options, each routing to its own benefit screen, then on to the paywall.

Перепиши текст

Rewrite the headline and CTA on my onboarding to be shorter and more direct.
Keep the price variables working, and apply it to every locale.

Создай тестовый вариант

Copy my "Main paywall" into a new flow and make the monthly plan the
preselected one. Leave the original alone.

Адаптируй под кампанию

Re-theme my paywall flow to match the colors in ./design/spring.png.
Copy and layout stay as they are.

Add a screen

Add a social proof screen between the quiz and the paywall in my activation
flow — star rating and two testimonials. Ask me for the real numbers.

Загружайте изображения и видео

Скилл загружает изображение или видео с вашего компьютера и вставляет полученный URL в флоу, чтобы вам не приходилось добавлять медиафайлы в Flow & Paywall Builder вручную. Для этого нужен путь к файлу, а не само изображение: когда вы вставляете или прикрепляете картинку в чат, ваш AI-инструмент получает пиксели, но не файл, а значит — нечего загружать.

Положите ресурсы в папку на вашем компьютере и укажите инструменту путь к ней:

The hero images are in ./design/paywall/. Use hero-calm.png on the first
screen and the three icons in ./design/paywall/icons/ for the benefit rows.

Форматы и ограничения по размеру файлов совпадают с ручной загрузкой в Flow & Paywall Builder — см. Изображения, видео и иконки. Единственное исключение — SVG: такие файлы не загружаются, поэтому скилл отрисовывает одноцветные глифы inline.

Скилл загружает видео с помощью adapty flows media upload-video. Видео должно быть в формате MP4 или WebM, длиной не более 30 секунд и размером не более 50 МБ, с шириной и высотой не менее 640 пикселей каждая. GIF не поддерживается, и скилл не конвертирует анимированное изображение в видео. Если скилл работает только через MCP-сервер, загрузить видео пока нельзя: он добавляет элемент видео с пустым плейсхолдером, а сам клип вы загружаете в Flow & Paywall Builder.

Каждая загрузка добавляет отдельный ассет в медиатеку, и ни одна CLI-команда его не удаляет, поэтому повторный запуск сборки оставляет копии.

Если указать имя файла, которое инструмент не может найти, он переспросит — вместо того чтобы подставить похожий. Неверный файл даёт экран, который визуально выглядит правильно, но содержит не ту картинку, и ничто в рабочем процессе этого не поймает.

Используйте своего агента

В Adapty также есть AI Editor внутри Flow & Paywall Builder. Разница не в том, у кого больше возможностей — а в том, в чьей среде происходит работа.

AI Editor — это агент Adapty, работающий с экраном, который вы открыли. Скилл устроен наоборот: ваш агент, ваша модель, ваш инструментарий, а Adapty — лишь один из инструментов, которым он умеет пользоваться. Всё, к чему ваш AI-инструмент уже имеет доступ, идёт вместе с ним — ваш репозиторий, ваши дизайн-файлы, ваши MCP-серверы, ваши промпты и контекст.

AI Editorflow-generator skill
Чей агентAdapty, в браузереВаш: coding-агент или claude.ai
Что видитОткрытый экран и прикреплённые изображенияВсё, до чего может добраться ваш AI-инструмент
Охват одного промптаОдин экранВесь флоу — экраны, навигация, локали
ЛокализацияНе поддерживаетсяДобавляет локаль и заполняет все локализуемые поля
ОтменаОдин клик на промптРезервная копия флоу, история версий и ваше подтверждение перед каждым сохранением
НастройкаНе требуетсяПлагин Adapty, а также Adapty CLI или MCP-сервер

Используйте AI Editor, когда вы уже находитесь в билдере и хотите изменить стиль экрана прямо перед вами. Используйте скилл, когда предпочитаете выполнять работу с флоу, не покидая своего окружения.

Что скилл не делает

Скилл воспринимает ваши флоу как живой контент, поскольку опубликованный флоу обслуживает реальных пользователей.

  • Публикация остаётся за вами: Скилл останавливается на сохранённом черновике и никогда не публикует его. Опубликуйте его сами в Flow & Paywall Builder или с помощью adapty flows publish.
  • Перезапись требует вашего подтверждения: Сохранение полностью заменяет конфиг — без частичной записи и без возможности отменить изменения в черновике. При подтверждении указываются название флоу, его ID, статус и резервный файл, который скилл создал перед редактированием.
  • Восстановление остаётся черновиком: Скилл восстанавливает предыдущую версию как черновик и никогда не публикует её. Перед заменой черновика он запрашивает подтверждение.
  • Несохранённые изменения остаются за вами: Перед тем как открыть или восстановить другую версию, скилл спрашивает: сохранить несохранённые изменения, отбросить их или остаться на текущей версии.
  • Параллельное редактирование приводит к ошибке записи: Каждая запись после первой отправляет временну́ю метку updated_at конфига обратно в Adapty. Если коллега сохранил флоу в это время, Adapty отклонит запись вместо того, чтобы перезаписать его работу.
  • Удаление флоу остаётся действием на дашборде: У CLI нет команды удаления, поэтому флоу, созданный скиллом, останется до тех пор, пока вы не удалите его с дашборда.
  • Реальные числа и ассеты предоставляете вы: Рейтинги, количество отзывов, размеры скидок и цены в сторе никогда не придумываются. Если паттерн требует данных, которые вы не указали, скилл либо попросит их предоставить, либо исключит элемент — и сообщит, что именно он сделал.
Note

Чтение, валидация и предпросмотр ничего не стоят и ничего не меняют. Сохранение конфига — единственное действие, которое достигает вашего дашборда, и оно требует вашего подтверждения.

Ограничения

Запуски занимают время

Скилл проверяет и перерисовывает флоу после каждого изменения — именно это защищает дашборд от битого конфига, но делает запуск медленнее, чем обычный ответ в чате. Небольшая правка занимает несколько минут. Создание многоэкранного флоу с ветвлением займёт от 10 до 40 минут. Запустите и вернитесь позже, не стоит ждать у экрана.

Кастомные шрифты настраиваются вручную

Скилл не загружает файлы пользовательских шрифтов. Он создаёт текстовые стили, которые используются в вашем дизайне, и привязывает их к шрифту-заглушке. Загрузите шрифт в Flow & Paywall Builder и назначьте его этим стилям.

Превью отображает один экран в одном состоянии

Страница превью скилла показывает только один экран и не воспроизводит флоу целиком. Следующие вещи в ней проверить не получится. Тестируйте каждую из них на реальном устройстве — как это сделать, описано в разделе Предпросмотр флоу:

  • Навигация и ветвление: кнопка с действием навигации остаётся на месте в превью, поэтому условный маршрут не срабатывает. Каждый экран отрисовывается отдельно.
  • Переключатели и множественный выбор: строка-переключатель и строка множественного выбора отображаются в выключенном состоянии согласно значению по умолчанию. Строки с одиночным выбором и карточки продуктов отображают выбранное состояние корректно.
  • Любая локаль, кроме той, что отрисовывается: превью игнорирует локаль флоу по умолчанию и порядок списка локалей, поэтому визуально проверить перевод не получится. Переключайте локаль в Flow & Paywall Builder и ищите текст, выходящий за границы контейнера.
  • Всё, что разрешается в рантайме: реальные цены, валюта стора и пользовательский ввод. Переменная цены отрисовывается как литеральный токен, который длиннее любой реальной цены и может перекрыть текстом закреплённую кнопку — это наложение исчезает, когда цена подставляется реально.
  • Размеры экранов, о которых страница не знает: макет, чья безопасность зависит от высоты области просмотра, нужно проверять на устройстве с небольшим экраном.

Что дальше