フローを操作するためのエージェントスキル

flow-generatorスキルを使うと、AIツールでフローの作成・編集ができます。作りたいものや変更したい内容を普通の言葉で伝えるだけで、ツールがAdapty CLIまたはAdapty MCPサーバーを通じてフローのビルダー設定を読み取り、書き換え、プレビューを表示し、承認後にドラフトとして保存します。

スキルとは、AIツールがオンデマンドで読み込む一連の指示です。このスキルでは、フロー設定でミスが起きやすい部分を説明します。具体的には、どんな変更を加えるとパブリッシュができなくなるか、スクリーンを削除したときにどの参照が壊れるか、レンダリングプレビューで確認できることとできないことについて解説します。

Important

フロージェネレータースキルは実験的な機能であり、ダッシュボード上のフローに直接変更を保存します。必ず下書きまたはコピーに対して実行し、パブリッシュ前にすべての変更を Flow & Paywall Builder で確認してください。

始める前に

  • Adapty プラグインを持つ AI ツール: Claude Code、Codex、Copilot CLI、Gemini CLI などのコーディングエージェント、または claude.ai。このスキルは Adapty CLI を優先して使用します。MCP サーバーのみの場合、CLI のセットアップを提案します。断った場合は MCP 経由で処理を続行し、実行されなかったローカル検証ステップを個別に明示します。
  • Adapty カタログ内のプロダクト: 販売画面を設計する前に、スキルはあなたのプロダクト一覧を確認し、どれを画面に含めるか尋ねます。適切なものがない場合は、指定したストアのプロダクト ID から新規作成することができます。その際は事前に確認を取ります。

これでできること

フローをゼロから作成する

  • 説明から作成: 「フィットネスアプリ用のペイウォール、年間プランを事前選択した2つのプラン」といった説明を渡すだけで、構成を自動で決定し、検証済みのパターン(タブ、プランカード、トグル、カウントダウン、プログレスバー、ボトムシート)からビルドし、カタログから選んだプロダクトを使用します。
  • スクリーンショットやデザインから作成: 参照画像を渡すと、レイアウト・カラー・タイポグラフィ・アイコンスタイルに合わせて再現し、再現できなかった差異をすべて報告します。参照画像は競合他社のペイウォール、自社の既存画面、またはデザインツールのフレームでも構いません。AIツールがMCP経由でそのデザインツールに接続されていれば、フレームを直接読み取るため、スクリーンショットのエクスポートやデザインを言葉で再説明する必要はありません。
  • コンバージョン基準での評価: デザインを提供しなかった場合、スキルはビルドした画面に対してAdaptyのpaywall-teardownライブラリを実行し、最も優先度の高い問題を修正してから、あなたに画面を見せます。汎用的なレイアウトではなく、あなたのカテゴリで成果を上げているパターンに基づいた画面が得られます。

既存のフローを変更する

  • 新しい市場へのローカライズ: ロケールを追加し、ヘッドライン、ボタンラベル、プランのキャプション、画像スロット、入力プレースホルダーなど、ローカライズ可能なすべてのフィールドを埋めます。1つの完成したペイウォールを10言語に展開する最速の方法です。
  • 全ロケールのコピーを一括書き換え: 構造を変えずに文言を変更し、価格変数を通さずにその周辺を編集するため、価格の表示が維持されます。
  • フローの構造を変更: 画面の追加・削除・並び替えを行い、それによって壊れたナビゲーションを修復し、到達できなくなった画面があれば報告します。
  • クイズと分岐の追加: 選択可能なグループ、オプションID、各回答を対応する画面にルーティングする条件付きアクションを構築します。オンボーディングを適切なペイウォール訪問につなげるパーソナライズのステップです。
  • テスト用バリアントの作成: すでに機能しているフローの本番バージョンを新しいフローに複製し、テストしたい変更を適用します。画面、テーマ、フォント、ロケール、プロダクト、リモートコンフィグはそのまま引き継がれるため、バリアントは意図した箇所だけが異なります。
  • 季節やキャンペーンに合わせたデザイン変更: 参照画像から色をサンプリングし、各画面を手作業でスタイル変更する代わりに、フロー全体に新しいテーマを適用します。
  • 以前のバージョンに戻す: フローのバージョン履歴から以前のバージョンを見つけ、ドラフトとして復元するか新しいフローにコピーします。スキルはそのバージョンから編集を続行します。

生成されるもの

プランタイムラインのあるペイウォール

生成されたファイナンスペイウォール:グリーンのレールでつながれた3ステップの番号付きタイムライン、月換算価格と年間価格が表示された選択済みの年間プランカード、未選択の月間カード、そして続行ボタン

2枚のプランカードの上に番号付きタイムラインを配置しています。デバイス上でレンダリングされているため、ストアが価格を解決済みです。年間プランの月換算価格はAdaptyが計算します。

1文からペイウォールを生成

生成されたダークテーマのフィットネスペイウォール:見出し、アイコン付きの3つのメリット行、「Best value」バッジ付きの選択済み「年間」カード、未選択の「月間」カード、「Start training」ボタン

指示は「ペイウォール画面を追加して」のみで、参考資料も元のフローもありませんでした。$0.00 はプレビュー用のスタブ値で、割引が指定されていないため Best value バッジが表示されています。

3画面のフロー

横並びに生成された3つの画面:2番目の選択肢が選ばれたトレーニング目標クイズ、3つのフェーズに分かれた8週間のプラン、カウントダウン付きのYearlyカードが表示されたオファー画面

クイズ、プラン、オファーが画面間のナビゲーションで繋がっています。カウントダウンは描画されますが、実際に動作するかどうかはデバイスで確認する必要があります。

スキルをインストールする

スキルは Adapty プラグインの一部です。

Adapty プラグインをすでにインストール済みであれば、このスキルは利用可能です。エージェントの一覧に表示されていない場合は、プラグイン README に記載されているコマンドでプラグインを更新してください。

コーディングエージェントにプラグインをインストールするには、ターミナルで次のコマンドを実行してください:

npx adapty skills install

エージェントを再起動してプラグインを読み込んでください。claude.ai または Claude デスクトップへのインストール方法は、プラグインのインストール を参照してください。その他のインストール方法については、プラグイン README を参照してください。

Claude Code はプラグインを自動更新しません。新しいスキルが追加されたタイミングで取得するには、Claude Code で /plugin を実行し、Marketplaces を開いて adapty を選択し、Enable auto-update を選んでください。その他のエージェントでの更新コマンドは、プラグイン README を参照してください。

あとは、やりたいことを普通の言葉で説明するだけです。ほとんどのリクエストは次のいずれかに該当します:

  • フローを説明する: アプリが何をするか、画面で何を販売するか、どのプランをデフォルトで選択するか。
  • デザインを指定する: スクリーンショット、自分のスクリーンのひとつ、またはデザインツールのフレーム。
  • 具体的な編集を依頼する: フロー名と変更内容(新しいロケール、別のコピー、追加スクリーン、クイズの回答に基づく分岐など)を伝える。
  • 質問に答える: どのプロダクトをスクリーンに表示するかを尋ねてくるので、実際の数値が必要な場合は答える(でたらめな数値は使わない)。

仕組み

スキルが構築するすべての内容は、ローカルファイルに集約されます。最後のステップが完了するまで、ダッシュボードには何も反映されません。

  1. セットアップと認証。スキルは必要に応じて Adapty CLI をインストールまたは更新し、Adapty へのログインを確認してアプリ ID を読み取ります。ログインしていない場合は、ブラウザでログイン画面を開き、完了するまで待機します。

  2. フローを選択または作成する。編集の場合、フローの設定を取得し、見つかった内容(画面、ロケール、プロダクト、ナビゲーショングラフ)を報告します。これにより、変更が加わる前に誤ったフローを検出できます。編集前に、スキルは取得した設定のコピーをバックアップとして保持します。バージョン履歴には公開済みのすべてのバージョンが保存されますが、下書きの以前の状態は保存されません。そのため、一度も公開されていない下書きの場合、このコピーが唯一の復元手段となります。新規作業の場合は、コンテンツがすでに存在するフローに上書き生成するのではなく、新しいフローを作成します。

  3. 設定を検証する。このスキルはローカルファイルに対して2つの検証を行い、さらにAdaptyに対して1つの検証を行います。ローカルの検証では、内部参照の整合性とプロパティの形式が確認されます。adapty flows config validate は公開時に使用されるのと同じサービスを実行するため、グリーンの結果が出れば設定は公開可能な状態です。3つの検証はいずれも何も保存しません。

  4. プレビューして繰り返す。スキルは変更されたスクリーンをスクリーンショットとしてレンダリングし、確認します。参照画像を指定した場合は、レンダリング結果をファイルと要素ごとに比較します(色、書体、アイコンスタイル、プロポーションなど)。修正できる差異はここで解消されます。何か問題があればスキルはステップ3に戻りますが、その際に消費されるのは保存ではなくスクリーンショットです。

  5. 承認して保存する。既存のコンフィグを上書きする場合は、明示的な確認が必要です。このスキルは、変更したすべての画面のレンダリング前後を表示し、視覚的な変化がない変更の一覧を表示し、1つの画面をブラウザでライブ表示し、バックアップファイル名を明示します。その後に初めて書き込みが行われます。

実行後

スキルは下書きを保存した状態で終了します。ユーザーに届けるには:

  1. フローをフロー&ペイウォールビルダーで開く。 すでにブラウザのタブで開いていた場合は、ページを更新してください。CLIから書き込まれた内容は、フロー&ペイウォールビルダーに自動で反映されません。
  2. 変更内容を確認する。 保存前に Published 状態だったフローは、Adaptyによって Dirty としてマークされ、チームの全員にそのステータスが表示されます。ユーザーには引き続き最後に公開されたバージョンが表示されます。
  3. 実機でプレビューする。 フローのプレビュー では、Adaptyモバイルアプリを使ったQRコードによるフローの確認方法を説明しています。スキルが未検証として報告した内容(分岐、トグル、レンダリングしたロケール以外のロケールなど)をテストしてください。
  4. 公開する。 フロー&ペイウォールビルダーの右上にある Publish to Live をクリックするか、ターミナルから 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.

プロンプト例

スキルにはコマンド、設定フォーマット、検証手順が組み込まれているため、プロンプトでそれらを説明する必要はありません。どのフローを対象にするか、完了時にどんな状態になっているべきかを伝えるだけです。

ペイウォールを翻訳する

「Summer 2026」ペイウォールにブラジルポルトガル語を追加して。
見出しだけでなく、すべてのローカライズ可能なフィールドを翻訳し、
対応できなかった箇所があれば教えて。

デザインからビルドする

Figmaファイルの「Winter promo」フレームから新しいペイウォールフローを作成して。
まず自分のプロダクトを表示して、どれを載せるか選ばせて。

分岐するクイズを追加する

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をフローに紐付けます。そのため、フロー & ペイウォールビルダーで手動でメディアを追加する必要はありません。必要なのはファイルパスであり、画像そのものではありません。チャットに画像を貼り付けたり添付したりすると、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.

Formats and size limits match a manual upload in the Flow & Paywall Builder — see Images, videos, and icons. SVG is the one exception: it fails to upload, so the skill draws single-color glyphs inline instead.

スキルは adapty flows media upload-video を使って動画をアップロードします。動画は MP4 または WebM 形式のファイルで、長さは最大 30 秒、ファイルサイズは最大 50 MB、幅と高さはそれぞれ 640 ピクセル以上である必要があります。GIF はサポートされておらず、スキルはアニメーション画像を動画に変換しません。スキルが MCP サーバー経由のみで実行される場合、動画をアップロードすることはできません。その場合、スキルは空のプレースホルダーを持つ動画要素を配置するため、Flow & Paywall Builder でクリップをアップロードしてください。

アップロードするたびにメディアライブラリに個別のアセットが追加され、CLIコマンドで削除する方法がないため、ビルドを再実行するたびにコピーが溜まっていきます。

ツールが見つけられないファイル名を指定すると、似たファイルで代替するのではなく確認を求めてきます。間違ったファイルを指定した場合、画面は正常にレンダリングされるものの、誤った画像が表示されます。このような問題はワークフロー内で検知できません。

独自のエージェントを利用する

Adapty には、フロー&ペイウォールビルダー内に AI エディター も用意されています。どちらの機能が多いかという違いではなく、作業がどの環境で行われるかの違いです。

AI エディターは Adapty のエージェントで、開いている画面上で動作します。スキルはその逆の構成です。あなた自身のエージェント、あなたのモデル、あなたのツールを使い、Adapty はその一つのツールとして機能します。あなたの AI ツールがすでにアクセスできるすべてのもの(リポジトリ、デザインファイル、MCP サーバー、独自のプロンプトやコンテキスト)がそのまま使えます。

AI エディターflow-generator スキル
エージェントの種類Adapty のエージェント(ブラウザ上)あなたのエージェント:コーディングエージェントまたは claude.ai
参照できる情報開いている画面と添付した画像AI ツールがアクセスできるすべての情報
1 プロンプトの範囲1 つの画面フロー全体(画面、ナビゲーション、ロケール)
ローカライズ対象外ロケールを追加してすべてのローカライズ可能なフィールドを入力
元に戻すプロンプトごとにワンクリックフローのバックアップコピー、バージョン履歴、各保存前の確認
セットアップ不要Adapty プラグイン、および Adapty CLI または MCP サーバー

AIエディターは、すでにビルダーにいてその画面をリスタイルしたいときに使用します。自分の環境を離れずにフロー作業を進めたい場合はスキルを使用します。

スキルが行わないこと

スキルはあなたのフローをライブコンテンツとして扱います。公開済みのフローは実際のユーザーに配信されているためです。

  • 公開はあなたが行います: スキルは下書きの保存までで止まり、公開は行いません。公開はフロー & ペイウォールビルダーか adapty flows publish で行ってください。
  • 上書きには承認が必要です: 保存はコンフィグ全体を置き換えます。部分的な書き込みや下書きの取り消しはできません。承認時にはフロー名、ID、ステータス、スキルが編集前に取得したバックアップファイルが表示されます。
  • 復元は下書きのままです: スキルは過去のバージョンを下書きとして復元しますが、公開は行いません。下書きを置き換える前に確認を求めます。
  • 未保存の変更はあなたのものです: スキルが別のバージョンを開いたり復元したりする前に、未保存の変更を保存するか、破棄するか、現在のバージョンにとどまるかを確認します。
  • 同時編集が発生すると書き込みが失敗します: 最初の書き込み以降、コンフィグの updated_at タイムスタンプが Adapty に送り返されます。その間にチームメンバーがフローを保存していた場合、Adapty は相手の変更を上書きせずに書き込みを拒否します。
  • フローの削除はダッシュボードで行います: CLI に削除コマンドはないため、スキルが作成したフローはダッシュボードから削除するまで残ります。
  • 実際の数値とアセットはあなたが提供します: 評価、レビュー数、割引率、ストア価格はスキルが作成することはありません。パターン上必要な情報が提供されていない場合、スキルはそれを尋ねるか要素を省略し、どちらを行ったかを伝えます。
Note

読み取り、バリデーション、プレビューはいずれも無料で、何も変更しません。コンフィグの保存だけがダッシュボードに反映される操作であり、あなたの承認が必要です。

制限事項

実行には時間がかかります

スキルは変更を加えるたびにバリデーションと再レンダリングを行います。これにより壊れたコンフィグがダッシュボードに反映されるのを防げますが、チャットの返信よりも実行が遅くなります。小さな編集なら数分で完了します。分岐のある複数画面のフローの作成には 10〜40分 かかります。実行を開始したら、見守るのではなく一旦別の作業をして戻ってきましょう。

カスタムフォントは手動で設定が必要です

スキルはカスタムフォントファイルをアップロードしません。デザインで指定されたテキストスタイルを作成し、プレースホルダーのフォントを割り当てます。Flow & Paywall Builder でフォントをアップロードし、それらのスタイルに割り当ててください。

プレビューは1画面・1状態のみ表示される

スキルのプレビューページは1つの画面を描画するだけで、フローを順に表示することはできません。以下の内容はプレビューでは確認できません。実機でのテストが必要です。確認方法についてはフローのプレビューをご覧ください。

  • ナビゲーションと分岐: ナビゲーションアクションを持つボタンはプレビュー上でその場にとどまるため、条件分岐ルートは発火しません。各スクリーンは独立してレンダリングされます。
  • トグルと複数選択: トグル行と複数選択行は、デフォルト値に関わらずオフ状態で表示されます。単一選択行とプロダクトカードは選択状態が正しく反映されます。
  • 表示中のロケール以外のロケール: プレビューはフローのデフォルトロケールやロケールリストの順序を無視するため、翻訳を視覚的に確認することはできません。Flow & ペイウォールビルダーでロケールを切り替えて、テキストがコンテナからはみ出していないか確認してください。
  • 実行時に解決される要素: 実際の価格、ストアの通貨、ユーザー入力などは反映されません。価格の変数はリテラルのトークンとして表示されます。このトークンは実際の価格より長いため、固定ボタンの下にテキストが隠れることがありますが、実際の価格が解決されると重なりは消えます。
  • ページが認識できない画面サイズ: ビューポートの高さに依存するレイアウトは、画面の小さい端末で実際に確認する必要があります。

次のステップ