mcpField
R
run-featured-workflow

run-featured-workflow

github.com/adobeマーケティング・グロース316123 回インストール今日更新
リポジトリ

run-featured-workflow について

run-workflow MCP を通じて、事前定義されたマーケティングや制作のワークフローを実行するスキルです。検索、入力処理、実行、結果確認を支援し、独自の処理は別の経路に案内します。

主な機能

  1. 01名前付きワークフローの検索
  2. 02画像・フォント・CSV入力の振り分け
  3. 03既定およびカスタム InDesign テンプレート対応
  4. 04ジョブの送信と結果確認
  5. 05障害診断の案内

活用シーン

  1. 01CSVデータから商品バナーを作成
  2. 02リターゲティングやローカライズの実行
  3. 03カタログ、パッケージ、商品画像の制作

MCP 対応

run-workflow MCP のツールでワークフローの検索・送信・監視を行い、素材のアップロード、テンプレート確認、障害診断にも対応します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/adobe/skills --skill run-featured-workflow

インストール後、Claude Code で/run-featured-workflowを入力して読み込まれたか確認します。

詳細

注目のワークフロー（run-workflow MCP）

MCP サーバーに同梱された、マーケティングおよび制作向けの既成ワークフローを実行します。get_featured_workflow で一致するものが見つかった場合は、ゼロから組み立てないでください。

使用する場面

ユーザーが次の内容を求めた場合に使用します：

  • 注目のワークフロー名を挙げている場合：リターゲティング、ローカライズ、バナー広告、パッケージ、複数の商品バナーの一括作成、カタログ、パックショット、スピン動画など
  • 名前またはキーワードを指定して、「既知の」または「事前定義された」ワークフローの実行を求めている場合
  • デフォルト設定でのバナー／データマージのワークフロー用に、商品画像とフォントを提供している場合

次の場合は使用しないでください：

  • 名前が一致するものがなく、カスタムワークフローを希望している場合 — run-workflow を使って compose_workflow を呼び出します
  • バッチ／実行／ワークフロー ID のみを貼り付けている場合 — run-workflow スキル経由で inspect_run を使います

ツールの振り分け

手順ツール
事前定義されたワークフローを検索get_featured_workflow
画像、フォント、カスタムテンプレート、CSV データをアップロードupload_asset
カスタム .indd からマージタグを抽出get_indesign_tags
送信（大規模／複数バナー）run_workflow_submit
進行状況と出力を確認run_workflow_get_status（常に includeOutputs: true）
タグの差分後にグラフを再接続compose_workflow（カスタムテンプレートのみ）
失敗を診断inspect_run

検索フロー

  1. get_featured_workflow({ query: "<keyword>" }) を呼び出します。
  2. 複数の一致候補がある場合 — prepared はありません。一致した名前を一覧表示してユーザーに選択してもらい、正確な名前で再試行します。
  3. 一致候補が1つの場合 — mergeNodes、必須の入力、サイズを提示します。ユーザーに確認します。
  4. 指定がない場合は、テンプレート（デフォルトまたはカスタム .indd）について確認します。
  5. ユーザーが .otf／.ttf ファイルを持っている場合は、フォントについて確認し、upload_asset でアップロードします。
  6. ユーザーが .csv（product-banners-at-scale などのデータマージワークフロー用）を提供した場合は、アップロードして input-files ノード（prepared.inputNodes 内の type: "file"）に接続します。詳しくは、以下の「データ／CSV 入力」を参照してください。

**アセットの種類ごとに、接続先の入力ノードが異なります：**画像 → input-images、フォント → defaults.fonts、CSV／データ → input-files（parse-data に入力）。これらを1つのノードにまとめないでください。

近道（デフォルト設定）

デフォルトのテンプレートとデフォルトのテキストを使いたい場合：

  1. upload_asset で商品画像とフォントをアップロードします。
  2. run_workflow_submit を呼び出します。
{
  "session_id": "<prepared.session_id>",
  "useSessionDefaults": true,
  "defaults": {
    "fonts": [{ "presignedUrl": "...", "name": "Font.otf", "storageType": "azure" }]
  },
  "inputs": [
    {
      "node_id": "<input-images id from prepared.inputNodes>",
      "content": [{ "type": "image", "url": "..." }]
    }
  ]
}
  • compose_workflow は呼び出さないでください。
  • session_id がある場合は、actions／connections を送信しないでください。
  • すべての画像を1つの content 配列に含めてください — 送信呼び出しは1回です。

データ／CSV 入力

一部の注目ワークフロー（例：product-banners-at-scale）には CSV の分岐があります：input-files → parse-data → merge-data。prepared.inputNodes には type: "file" の CSV ノードが表示され、prepared.inputs にはワークフローに組み込まれたサンプル CSVがインラインコンテンツとして含まれます。

  • **デフォルトのみ（ユーザー提供の CSV なし）：**そのまま送信します — 組み込みのサンプル CSV が流れるため、input-files のエントリは不要です。
  • ユーザー提供の CSV：upload_asset でアップロードしてから、組み込みのデフォルトを上書きするため、input-files ノード ID を指定した inputs[] エントリを追加します。
{
  "node_id": "<input-files id from prepared.inputNodes>",
  "content": [{ "url": "<uploaded csv url>", "mimeType": "text/csv" }]
}

CSV の列によって parse-data の分岐が決まります（例：headline、subcopy、CTA）。これらを個別のテキスト入力として別途接続しないでください。すべての行で共通する商品画像（行ごとの CSV 列ではないもの）は、input-images から merge-data に直接接続し、parse-data を完全に迂回します。これは優先されるデフォルト設定です。画像が行ごとに実際に変わる場合に限り、parse-data のメディア上書きポートを経由させてください。

カスタムテンプレートのパス

ユーザーからカスタムの .indd テンプレートが提供された場合：

  1. 各テンプレートで get_indesign_tags を実行します。
  2. prepared.mergeNodes[].tags と比較します：
    • 同一 → テンプレート URL のみを差し替え、compose はスキップします。
    • 異なる → 実現可能性を確認してから、必要に応じて compose_workflow を再配線します。
  3. 重要な画像タグが削除されている場合（リターゲティングでの background など）は処理を停止し、デフォルト、別のテンプレート、または一からの作成を提案します。
  4. 更新したグラフを視覚的に表示します。不足しているマージデータ入力のみを尋ねます。
  5. すべての値をユーザーが確認してから送信します。

マージデータとシーンのプロンプト： ユーザー向けのテキスト／画像入力が必要なのは、InDesign のマージポートタグのみです。ユーザーから変更の依頼がない限り、gen-object-composite のシーンプロンプトはデフォルトのままにします。

ポーリングと出力

run_workflow_submit の後、includeOutputs: true を指定して run_workflow_get_status を約 5 秒ごとにポーリングします。

  • 進行状況を Running — N/M complete (X%) · Ns elapsed の形式で報告します。elapsedSeconds はレスポンスの値を使用します。
  • 完了時：すべての出力について、完全な署名付き URL をそのまま列挙します。省略してはいけません。
  • 失敗時：inspect_run を実行して要約し、停止します。自動で再試行してはいけません。

代表的なワークフロー

スラッグ／キーワードユースケース
product-banners-at-scaleCSV（データマージ）から商品バナーを作成。テンプレート 1 つ＋固定画像、行ごとのコピー
retargetingリターゲティング広告
localizationローカライズ
generic-banner-advertising汎用バナー
contextual-or-native-advertisingネイティブ広告
catalogs-and-circularsカタログ
promotional-pricing-or-discounting価格プロモーション
packaging-variants-2dパッケージ
standardized-packshots-2d / 3d商品写真
refreshed-product-imagery-2d商品画像の更新
composite-imagery-3d3D 合成画像
3d-spin-video360 度回転動画

アンチパターン

  • 代表的なワークフローが存在し、タグも一致しているのに compose_workflow を呼び出す
  • session_id が利用可能なのに、グラフ全体の JSON を送信する
  • 各マージデータ入力に fonts を繰り返し指定する — defaults.fonts を使用する
  • useSessionDefaults: true で十分なのに、すべての入力項目を送信する
  • 画像ごとに個別に送信する
  • 不足しているマージデータのテキストフィールドについて、ユーザーの確認を省略する

参考資料

  • run-workflow スキルの全文（アセット入力、公開／保存、アラートの RCA）：run-workflow/SKILL.md

コメント

Markdown 対応