はじめに
- Shopify AI Toolkitに新しいスキルが追加されているか気になっている
- マーチャント向けのオンボーディングスキルが何をするのか知りたい
- AIエージェントを「店員」のように動かすためのプロンプト設計を見てみたい
このような方のための記事です。
2026年4月にShopify AI Toolkitがリリースされ、自分もShopify AI Toolkitの16スキルを全解説 ― SKILL.mdに書かれた指示書の中身を読むで全スキルの中身を解説しました。しかし、その後リポジトリに3つのスキルが追加されています。
今回はその追加された3スキルを紹介しつつ、特に注目したいshopify-onboarding-merchantの設計から見えてくるShopifyのAI戦略について解説します。
追加された3スキルの概要
前回記事の執筆時点では16スキルでしたが、現在は19スキルに増えています。追加されたのは以下の3つです。
スキル名 | 役割 |
|---|---|
shopify-app-store-review | App Store提出前のコードベース自動コンプライアンスチェック |
shopify-onboarding-dev | 開発者の初期セットアップとスキルルーティング |
shopify-onboarding-merchant | マーチャント向けのストア接続・運営・他プラットフォームからの移行 |
このうち、特にshopify-onboarding-merchantはShopifyがAI Toolkitをどう拡張していくつもりなのかを示す重要なスキルです。順番に見ていきましょう。
shopify-app-store-review ― App Store提出前のセルフチェック
開発したアプリをShopify App Storeに提出する前に、コードベース全体をスキャンして審査要件への準拠状況を判定するスキルです。
判定は3段階に分かれます。
- 準拠の証拠が見つかった場合は「Likely passing」
- 違反が明確に見つかった場合は「Likely failing」
- コードだけでは判定できない場合は「Needs review」
設計で特に重要なのが「迷ったら必ずNeeds reviewに倒す」というルールです。
SKILL.md内には「サイレントパスを防ぐため、確信が持てない場合はNeeds reviewにする」と明記されています。
AIが要件を勝手に「OKだろう」と判断して見落としを生むことを防ぐ仕組みです。
チェックされる要件は約30項目で、内訳はおおまかに分類するとセッショントークン認証・OAuth実装・Shopify Billing API利用・禁止パターン（外部チェックアウト・マーケットプレイス化・キャピタル提供等）・スコープの正当性（read_all_orders / write_payment_mandate等）・UI/UX関連（Max modal・admin extension内の宣伝禁止）になります。
実際にアプリを開発・申請してApp Storeに公開した経験から言うと、審査で指摘されるポイントの多くはこのスキルでカバーされています。
提出前にClaude Codeで一度流すだけで、リジェクト要因を事前に潰せる仕組みです。
ただし、レポートの末尾には「Shopifyはここでチェックされる項目以外もレビューする」と明記されているため、このスキルだけで審査通過を保証するものではない点には注意してください。
shopify-onboarding-dev ― 開発者の起点を整えるルータースキル
「Shopifyで開発を始めたい」と言われたときの初期セットアップを完全自動化するスキルです。
やっていることは大きく3ステップに分かれます。
最初に、AIアシスタントが動いているクライアント（Claude Code / Cursor / VSCode / Gemini CLI）を環境変数から自動判定します。
次に、Shopify CLIがインストール済みかを確認し、未インストールならnpm install -g @shopify/cli@latestまたはHomebrewでインストールします。
続けて、検出したクライアントに対応するAI Toolkitプラグインをインストールします。
最後に「アプリを作りますか？テーマを作りますか？」と質問し、開発者の答えに応じてshopify-adminやshopify-liquidなど該当するスキルへ処理を引き継ぎます。
つまりこのスキルは、19スキル全体への入り口として機能するルーターです。
SKILL.md内のルールには「インストールコマンドを構築・改変するな。このファイルに定義されたコマンドだけを使え」と書かれており、AIが勝手にコマンドを組み立てて事故を起こすことを防いでいます。
また、開発者用スキルなので、もしマーチャント向けの質問（既存ストアの商品管理など）が来た場合はshopify.com/SKILL.mdの方に誘導するという明確な分業が設計されています。この「開発者向けとマーチャント向けの分離」は、次に紹介するスキルでさらに鮮明になります。
shopify-onboarding-merchant ― マーチャント向けのフルスタック設計図
3スキルの中で最も重要なのがこのスキルです。
冒頭の指示文がそのまま、Shopifyの設計思想を示しています。
You are a store assistant helping a merchant run their business. Assume no technical knowledge. Never surface developer concepts (APIs, mutations, OAuth scopes, GraphQL) in conversation.
訳すと「あなたはマーチャントのビジネスを助ける店員アシスタントです。技術知識がないことを前提とし、API・mutation・OAuthスコープ・GraphQLといった開発者向けの概念を会話に出してはいけない」という指示です。
つまりこれは、AIエージェントを技術用語を使わない「店員」として振る舞わせるためのプロンプト設計のリファレンス実装になっています。
shopify.com/SKILL.md からのリモート配信モデル
GitHubに置かれているSKILL.mdファイル本体には、ほとんど中身が書かれていません。代わりに「https://www.shopify.com/SKILL.mdから完全な指示書をフェッチして、そこに書かれた手順を実行せよ」と書かれています。
これは新しい配信戦略です。GitHub経由のスキルはバージョン管理されており、リポジトリを更新するまで内容が変わりません。一方でshopify.com/SKILL.mdを介したリモート配信であれば、Shopify側のサーバーで指示書を更新するだけで、すべてのAIエージェントに即座に新しい内容が反映されます。
開発者向けスキル（shopify.dev/skill.md）とマーチャント向けスキル（shopify.com/SKILL.md）でドメインも完全に分離しています。Shopifyが両者を別の運用ラインで管理していくつもりであることが伺えます。
8オプションメニューによるUX設計
ストア認証が完了すると、AIアシスタントは以下の8オプションをマーチャントに提示します。
- 商品の追加・管理
- 在庫の確認・更新
- 注文の閲覧・管理
- 顧客情報の閲覧
- 割引・下書き注文の作成
- ストアの見た目のカスタマイズ
- 売上レポートの閲覧
- 他プラットフォームからの商品移行
各オプションを選ぶと、コンテキストの説明と2つのサンプルプロンプト（例：「Summer Teeという商品を$29.99で、サイズS/M/Lで追加して」）が提示される設計です。マーチャントが「何ができるのか」を考えなくても、提示された選択肢から動き出せるようになっています。
10プラットフォームからの移行を全自動化
8番目の「他プラットフォームからの商品移行」が特に大きな機能です。対応プラットフォームは10個。
プラットフォーム | 補足 |
|---|---|
Square | アーカイブ済み・単位価格商品はスキップ |
WooCommerce | 外部・アフィリエイト商品はスキップ |
Etsy | 在庫数はバリアント単位で出力されないため手動設定 |
Wix | 在庫情報なし |
Amazon | 親なしバリアントはスキップ |
eBay | オークション形式の商品はスキップ |
Clover | 隠し商品・変動価格商品はスキップ |
Lightspeed R-Series | — |
Lightspeed X-Series | — |
Google Merchant Center | 在庫数は availability シグナルから推定 |
移行のフローはこうなります。マーチャントが「Squareから移行したい」と言うとAIアシスタントがSquareの管理画面のエクスポート手順を案内します。
マーチャントがCSVをアップロードするとAIが自分でCSVを読み込んで検証します（「You perform the validation by reading the CSV」と明記）。
検証結果を「商品○件をインポート、○件スキップ、○件警告」とプレビューで提示し、マーチャントの確認後にproductSetミューテーションでドラフト作成を実行します。
最後に在庫をinventorySetOnHandQuantitiesで設定し、残作業のチェックリストを提示して完了です。
これまでShopifyへの他プラットフォームからの移行は、Cart2CartやLitExtensionといった有料の移行サービス（数万円〜十数万円規模）が市場を持っていた領域です。Shopify自身がそれをAI Toolkitに無料機能として組み込んだことになります。
実際に移行してみた結果はこちらにまとめています
参考記事参照記事が見つかりません: /blog/shopify-ai-toolkit-woocommerce-migration-test
細部の運用配慮
実装の細部にも、事故防止のための配慮が入っています。
すべての商品はstatus: "DRAFT"で作成されます。
インポート直後にライブストアフロントに公開されないため、マーチャントが内容を確認してからActiveに切り替える運用になります。在庫設定のinventorySetOnHandQuantitiesミューテーションには@idempotent(key: "...")ディレクティブを必須にしており、再実行による重複設定を防いでいます。
シェルエスケープの問題にも対応しています。マーチャントの商品データはタイトルや説明文にシングルクォートやダブルクォートを含むことが多いため、変数JSONを直接コマンドラインに渡さず、一時ファイルに書き出してから読み込ませる方式を採用しています。
これらは実際の本番運用で遭遇する事故パターンを想定して設計された対策です。
このスキルが示すShopifyのAI戦略
3スキル、特にshopify-onboarding-merchantを読むと、ShopifyのAIに対する戦略が見えてきます。
ひとつは開発者向けとマーチャント向けの完全分離です。開発者向けスキルはshopify.devドメインで運用され、マーチャント向けスキルはshopify.comドメインで運用されます。AIへの指示書もそれぞれ別ドメインから配信されることで、それぞれのユーザー層に最適化された情報を届けられる仕組みです。
ふたつめはGitHub配信とドメイン配信の使い分けです。開発者向けスキルはGitHubリポジトリに置かれてバージョン管理されますが、マーチャント向けの本体はshopify.com/SKILL.mdからリモートフェッチされます。これは、頻繁に更新されるマーチャント向けの運用ノウハウを、Shopify側で柔軟に管理するための仕組みです。
みっつめは移行ベンダー領域への参入です。他プラットフォームからの移行は、これまでサードパーティの有料サービスが提供していた領域でした。Shopifyがこれを自社のAI Toolkitに無料機能として組み込んだことで、Shopifyへの移行のハードルは大きく下がります。
さいごに
Shopify AI Toolkitは、リリース直後の16スキルから現時点で19スキルに増えています。
今後もマーチャント向け・開発者向け両方の機能が継続的に追加されていくと予想できます。
特にshopify-onboarding-merchantは、AIエージェントを「店員」として振る舞わせるためのプロンプト設計のリファレンスとしても価値があります。
Shopifyの開発に関わっていない方でも、SaaSのオンボーディングフローをAIに任せたいケースなど、設計の参考にできる部分は多いはずです。
前回記事で解説した16スキルとあわせて読むと、Shopifyのエコシステム全体がAIエージェントを前提に再構築されつつあることがわかります。
ご希望に合わせたShopify構築・カスタムアプリ開発については、お問い合わせからお気軽にご相談ください。