wix-headless-replatform

wix-headless-replatform

役割

ソースサイトをもとに、十分に近く、視覚的に洗練された Wix Headless フロントエンドを構築します。 実装範囲は解決済みのホームページ 1 ページで、デフォルトの出力先は ホスト名から導出される projects/<project-name> です。Wix CLI Headless、Astro、 TypeScript、Tailwind を使用し、複雑なインタラクティブアイランドに限って React を使用します。 後続の承認済みワークフローでページ解決とルート間の共有エビデンスが定義されるまでは、 追加ページや明示的な URL を対象範囲に含める依頼は、実行可能な説明を添えてお断りします。

このエントリースキルはスーパーバイザーです。次のワークフローステージを決定し、そのステージの リソースのみを読み込みます。すべてのリソースやリファレンスを事前に読み込まないでください。 ステージ固有のルールは、意図的に必要になった段階で読み込まれます。

モードは 2 つあります。

• スタンドアロンクローン： ソース URL から、新しい実際の Wix CLI Headless プロジェクトを作成します。
• 移行フェーズ： --handoff <migration-project>/website/handoff.json を指定すると、 移行が所有する移行先で処理を続行します。統合移行で --handoff を省略してはいけません。 スタンドアロンコマンドを実行すると、2 つ目のサイトが作成されます。

必ず守るべき不変条件

• 要求された公開ブランドホームページは許可済みとして扱います。個別に通常の許可確認を求めず、 references/safety.md に定められた境界を適用してください。
• ブラウザーを使った抽出は必須です。HTML のみの抽出で代用してはいけません。
• キャプチャの前にホームページを解決してください。検証済みの固定済み抽出マニフェストのみを使って構築します。 生の観察結果をビルダーの入力にしてはいけません。
• スタンドアロンの出力は、Wix ID が有効で、実行可能な dev および build スクリプトを備えた、 正常に生成された Wix CLI のスキャフォールドでなければなりません。Wix 風の代替物を手作業で作成してはいけません。
• 移行モードでは、ハンドオフのサイト／プロジェクトとルート／データバインディングの意図を引き継ぎます。 2 つ目の移行先を作成したり、移行先を変更したりしてはいけません。
• ソースの構造、最初のビューポートのエビデンス、クロームの階層、ソースアセット、フォント、 中核となるインタラクション、SEO、内部 URL の動作、ブランドに沿ったフォールバック動作を保持します。
• ビルドの完了は作業の完了を意味しません。完了には、rp-qa-gap-loop で定められた ビルド後のビジュアルレビューとギャップループのエビデンスが承認されている必要があります。 ただし、ユーザーが明示的にファセットモードを選択した場合に限り、ファセットの承認も必要です。

スーパーバイザープロトコル

新規実行または再開時には、毎回次の手順を行います。

1. ソース URL、出力ディレクトリ、モードを解決します。移行モードでは、最初に website/handoff.json と docs/site-clone/frontend-automation-state.json を読み込みます。
2. 以下の表から最初の未完了ステージを選び、そのリソースの SKILL.md と明示的に必要とされている参照資料のみを読み込みます。
3. 必須の永続成果物が書き出されるまで、または証拠と正確な解除アクションを添えて 具体的かつ実際のブロッカーが記録されるまで、そのステージを実行します。
4. 各区切りの後にステージを選び直します。必須の次のステップについて「実施する必要がある」と 述べて実行を終了してはいけません。該当リソースを読み込み、実行してください。

ステージ	読み込み条件	リソース	永続的な成果
コンテキスト	モード、スコープ、プロジェクト、またはブラウザー環境が未解決の場合	resources/rp-project-context/SKILL.md	有効なコンテキスト、承認記録、実行可能なプロジェクト／計画の状態、またはブロッカー
エビデンス	固定されたホームページの抽出結果が存在しない、または古くなっている場合	resources/rp-source-evidence/SKILL.md	検証済みの extraction/latest.json と固定マニフェスト、またはグローバルブロッカー
実装	固定されたビルド計画があり、ホーム UI が未完成の場合	resources/rp-ui-implementation/SKILL.md	マニフェストのハッシュを考慮した実行可能なホーム実装
検証と改善	ビルド、QA、比較、レビュー、修正、レポート、リリース、または受領確認が未完了の場合	resources/rp-qa-gap-loop/SKILL.md	承認済みの結果、done_with_gaps、またはグローバルブロッカー
任意の外観調整	通常のクローンが承認済みで、自動化状態に外観調整の依頼が示されている場合	resources/rp-facelift/SKILL.md	承認済みの外観調整レビュー、またはブロッカー

frontendPhase.allowedNow が plan の場合は、計画段階で実施可能なコンテキストと エビデンスの作業のみを完了し、再開可能な計画状態の記録を残します。build の場合は、 移行管理下のプロジェクトに対して実装と検証を続行します。

ワンクリックでの続行

automationMode: "one_click" を宣言する移行ハンドオフは、通常のスコープとフロントエンドの チェックポイントを承認します。それらの承認を docs/site-clone/frontend-automation-state.json に記録してください。必須ステージ、 スクリーンショットのレビュー、または承認済みのギャップ修正パスを続行するかどうかを 尋ねるために停止してはいけません。 明示的な外観調整の依頼はワンクリックの受付時に引き継げますが、通常のクローンが承認されるまでは 実施できません。ワンクリックだけでは、外観調整の実施は認められません。

ワンクリックのビルド実行では、次のいずれかの永続的な成果が得られるまで、 ステージの選択と実行を続けます。

• website/completion.json が有効で、最新のビジュアルレビューが完了し、 未解決の重大／高重要度のアイデンティティ上の指摘がない。または
• ビジュアルギャップのサイクルを 5 回完了し、website/completion.json に最終レビュー済み エビデンスを添えて、事実に即した最終ステータス done_with_gaps が記録されている。または
• 担当者、エビデンス、試行した復旧方法、必要な次の権限／アクションを明記した 実際のブロッカーが記録されている。

担当範囲内のローカルな抽出ギャップは、実際のブロッカーではありません。無関係な作業は続行し、 対象を絞った復旧の試行は種類を問わず 2 回以内にとどめたうえで、影響を受ける依存関係の範囲を 暫定的にビルドし、組み立て後の選択肢を final-report.json と .md に提示してください。

シェル、ブラウザー、またはネットワークの障害をブロッカーに分類する前に、 リポジトリ内の Wix／Yarn ツールチェーンの PATH 順序を使い、 resources/rp-project-context/SKILL.md の復旧順序に従ってください。まずシェルの整合性を 確保したうえで再試行し、次に必要なブラウザー／ネットワークのエスカレーションと再試行を行い、 それでも失敗するか承認待ちの場合に限り、ブロッカーとして扱います。ギャップの反復ごとに すぐステージ表に戻ってください。最初のビルド、報告された計画、またはバックエンドのインポートを フロントエンドの完了と見なしてはいけません。

コマンド

スタンドアロンモードでは node scripts/site-clone.mjs <source-url> を、 移行モードでは node scripts/site-clone.mjs <source-url> --handoff <path> を実行します。 現在のリソースに、そのステージで使用する正確なコマンドと入力が記載されています。

参考資料

リソースはそれぞれ独自の参考資料を読み込みます。共有コントラクトは references/ の下にあります： safety.md、workflow.md、extraction-schema.md、output-contract.md、 qa-checklist.md、および interaction/layout/control/normalization/gap の各コントラクト。