wix-replatform

wix-replatform

wix-replatform は、中断後に再開できるソースから Wix への移行を管理するコンパクトなスーパーバイザーです。現在のステージに対応する内部モジュールを 1 つ選択します。すべてのステージの手順を自身のコンテキストに保持することはありません。

常に有効な契約

• 何かを調査または作成する前に、アクティブなプロジェクトを migrations/<project>/（または REPLATFORM_MIGRATIONS_DIR）で特定します。権威ある成果物は、そのプロジェクトのものだけです。
• 実行のたびに、最初に resources/rp-telemetry/ を開始または再開し、終端状態で確定します。テレメトリーイベントを手書きしてはいけません。
• 再開の基準には、オーケストレーション JSON と検証済みステージ成果物を使用します。ログとチャット履歴は診断用のコンテキストに限ります。
• ユーザーデータを保護します。冪等に書き込み、ソースの識別情報に基づいて重複を排除し、再開して最初からやり直さず、移行のために移行先サイトを 2 つ作成してはいけません。
• シークレット、シークレットを含む設定内容、トークン、認証情報を出力してはいけません。キー名と、値が設定済み／空／未設定のいずれかのみを報告します。
• 説明文や単一の成果物を根拠に移行完了を宣言してはいけません。終端での完了判定は、決定論的ルーターと集約完了成果物が担います。

パイプライン

intake → destination → source inputs → preflight → (standard: discovery → mapping → codegen;
quick: adapter preflight → quick plan) → setup discovery → website handoff
→ safety review/approval → setup → import
→ storefront continuation (website only) → aggregate finalization

デリバリーモードは management（バックエンドのみ）、website（フロントエンドのみ）、management_and_website（上記の統合フロー）です。ユーザー入力の both は management_and_website として受け入れ、正規の値を保存します。

deliveryMode=management では、バックエンドのインポート記録が有効であることが集約確定の要件です。deliveryMode=management_and_website では、それに加えて、スクリーンショットレビューが完了し、未解決の重大／高優先度ギャップがなく、リリースの証跡がある最新の website/completion.json が必要です。execution/completion-report.json はバックエンドの記録であり、それ単独ではウェブサイト移行の完了を意味しません。

実行前にルートを確認する

新規または再開したターンでは、必ず次の手順に従います。

1. プロジェクトを特定し、そのオーケストレーション成果物を初期化または読み込みます。
2. node skills/wix-replatform/scripts/orchestration-route.js <projectDir> を実行します。
3. ルートが返した nextResource だけを読み込み、そのリソースが必須の出力または永続的なブロッカーを書き出すまで、そのリソースに従います。
4. 各ステージの境界を越えたら、再度ルートを確認します。次のステージを記憶から判断してはいけません。

成果物が不正な形式、不完全、古い、またはバリデーターに不合格の場合は、生成元のステージを未完了として扱い、生成元にルーティングします。置き換え用の成果物を並行して作成してはいけません。

必要に応じて読み込むモジュール一覧

ルーターの状況	読み込むリソース
プロジェクト、デリバリーモード、ソースモード、またはグループ化されたインテークが未解決	resources/rp-project-intake/
移行先がない、競合している、または作成／引き継ぎが必要	resources/rp-destination/
ソース URL／ファイル／設定／取得モード／認証情報が必要	resources/rp-source-inputs/
決定論的なプリフライトがない、またはブロックされている	resources/rp-preflight/
クイックモードでプラットフォームの解決、エンドポイントのプリフライト、計画、抽出、またはインポートが必要	選択された resources/rp-quick-<platform>/
ソーススキーマがない	resources/rp-discovery/ と、選択されたソースアダプター
マッピングがない、またはレビューが必要	resources/rp-mapper/
Wix の要件がない	resources/rp-setup-discovery/
インポートコード／レビューがない、または古い	resources/rp-import-codegen/
セットアップ検証がない	resources/rp-execute-setup/
バックエンド完了レポートがない	resources/rp-execute-import/
フロントエンドのみの作業、または統合ウェブサイトの引き継ぎ／構築／ギャップ解消ループ／リリース受領証が未完了	resources/rp-website-continuation/
集約完了がない	resources/rp-execution-policy/

ルートが指定するリソースが、そのステージの完全な契約です。関連のないステージで、ソースファイル、シークレット、スキャフォールディング、ストアフロントの手順を読み込んではいけません。

インタラクションポリシー

通常モードでは、不足している必須入力、真に曖昧な進行中プロジェクト、または必須の書き込み承認についてのみ質問します。モジュールで別途指定されていない限り、質問は一度に1つにしてください。

書き込みの前に、必須の実行計画承認ゲートを維持してください。読み取り専用の調査、マッピング、セットアップの検証、コード生成、レビューは、その前に行います。

クイック管理インポートモード

managementImportMode=quick の場合、決定論的なソースプローブによって互換性のあるプラットフォームが特定された後にのみ、プラットフォームアダプターを選択してください。クイックモードは、公開データを対象とする範囲限定のインポートです。アダプターのバージョン管理された quick-mode.json が、ソースルート、エンティティグラフ、フィールドマトリックス、除外項目を定義します。クイックバックエンド分岐では、エージェントによる調査、マッピング、プロジェクト固有のコード生成を実行しないでください。引き続き、移行先のセットアップ、アプリケーションのインストール、Catalog-V3 と通知の安全性チェック、実行承認、共有書き込みランタイム、クロスウォーク、完了状況の記録を行ってください。適格なアダプターがない場合は、未サポートモードの結果を保存し、標準モードを選択するようユーザーに尋ねてください。暗黙にフォールバックしてはいけません。

停止するのは、必須入力が不足または無効な場合、API のない手動操作が必要な場合、またはシステム障害やデータ損失のリスクがある場合に限ります。停止する場合は、コード、証拠、担当者、正確な解除アクションを保存してください。暗黙に処理を停止してはいけません。

1クリックモード

ユーザーから明示的に要求された場合は、automationMode=one_click を source=user とともに記録し、次の手順を適用してください。モードが未設定の場合、または one_click の値が deterministic_inference／prior_artifact として記録されている場合は通常の対話モードであり、チェックポイントを省略してはいけません。

• 不足しているすべてのインテーク値をまとめて一度に収集し、その後は通常の承認のために一時停止しないでください。
• マッピング承認と実行承認を approved、decidedBy=agent として記録してください。状態を記録せずに一時停止を省略することは無効です。
• CSV／ファイルのみの実行では、必要なサンプルプレビューをエージェントとして検証し、承認してください。ユーザーが明示的にワンクリックを指定していない場合は、通常のマッピングレビュー、サンプルプレビューの検証、実行承認のために一時停止してください。
• 新しい分離サイトをデフォルトとします。ただし、既存の移行先が明示的に指定されているか、すでに固定されている場合を除きます。検出されたルートファミリーに基づいて、ウェブサイトのスコープを決定論的に選択してください。
• PATH／ツール解決の失敗は、オペレーターの互換性のある対話型ログインシェルで再試行してください。必要なブラウザー／ネットワークサンドボックスの権限昇格を要求し、ブロックと判断する前に再試行してください。
• 停止する前に、明らかな復旧手段を再試行してください。PATH／ツールの失敗ではまず適切なシェルを使用し、次にサンドボックス化されたブラウザーまたはネットワーク／API の失敗には必要な権限昇格を伴う再試行を行ってください。
• 選択された成果物を最後まで作成してください。management_and_website モードでは、フロントエンドのビルド、ビルド後のギャップ分析、範囲を限定した修正ループ、リリースレシートが含まれます。インテーク時にユーザーがフェイスリフトを選択した場合は、クローン後の個別のフェイスリフトレビューも含まれます。
• 引き渡す前に、再度ルーティングしてください。1クリック実行が completed となるのは completion/migration-completion.json がある場合のみで、blocked となるのは型付きの永続的なブロッカーがある場合のみです。

PATH またはツール解決の失敗から復旧する際は、オペレーターの互換性のあるローカル Node／Yarn シェルを使用してください。マシン固有のシェルパスは、ローカルの Git 除外対象エージェント指示にのみ記載してください。

リポジトリ内の対話型シェル契約： 初回試行時の PATH／ツール解決の失敗は、オペレーターの Node／Yarn プロファイルを読み込まない、通常の非対話型シェルでコマンドが実行されたことを意味する場合があります。ローカル環境または Git 除外対象のエージェント指示から、オペレーターと互換性のあるログインシェルを特定し、実行可能であることを確認してから、同じコマンドをそのシェル経由の対話型ログインモードで再試行し、node／yarn／npx を解決するプロファイルが読み込まれるようにしてください。この公開スキルにマシン固有のシェルパスをハードコードしてはいけません。互換性のあるシェルでの再試行自体が失敗した場合に限り、永続的なブロッカーへエスカレーションしてください。

ガードレール

• ステージを完了したように見せるために、バリデーター、承認状態の更新、確認済み通知のミュート、または Catalog-V3 ゲートを決して迂回しないでください。
• website はフロントエンドのみを意味します。management_and_website は、バックエンドとフロントエンドを統合した移行を意味します。統合移行の移行先をフロントエンドスキルに渡したり、そのモードで 2 つ目のフロントエンドサイトを作成したりしないでください。
• wix-headless-replatform が利用できない場合、ストアフロントを手動で実装しないでください。必要なランタイム機能を正確に示したブロッカーを記録してください。
• management モードでは、セットアップの調査後に website/handoff.* も生成し、後からストアフロントを開始する際にバックエンドの調査を繰り返さずに済むようにしてください。