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

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

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

Прежде чем начать

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Скилл поставляется в репозитории adapty-skills вместе с adapty-integration, flow-audit, migrate-placements, ads-manager, paywall-teardown, onboarding-teardown и другими. Каждая из этих команд устанавливает все скиллы из репозитория.

claude plugin marketplace add adaptyteam/adapty-skills
claude plugin install adapty-skills@adapty

git clone https://github.com/adaptyteam/adapty-skills.git
cp -r adapty-skills/skills/* ~/.copilot/skills/

gemini skills install https://github.com/adaptyteam/adapty-skills

codex plugin marketplace add adaptyteam/adapty-skills
codex plugin add adapty-skills@adapty

npx skills add adaptyteam/adapty-skills --all

Затем попросите об этом — /flow-generator в инструментах, которые сопоставляют слэш-команды со скиллами, или «Use the flow-generator skill» в тех, которые этого не делают.

Дальше вы работаете обычным языком. Большинство запросов — один из этих вариантов:

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

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

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

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. В любом случае сохранённый черновик ни на что не влияет для ваших пользователей.

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

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

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

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.

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

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

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

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

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

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

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

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

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

Ограничения

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

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

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

Скилл загружает изображения, но не видео и не файлы кастомных шрифтов. В обоих случаях он создаёт слот и передаёт загрузку вам:

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

Превью показывает один экран в одном состоянии

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

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

Что дальше

• Скилл flow-audit — проверка в режиме чтения: готов ли черновик, который оставляет этот скилл, к публикации.
• Сохранение и публикация флоу — завершите черновик, который оставляет скилл.
• Частые проблемы — что мешает опубликовать флоу.
• Добавить локаль в Adapty Flow & Paywall Builder — та же работа по локализации, но вручную.
• Управление Adapty с помощью ИИ-агентов и инструментов разработки — другие скиллы Adapty и ИИ-инструменты.