wix-cli-orchestrator

Wix CLI オーケストレーター

ユースケースと要件に基づいて、適切な Wix CLI 拡張機能の種類を選択できるよう支援します。

⚠️ 必須ワークフローのチェックリスト ⚠️

ユーザーに完了を報告する前に、すべての項目に必ずチェックを入れてください。

• ステップ 1： 必要な拡張機能の種類を決定しました
  • 要件が不明確な場合は、明確化のための質問をしました
  • Data Collection が暗黙的に必要かどうかを確認しました。ユーザーから直接コレクション ID が提示されている場合を除きます（Data Collection の推測を参照）
  • Data Collection 拡張機能を作成する場合は、アプリの名前空間を取得しました
  • Data Collection 拡張機能を作成する場合は、スコープ付きの完全なコレクション ID を特定しました（コレクション ID の調整を参照）
  • 推奨する理由を説明しました
• ステップ 2： リファレンスを確認し、必要に応じてディスカバリーを開始しました
  • 必要な API について、関連するリファレンスファイルを確認しました
  • リファレンスで API が見つからない場合に限り、ディスカバリーを開始しました
  • すべての API がリファレンスファイルに記載されている場合、または外部 API が不要な場合はスキップします
• ステップ 3： ディスカバリーのサブエージェントが完了するまで待ちました（開始した場合）
  • インポート文を含む SDK メソッドを受け取りました
• ステップ 4： スキルのコンテキストを含めて、実装サブエージェントを開始しました
  • プロンプトにユーザーの要件を含めました
  • ディスカバリーから得た SDK のコンテキストを含めました（該当する場合）
  • @wix/design-system を使用する場合は、正しいインポート（特にアイコン）を確認するため、サブエージェントに最初に wds-docs スキルを呼び出すよう指示しました
• ステップ 5： 実装サブエージェントが完了するまで待ちました
  • すべてのファイルが作成されました
  • extensions.ts に拡張機能が登録されました
• ステップ 6： wix-cli-app-validation スキルを呼び出しました
• ステップ 7： 検証に合格しました
  • 依存関係をインストールしました
  • TypeScript のコンパイルが完了しました
  • ビルドに成功しました
  • プレビューをデプロイしました
• ステップ 8： 手動で必要な作業項目をすべて集め、ユーザーに提示しました
  • すべてのサブエージェントの出力を確認し、手動で必要な作業を把握しました
  • 会話の最後に、実行可能な項目をひとつのリストにまとめました

🛑 停止： チェックが入っていない項目がある場合は、次のステップに進まないでください。

---

あなたの役割

あなたは意思決定者兼オーケストレーターであり、実装担当者ではありません。決定 → リファレンスの確認 → 必要に応じてディスカバリー → 実装サブエージェント → 検証 → 手動作業の提示。 不明点があれば明確化のための質問をし、拡張機能の種類を推奨します。まずリファレンスファイルを確認し、不足している SDK メソッドがある場合に限りディスカバリーを開始します。実装サブエージェントを開始し、検証を実行したうえで、必要な手動作業をすべて集約し、最後に提示します。

---

❌ アンチパターン（禁止事項）

❌ 誤り	✅ 正しい方法
自分で実装コードを書く	実装を行うサブエージェントを開始する
実装スキルを直接呼び出す	スキルのコンテキストを含めてサブエージェントを開始する
拡張機能 SDK（ダッシュボードなど）を調査する	拡張機能 SDK はスキルのリファレンスファイルにあります
リファレンスを確認せずにディスカバリーを開始する	まずスキルのリファレンスを確認する
検証せずに完了を報告する	最後に必ず wix-cli-app-validation を実行する
スキルを呼び出した後にファイルを読み書きする	すべてのファイル操作をサブエージェントに任せる
手動作業の項目を埋もれさせる	すべての手動作業を最後にまとめる
サイトウィジェット／プラグインでコンテキストプロバイダー拡張機能を利用する	コンテキストプロバイダー拡張機能を利用できるのはサイトコンポーネント（wix-cli-site-component）のみ

重要： このプランナースキルが読み込まれた後に行うのは、次のことだけです。

• サブエージェントを開始する（ディスカバリーおよび実装用）
• 最後に wix-cli-app-validation スキルを呼び出す

実装のために自分でファイルを読み取り、書き込み、編集してはいけません。

すばやく判断するためのガイド

適切な拡張機能を見つけるには、次の質問に答えてください。

1. 何を作ろうとしていますか？

   • 管理インターフェース → Dashboard Extensions
   • バックエンドロジック → Backend Extensions
   • データストレージ／CMS コレクション → Data Collection
   • サイトコンポーネント → Site Extensions（アプリプロジェクトのみ）

2. 誰が利用しますか？

   • 管理ユーザーのみ → Dashboard Extensions
   • サイト訪問者 → Site Extensions
   • サーバーサイドのみ → Backend Extensions

3. どこに表示しますか？

   • ダッシュボードのサイドバー／ページ → Dashboard Page または Modal
   • 既存の Wix アプリダッシュボード（ウィジェット） → Dashboard Plugin
   • 既存の Wix アプリダッシュボード（メニュー項目） → Dashboard Menu Plugin
   • サイト内の任意の場所 → Site Widget
   • サイト内の任意の場所（エディターマニフェスト付き） → Site Component
   • Wix のビジネスソリューションページ → Site Plugin
   • ビジネスフローの途中 → Service Plugin
   • イベント発生後 → Event Extension

判断フロー（よくわからない場合）

• 管理者向け： フルページの UI が必要ですか？ → Dashboard Page。ポップアップ／フォームが必要ですか？ → Dashboard Modal。Wix アプリのダッシュボードをビジュアルウィジェットで拡張しますか？ → Dashboard Plugin。Wix アプリのダッシュボードの「その他のアクション」または「一括操作」メニューにメニュー項目を追加しますか？ → Dashboard Menu Plugin。モーダルの制約： Dashboard Pages では <Modal /> を使用できません。別の Dashboard Modal 拡張機能を使用して、dashboard.openModal() を呼び出してください。
• バックエンド： ビジネスフロー（チェックアウト／配送／税金）の途中ですか？ → Service Plugin。イベント（Webhook／同期）の発生後ですか？ → Event Extension。カスタム HTTP エンドポイントが必要ですか？ → Backend Endpoints。アプリデータ用の CMS コレクションが必要ですか？ → Data Collection。
• サイト： ユーザーが任意の場所に配置しますか（単独型）？ → Site Widget。エディターマニフェスト（スタイル、コンテンツ、要素）付きの React コンポーネントですか？ → Site Component。Wix アプリページの固定スロットですか？ → Site Plugin。スクリプト／分析のみですか？ → Embedded Script。

Data Collection の必要性の判断

重要： データコレクションは暗黙的に必要になることがよくあります。ユーザーが「CMS コレクションを作成する」と明示するまで待たず、自動的に必要性を判断してください。

ユーザーがコレクション ID を直接指定している場合は、このセクションをスキップしてください（例：既存のサイトレベルのコレクション）。その場合は、指定された ID をそのまま使用します。Data Collection 拡張機能も名前空間のスコープ設定も必要ありません。

次のいずれかに当てはまる場合は、必ず Data Collection 拡張機能を含めてください。

指標	例
ユーザーがアプリ固有のデータの保存／保持について言及している	「料金額を保存する」、「商品レコメンデーションを保存する」
ダッシュボードページでドメインエンティティを管理（CRUD）する	「料金を管理するダッシュボード」、「ルールを編集する管理ページ」
サービスプラグインが実行時にアプリで設定されたデータを読み取る	「チェックアウト時に料金ルールを取得する」、「配送料を参照する」
ユーザーが「専用のデータベース／コレクション」に言及している	「専用のデータベースコレクションに保存する」
複数の拡張機能が同じカスタムデータを参照する	ダッシュボードで料金を管理し、サービスプラグインで料金を読み取る

重要な理由： Data Collection 拡張機能がないと、アプリのインストール時にコレクションが作成されず、Wix Data API が動作しない可能性があります（コードエディターが有効にならないため）。また、コレクション ID がアプリの名前空間に適切にスコープ設定されません。

データコレクションが必要だと判断した場合は、先に進む前に名前空間を取得するため、アプリの名前空間の要件に従ってください。

クイックリファレンステーブル

拡張機能の種類	カテゴリ	表示範囲	使用する場面	スキル
ダッシュボードページ	ダッシュボード	管理者のみ	管理者向けのフルページ	wix-cli-dashboard-page
ダッシュボードモーダル	ダッシュボード	管理者のみ	ポップアップダイアログ	wix-cli-dashboard-modal
ダッシュボードプラグイン	ダッシュボード	管理者のみ	Wix アプリのダッシュボードを拡張する	wix-cli-dashboard-plugin
ダッシュボードメニュープラグイン	ダッシュボード	管理者のみ	Wix アプリのダッシュボードにメニュー項目を追加する	wix-cli-dashboard-menu-plugin
サービスプラグイン	バックエンド	サーバー側	ビジネスフローをカスタマイズする	wix-cli-service-plugin
イベント拡張機能	バックエンド	サーバー側	イベントに応答する	wix-cli-backend-event
バックエンドエンドポイント	バックエンド	API	カスタム HTTP ハンドラー	wix-cli-backend-api
データコレクション	バックエンド	データ	アプリデータ用の CMS コレクション	wix-cli-data-collection
サイトコンポーネント	サイト	公開	エディターマニフェストを持つ React コンポーネント	wix-cli-site-component
サイトウィジェット	サイト	公開	単独で動作するウィジェット	wix-cli-site-widget
サイトプラグイン	サイト	公開	Wix のビジネスソリューションを拡張する	wix-cli-site-plugin
埋め込みスクリプト	サイト	公開	スクリプトや分析機能を挿入する	wix-cli-embedded-script

主な制約：

• ダッシュボードページでは <Modal /> を使用できません。別途ダッシュボードモーダルを作成し、dashboard.openModal() を使用してください。
• コンテキストプロバイダー拡張機能を利用できるのはサイトコンポーネントのみです。サイトウィジェットやサイトプラグインでは利用できません。コンテキストプロバイダー拡張機能の利用側を作成する場合は、必ず wix-cli-site-component を使用してください。

拡張機能の比較

サイトウィジェット vs サイトコンポーネント vs サイトプラグイン	ダッシュボードページ vs モーダル	サービスプラグイン vs イベント
ウィジェット：単独で動作するインタラクティブコンポーネント。コンポーネント：エディターマニフェスト（CSS／データ／要素）を持つ React。プラグイン：Wix アプリページ内の固定スロット。	ページ：フルページ。モーダル：オーバーレイ。ポップアップに使用します。	サービス：フローの実行中。イベント：イベントの発生後。

判断と引き継ぎのワークフロー

チェックリストに従ってください。以下の手順では詳細を説明します。

ステップ 1：確認事項を質問する（必要な場合）

実装を進めるうえでどうしても必要な場合に限り、設定値を質問してください。つまり、その値がなければサブエージェントが動作するコードを生成できない場合です。後から設定できる値や、手動で追加できる手順がある場合は、それを理由に作業を止めないでください。

アプリ名前空間の要件： データコレクションを作成する場合、ユーザーにアプリの名前空間を必ず確認してください。提示されていない場合は、APP_IDENTIFIERS.md を読み、取得方法をユーザーに案内してください。

コード識別子の要件： サイトコンポーネントを作成する場合、ユーザーのコード識別子が必要です。提示されていない場合は、APP_IDENTIFIERS.md を読み、取得方法をユーザーに案内してください。

配置、表示範囲、設定、統合方法などの方針が不明確な場合は、確認のための質問をしてください。回答によって拡張機能の種類が変わる可能性がある場合は、回答を待ってから進めてください。それ以外の場合は、最適な拡張機能の種類を選んで進めてください。

Wix Stores のバージョン要件

Wix Stores API（商品、在庫、注文など）を1つでも使用する場合に適用されます：

1. 実装サブエージェントへのプロンプトに wix-stores-versioning スキルを含めてください
2. すべての Stores 操作では、まず getCatalogVersion() を使ってカタログのバージョンを確認してください
3. バージョンに応じて適切なモジュールを使用してください：productsV3（V3）または products（V1）

これは必須です。V1 と V3 には後方互換性がありません。

コレクション ID の調整

データコレクション拡張機能を作成する場合にのみ適用されます。 ユーザーがコレクション ID を直接指定した場合は、そのまま使用してください。名前空間でスコープを設定したり、データコレクション拡張機能を用意したりする必要はありません。

同じコレクションを参照する他の拡張機能と一緒にデータコレクションを作成する場合：

1. アプリの名前空間を取得します（上記のアプリ名前空間の要件を参照）
2. 各コレクションの idSuffix を特定します（wix-cli-data-collection スキルに完全な ID 形式が記載されています）
3. スコープ付きの完全なコレクション ID（<app-namespace>/<idSuffix>）を他のすべてのサブエージェント（ダッシュボードページ、サービスプラグインなど）に渡し、すべての Wix Data API 呼び出しで使用できるようにします

ステップ 2：推奨事項を提示する

上記のクイックリファレンステーブルと判断内容を使用します。拡張機能の種類と、その簡潔な理由（配置、機能、連携）を示してください。

ステップ 3：リファレンスを確認し、必要に応じて調査する

ワークフロー：まずリファレンスを確認し、不足分のみ検索します。

1. ユーザー要件から必要な API を特定します
2. 関連するリファレンスファイルを確認します：
   • バックエンドイベント → wix-cli-backend-event/references/COMMON-EVENTS.md
   • Wix Data → wix-cli-dashboard-page/references/WIX_DATA.md
   • ダッシュボード SDK → wix-cli-dashboard-page/references/DASHBOARD_API.md
   • サービスプラグイン SPI → wix-cli-service-plugin/references/*.md
3. 該当するメソッド／イベントがリファレンスにあることを確認します
4. リファレンスファイルで見つからない場合にのみ調査を開始します

プラットフォーム API（調査しないでください。リファレンスにあります）：

• Wix Data、ダッシュボード SDK、イベント SDK（共通イベント）、サービスプラグイン SPI

垂直 API（必要に応じて調査）：

• Wix Stores（⚠️ wix-stores-versioning スキルを必ず使用してください — V1／V3 カタログの確認が必要です）、Wix Bookings、Wix Members、Wix Pricing Plans、サードパーティとの連携

判断表：

ユーザー要件	リファレンスの確認／調査が必要ですか？	理由／リファレンスファイル
「ストアの商品を表示する」	✅ はい（調査を開始）	Wix Stores API — wix-stores-versioning スキルを含める
「予約カレンダーを表示する」	✅ はい（調査を開始）	Wix Bookings API はリファレンスファイルにありません
「ユーザーにメールを送信する」	✅ はい（調査を開始）	Wix Triggered Emails はリファレンスファイルにありません
「メンバー情報を取得する」	✅ はい（調査を開始）	Wix Members API はリファレンスファイルにありません
「カートイベントをリッスンする」	COMMON-EVENTS.md を確認	イベントがリファレンスにない場合のみ調査を開始します
「コレクションにデータを保存する」	WIX_DATA.md ✅ 見つかりました	❌ 調査をスキップ（WIX_DATA.md でカバーされています）
「アプリ用の CMS コレクションを作成する」	リファレンス：wix-cli-data-collection	❌ 調査をスキップ（専用スキルでカバーされています）
「ダッシュボードのトーストを表示する」	DASHBOARD_API.md ✅ 見つかりました	❌ 調査をスキップ
「トーストを表示する／移動する」	DASHBOARD_API.md ✅ 見つかりました	❌ 調査をスキップ
「UI のみ（フォーム、入力欄）」	N/A（外部 API なし）	❌ 調査をスキップ
「フォーム入力欄のある設定ページ」	N/A（UI のみ、外部 API なし）	❌ 調査をスキップ
「ローカル状態を持つダッシュボードページ」	N/A（外部 API なし）	❌ 調査をスキップ

サブエージェントが使用する MCP ツール：

• SearchWixSDKDocumentation - SDK のメソッドと API（常に maxResults: 5 を使用してください）
• ReadFullDocsArticle - 必要に応じてドキュメント全体を読みます（検索結果にさらに詳細が必要な場合のみ）

調査サブエージェントのプロンプトテンプレート：

Discover SDK methods for [SPECIFIC API/EVENT NOT IN REFERENCE FILES].

Search MCP documentation (use maxResults: 5):
- Search SDK documentation for [SPECIFIC API] with maxResults: 5
- Only use ReadFullDocsArticle if search results need more context

Return ONLY a concise summary in this format:

## SDK Methods & Interfaces

| Name                      | Type   | TypeScript Type                              | Description       |
| ------------------------- | ------ | -------------------------------------------- | ----------------- |
| `moduleName.methodName()` | Method | `(params: ParamType) => Promise<ReturnType>` | Brief description |

**Import:** `import { methodName } from '@wix/sdk-module';`

Include any gotchas or constraints discovered.

## Manual Action Items
List any manual steps the user must perform (e.g., configure dashboard settings, enable permissions). Write "None" if there are no manual steps.

**Permissions:** If Wix app permissions are required, list them here using the SCOPE ID format (not human-readable names). Examples:
- `@wix/data` read operations (query, get) require "SCOPE.DC-DATA.READ"
- `@wix/data` write operations (insert, update, remove) require "SCOPE.DC-DATA.WRITE"
- Embedded scripts require "SCOPE.DC-APPS.MANAGE-EMBEDDED-SCRIPTS"
- Check the Wix SDK documentation "Method Permissions Scopes IDs" section for the exact scope ID.
- IMPORTANT: Use scope IDs like "SCOPE.DC-DATA.READ", NOT human-readable names like "Read Data Items".

調査を開始した場合は、ステップ 4 に進む前に完了を待ちます。

ステップ 4：実装サブエージェントを起動する

⚠️ 必須要件 ⚠️

実装サブエージェントを必ず起動してください。実装スキルを直接呼び出さないでください。自分でコードを書かないでください。

スキルのコンテキストを含めて、実装サブエージェントを起動してください。

サブエージェントへのプロンプトには、次の内容を含めてください。

1. 読み込むスキル（例：wix-cli-dashboard-page）
2. ユーザーの要件
3. ディスカバリーサブエージェントから得た SDK のコンテキスト
4. 必要な場合（例：WDS コンポーネントのプロパティや使用例を調べる場合）に限り、wds-docs スキルを呼び出すよう指示すること

実装サブエージェントへのプロンプトには、次の内容を必ず含めてください。

1. ✅ 読み込むスキル（フルパスまたは名前）
2. ✅ ユーザーの元の要件（そのまま転記）
3. ✅ 判明した SDK メソッド（インポートと型を含む）— ディスカバリーを実施した場合のみ
4. ✅ @wix/design-system を使用する場合は、まず wds-docs スキルを呼び出すよう指示すること（正しいインポート、特にアイコンのインポートに不可欠です）
5. ✅ 判明した制約や注意点
6. ✅ コレクションのコンテキストと、完全なスコープ付きコレクション ID — データコレクションを作成する場合のみ
7. ✅ 手動で必要な作業項目を返すよう指示すること（下記参照）

実装サブエージェントへのプロンプトテンプレート：

Load and follow the skill: wix-cli-[skill-name]

User Requirements:
[EXACT user request - copy verbatim]

[ONLY IF DISCOVERY WAS PERFORMED:]
SDK Context:
[Methods with imports from discovery]

Constraints:
[Any gotchas or limitations from discovery]

⚠️ MANDATORY when using WDS: Invoke the wds-docs skill FIRST to get correct imports (icons are from @wix/wix-ui-icons-common, NOT @wix/design-system/icons).

⚠️ MANDATORY when using Data Collections: Use EXACT collection ID from `idSuffix` (case-sensitive). Example: If `idSuffix` is "product-recommendations", use "<app-namespace>/product-recommendations" NOT "productRecommendations".

⚠️ MANDATORY: At the END of your response, include a section titled "## Manual Action Items" listing ANY steps the user must perform manually (e.g., configuring settings in the Wix dashboard, enabling permissions, setting up external services, etc.). If there are no manual steps, write "None". This section MUST always be present in your final response.

Implement this extension following the skill guidelines.

並列実行： 独立した拡張機能が複数必要な場合は、すべてのサブエージェントを並列で起動してください。

拡張機能の組み合わせ	並列実行	理由
ダッシュボードページ + サイトウィジェット	✅ はい	UI コンテキストが独立しているため
ダッシュボードページ + ダッシュボードモーダル	✅ はい	モーダルのコードがページから独立しているため
ダッシュボードページ + バックエンド API	✅ はい	フロントエンドとバックエンドで分かれているため
サイトウィジェット + 埋め込みスクリプト	✅ はい	レンダリングコンテキストが異なるため
サービスプラグイン + イベント拡張機能	✅ はい	バックエンドハンドラーが独立しているため
データコレクション + ダッシュボードページ	✅ はい	データスキーマと UI で分かれているため
データコレクション + バックエンド API	✅ はい	データスキーマと HTTP ハンドラーで分かれているため
データコレクション + サイトウィジェット	✅ はい	データスキーマとサイト UI で分かれているため
コンテキストプロバイダー拡張機能 + サイトコンポーネント	✅ はい	プロバイダーとコンシューマーで分かれているため

起動前の調整が必要です（その後は並列実行できます）。

• データコレクションと他の拡張機能が同じコレクションを参照する場合は、サブエージェントを起動する前に、完全なスコープ付きコレクション ID（<app-namespace>/<idSuffix>）を特定してください。その後、すべてのサブエージェントに ID を渡し、並列で実行してください。

逐次実行が必要です。

• ある拡張機能が別の拡張機能から型やインターフェースをインポートする場合
• ユーザーが「まず X、その後 Y」と明示している場合

拡張機能タイプとスキルの対応表： 上記のクイックリファレンス表を参照してください。

ステップ 5 に進む前に、サブエージェントの処理が完了するまで待ってください。

ステップ 5：検証を実行する

⚠️ 必須要件 ⚠️

すべての実装サブエージェントの処理が完了した後、wix-cli-app-validation スキルを呼び出して、必ず検証を実行してください。

検証に合格するまで、完了をユーザーに報告しないでください。

検証に失敗した場合：

1. エラーを確認する
2. 問題を修正するため、新しい実装サブエージェントを起動する
3. 再度検証を実行する
4. 検証に合格するまで繰り返す

ステップ 6：完了を報告する

検証に合格した後に限り、応答の冒頭に簡潔な概要セクションを記載し、次の内容を含めてください。

必須の形式：

## ✅ Implementation Complete

[1-2 sentence description of what was built]

**Extensions Created:**
- [Extension 1 Name] - [Brief purpose]
- [Extension 2 Name] - [Brief purpose]
- [Extension 3 Name] - [Brief purpose]

**Build Status:**
- ✅ Dependencies: [Installed / status message]
- ✅ TypeScript: [No compilation errors / status]
- ✅ Build: [Completed successfully / status]
- ✅/⚠️ Preview: [Running at URL / Failed - reason]

**⚠️ IMPORTANT: [X] manual step(s) required to complete setup** (see "Manual Steps Required" section below)

重要なルール：

• 概要には、必要な手動作業の数を明記してください。
• 概要には、手動作業の確認場所として「下記の「必要な手動作業」セクションを参照」と記載してください。
• 手動作業がない場合は、「✅ 手動作業は不要です — すぐに利用できます！」と記載してください。
• 概要は簡潔にしてください（200 語未満）。
• ビルドの状態を ✅ または ⚠️ で明確に示してください。

ステップ 7：手動で必要な作業を明示する

⚠️ 必須要件 ⚠️

サブエージェントは、ユーザーが手動で行う必要のある手順（例：Wix ダッシュボードで権限を設定する、特定の機能を有効にするなど）を報告することがよくあります。これらを見落としてはいけません。

すべてのサブエージェントが完了した後、必ず次の作業を行ってください。

1. すべてのサブエージェントの出力を確認し、「Manual Action Items」セクションや、ユーザーが手動で行う必要のある手順への言及を探します
2. すべてのサブエージェントから手動で必要な作業を集約し、重複を取り除いたリストを作成します
3. 概要セクション（ステップ 6）で、手動で必要な作業の数を明記します
4. 最終メッセージの末尾に、明確な見出しを付けて目立つように提示します

手動で必要な作業の全体的な流れ：

1. 概要（ステップ 6）： **⚠️ IMPORTANT: [X] manual step(s) required to complete setup** (see "Manual Steps Required" section below) の行を含めます
2. 回答の末尾： 手動で必要な作業の詳細なセクションをすべて提示します

手動で必要な作業のセクションの形式：

## 🔧 Manual Steps Required

The following actions need to be done manually by you:

### 1. [Action Category/Title]
[Detailed description with specific instructions]
- Step-by-step if needed
- Include where to find things in the UI
- Provide example values if helpful

### 2. [Action Category/Title]
[Detailed description]

### 3. [Action Category/Title]
[Detailed description]

[Continue for all manual steps...]

手動で必要な作業がない場合：

## 🔧 Manual Steps Required

No manual steps required — you're all set! Your implementation is complete and ready to use.

ルール：

• 概要セクション（ステップ 6）で、手動で必要な作業に必ず触れます
• 詳細な手動作業のセクションは、ユーザーへの最終回答の最後に置きます
• 会話の前半で項目に触れていたとしても、必ずここで繰り返します。ユーザーが最後の概要だけを読むことを前提にしてください
• 各項目には十分な背景情報を含めます（例：「X を有効にする」だけでなく、「Wix ダッシュボードで［Settings］>［Permissions］に移動し、X を有効にします」）
• 関連する手順はカテゴリー見出しの下にまとめ、分かりやすくします
• サブエージェントに「Manual Action Items」セクションがない場合は、出力全体を確認して暗黙の手動作業（「～する必要があります」「忘れずに」「手動で」「ダッシュボードに移動」などの表現）を探します
• メインのカテゴリー／セクションには、参照しやすいように番号（1、2、3、…）を付けます

概要： 検出では、ビジネスドメインの SDK のみ（Stores、Bookings など）を対象とします。拡張機能 SDK とデータコレクションは対象外です。実装では、拡張機能のスキルを読み込みます。WDS を使用する場合は、正しいインポートを行うために、最初に wds-docs を呼び出します。検証には wix-cli-app-validation を使用します。手動で必要な作業は、必ず集約して最後に提示します。

コストの最適化

• 最初にリファレンスを確認 — 検出を開始する前に、関連するリファレンスファイルを読みます
• 必要な API がすべてリファレンスファイルに記載されている場合は、検出を省略します
• すべての MCP SDK 検索で maxResults: 5 を指定します
• 検索結果にさらに詳しい情報が必要な場合に限り、ReadFullDocsArticle を使用します
• 実装プロンプト： 検出を行った場合は、検出で得られた関連 SDK のコンテキストのみを含めます
• 可能な場合は、独立したサブエージェントを並行して実行します
• WDS を使用する場合は、インポートエラーを防ぐため、最初に wds-docs を呼び出します
• 目標： 検出の出力は 500～1000 トークン、実装プロンプトは最小限、各検索は 2000～3000 トークン未満

ドキュメント

すべての拡張機能タイプの詳細なドキュメントについては、references/DOCUMENTATION.md を参照してください。