ウェブサイトスタイルのコピー
目標
特定のウェブサイトの視覚的なスタイル、レイアウト、モーション、インタラクションの感触を、クリーンな静的な実装として再現します。
このスキルは、「このようにしてほしい」というタスクのためのものです。緩やかなテーマ参照よりも厳格で、出力はターゲットの認識可能な構成と動作に似せつつ、オリジナルで保守可能なHTML/CSS/JSを使用する必要があります。
核となる原則:
- スタイルとインタラクションパターンをコピーする。
- デフォルトでは、保護されたコード、アセット、個人情報、プライベートリンク、アナリティクスをコピーしない。
- クリーンな静的バージョンを書き直す。
- ページ相対の内部リンクとアセットを使用して、結果がファイル直接開封、ローカルHTTP、静的ホスティングで動作するようにする。
- 実際のブラウザでターゲットと照合して検証する。
契約
入力:
- ターゲットURL、スクリーンショット、テンプレート、ローカル参照、または具体的なビジュアル/モーション参照。
- 必要なスコープ:ホームページ、選択したページ、または完全なナビゲーション可能な静的再現。
- 出力フォルダ、権限コンテキスト、およびターゲットコンテンツを置き換えるユーザーID/コンテンツ。
出力:
- ターゲットの認識可能なレイアウト、モーション、インタラクションの感触、およびページタイプを再現した、クリーンなプレーンHTML/CSS/JS静的再現。
- コピーされたターゲットIDの代わりにプレースホルダーまたはユーザー所有のコンテンツ。
- ページマップ、コンテンツの場所、簡略化されたインタラクション、省略されたルートを含む
EDITING.md。 - 比較と検証の概要。
境界:
- 保護されたコード、プライベートアセット、アナリティクス、オリジナルの個人コンテンツ、またはライセンスのないメディアを再配布しない。
- 要求されたスコープがナビゲーション可能なサイトを暗示する場合、単一のホームページで止まらない。
- デフォルトではルート絶対フレームワークルートを保持せず、静的な相対パスに変換する。
- 公開せず、
publish-static-siteを使用する。
成功ゲート:
- ローカルの再現が、要求された忠実度に対して、ターゲットの署名レイアウト、視覚言語、およびコアインタラクションに十分近いこと。
- 重要なページタイプが存在し、リンクされていること。
- ターゲットIDが置き換えられているか、明示的に許可されていること。
review-static-siteがパスするか、承認された制限のみを報告すること。
ゲートが失敗した場合:
- ターゲットを再調査し、署名レイアウト/モーションを反復する。
- IDの残骸には
personalize-siteを使用する。 - 構造/パス/エンコーディング/ブラウザブロッカーには
review-static-siteを使用する。
ショートパイプライン
ウェブサイト再現には以下のパイプラインに従ってください:
- ブラウザでターゲットを探索する。
- ターゲットの内部ページとクリック可能なルートをマッピングする。
- 調査としてソースとアセットを検査する。
- 署名レイアウト、モーション、インタラクション、ビジュアルを抽出する。
- 元のサイトのIDと個人コンテンツを置き換える。
- プレーンなHTML/CSS/JSで完全なナビゲーション可能なサイトを再構築する。
- フレームワーク/ルートルートを静的なページ相対リンクに変換する。
- 将来のモデル/ユーザー編集のための編集ガイドを追加する。
- 実際のブラウザでHTTP経由でローカルに検証する。
- ターゲットと比較し、反復する。
- 残っているターゲット固有のテキストやアセットを監査する。
使用する場合
ユーザーが以下のように言った場合、または暗示した場合にこのスキルを使用します:
- このウェブサイトのスタイルをコピーして。
- このページを再現して。
- このサイトをクローンして。
- このウェブサイトの静的バージョンを作成して。
- このURLまたはスクリーンショットのように見えるようにして。
- 元のアニメーション、スクロール、ホバー、またはインタラクションに一致させて。
- 1:1、高忠実度、ピクセル単位、同じ感触、同じモーションで。
ウェブサイト、v0、Figma、GitHub Themes、Astro、Hugo、Jekyll、Quartz、Next、React、Tailwind、またはその他のフレームワークベースのテンプレートからの参照に使用し、ユーザーが緩やかなインスピレーションではなく、密接な再現を望む場合に使用します。
使用しない場合
以下の場合、このスキルを使用しないでください:
- ユーザーがテーマを検索したいだけの場合。
search-blog-themeを使用します。 - ユーザーが選択した方向からオリジナルのパーソナルサイトを望む場合。
make-personal-siteを使用します。 - ユーザーがコンテンツの移行や投稿のインポートを望む場合。
add-blog-postsを使用します。 - ユーザーがデプロイのヘルプのみを望む場合。
publish-static-siteを使用します。 - ユーザーが所有していないサイトから保護されたコード、プライベートアセット、または個人コンテンツを直接コピーするように要求した場合。
- ユーザーがプレーンな静的バージョンを作成する代わりに、元のフレームワークとビルドシステムを保持することを明示的に望む場合。
入力
利用可能なものを使用します:
- ターゲットURL、スクリーンショット、ビデオ、テンプレートリンク、またはローカル参照。
- ユーザーが希望する出力フォルダ。
- 最終結果がプレースホルダーコンテンツを保持するか、ユーザー自身のコンテンツを使用するか。
- 必要なページまたはセクション。
- ユーザーが提供する場合の予想されるスコープ:ホームページのみ、選択したページ、または完全なナビゲーション可能なサイト。
- ユーザーがターゲットを所有しているか、アセット/コードを再利用する許可を持っているか。
- 必要な静的制約:ビルドステップなし、外部依存関係なし、ローカルデプロイのみなど。
ブラウザ探索パス
実装前に、URLまたはインタラクティブな参照が利用可能な場合、実際のブラウザでターゲットを探索します。
ターゲットとローカルプレビューを観察するための最初の選択肢として、実際に利用可能なインタラクティブブラウザツールを使用します。「利用可能」とは、ツールが現在のターンの呼び出し可能なツールリストに公開されており、単にスキル、プラグインリスト、またはシステム説明に言及されているだけではないことを意味します。Codexでは、これはユーザーまたはクライアントがターンにルーティングした場合のブラウザ/アプリ内ブラウザプラグインである可能性があります。他のエージェントでは、同等の可視ブラウザ、ブラウザユースツール、またはdevtoolsバックエンドブラウザである可能性があります。目標は、ユーザーがページを見るのと同じようにページを見ることです:ビューポート、モーション、スクロール、ホバー/クリック動作、モバイルレイアウト、コンソール状態、ネットワーク障害。
現在のターンでインタラクティブブラウザツールが公開されていない場合、ブラウザパスが発生したふりをしないでください。ターゲットの探索またはローカル比較がそれに依存する場合、ユーザーにクライアントのルーティング方法を使用してブラウザツールを有効化または呼び出すように依頼します。Codexの場合、それは@browserを明示的に言及するリクエストを送信することを意味する場合があります。ユーザーが再ルーティングしない場合、またはクライアントにそのようなツールがない場合、Playwright、スクリーンショット、静的監査、またはソース検査にフォールバックし、制限を明記します。
インタラクティブブラウザツールが実際に呼び出し可能な場合、デフォルトでPlaywright、ヘッドレスオンリーのスクリーンショット、または生のソース検査を使用しないでください。スクリーンショットは観察された内容を文書化できますが、インタラクティブブラウザパスの代わりにはなりません。Playwrightは、インタラクティブブラウザツールが呼び出し不可能な場合、ユーザーが明示的にPlaywrightを要求した場合、または反復可能なスクリプト比較が特に必要な場合にのみ、フォールバックとして使用します。
タスクにユーザーのChromeプロファイル、既存のChromeタブ、拡張機能、認証済みページ、またはChrome固有の動作が必要な場合は、Chrome自動化を使用します。
探索中に検査する項目:
- デスクトップ最初の画面:構成、スケール、スペーシング、タイポグラフィ、色、可視ナビゲーション、主要な視覚的モチーフ。
- モバイル最初の画面:レイアウトの変更、非表示のナビゲーション、スクロール動作、コンテンツの優先順位。
- 開幕シーケンス:ロード状態、表示順序、不透明度/スケール/クリップの変更、遅延、イージング感。
- スクロール動作:垂直 vs 水平スクロール、固定領域、スナップポイント、慣性、スクロールリンク変換、ミニマップの変更。
- ポインタ動作:ホバー状態、カーソルの詳細、ドラッグ動作、ポインタ追従要素、ヒット領域。
- クリック動作:ナビゲーション、トグル、コピー状態、アクティブ状態、モーダル、トランジション。
- キーボード動作:矢印キー、タブフォーカス、エスケープ/エンターの動作(関連する場合)。
- 内部ページマップ:プライマリナビゲーションリンク、ヘッダー/フッターリンク、内部ページを開くカード、記事/詳細ページ、アーカイブ/カテゴリ/検索/テーマ/設定ページ、ページネーション、モバイルメニューのみのルート。
- ソースの手がかり:DOM構造、CSS変数、クラス名、インラインスタイル、ロードされたフォント、画像アセット、バンドルされたCSS/JS名、ネットワークリクエスト。
- コンソール状態:動作に影響を与える可能性のある可視のランタイムエラーまたは警告。
実装を導くのに十分な証拠をキャプチャまたは精神的に記録します。ユーザーが要求しない限り、長い探索ログをユーザーに公開しないでください。それを使用して署名インベントリと実装計画を構築します。
ソース検査ルール
公開ウェブサイトの場合、ページソース、バンドルされたCSS/JS、ネットワークロードアセット、DOM構造を検査して、レイアウト、ブレークポイント、CSS変数、アニメーションタイミング、スクロール動作、インタラクションロジックを理解することができます。
検査したソースを研究資料として使用し、デフォルトの成果物コードとしては使用しないでください。
以下のいずれかに該当しない限り、別のサイトのコード、画像、フォント、個人コンテンツ、プライベートリンク、アナリティクス、またはバンドルされたアセットを直接コピー、再配布、または保存しないでください:
- ユーザーがサイトを所有している。
- ソースまたはアセットが互換性のあるライセンスで明らかにオープンソースである。
- ユーザーが再利用の許可を持っていることを確認した。
通常のレプリカ作業では、可視の動作とデザイン言語をキャプチャする、クリーンで保守可能なプレーンHTML/CSS/JSバージョンを書き直します。検査された実装の詳細が重要な場合、アイデアをオリジナルのコードに変換します。
忠実度ワークフロー
これらの手順を、本格的な再現のための必須の内部作業として扱います:
- 可能な場合、ブラウザ探索パスを実行する。
- 可視のナビゲーションと重要な内部リンクからターゲットページマップを構築する。
- 実装の手がかりのためにターゲットのソースとDOMを検査する。
- ターゲットの署名レイアウト、署名モーション、署名インタラクション、署名ビジュアル詳細を特定する。
- 共有シェルを実装し、次にリンクされた内部ページを実装する。
- HTTP経由でローカル静的バージョンをプレビューする。
- 同様のブラウザビューポートでローカル結果をターゲットと比較する。
- 結果がユーザーの要求に対してターゲットの感触に十分近づくまで反復する。
- 意味のある残りの違いを報告する。
ターゲットがモーションファーストの場合、HTML構造が類似した後に停止しないでください。
フルサイトスコープルール
デフォルトでは、単一のホームページだけでなく、ナビゲーション可能な静的サイトとしてターゲットを再現します。
ユーザーが明示的に「ホームページのみ」を要求しない限り、ターゲットの重要な内部ルートに対して静的なページを作成します:
- プライマリナビゲーションページ。
- ホームページまたはプライマリリストからリンクされた記事/詳細ページ。
- 可視のエクスペリエンスの一部である場合のアーカイブ、カテゴリ、タグ、リンク、テーマ、プレビュー、設定、または検索ページ。
- モバイルメニューのみの目的地。
- サイトのブラウズ方法を定義する場合のページネーションまたはリストページ。
大規模なサイトの場合、すべての実際のコンテンツアイテムをミラーリングしないでください。プレースホルダーコンテンツを使用してサイト構造とページタイプを再現します:
- 1つまたは少数の代表的な記事/詳細ページ。
- 代表的なアーカイブ/カテゴリ/リストページ。
- ページネーション、フィルタリング、検索、カード、サイドバーの動作を示すプレースホルダーエントリ。
- 生成された静的ページ間の動作する内部リンク。
生成されたページマップをEDITING.mdに記録します。ターゲットルートが意図的に省略されている場合、その理由と追加方法を説明します。
署名インベントリ
コーディング前に、内部インベントリを構築します:
- 署名レイアウト:ページ構造、構成、スケール、スペーシング、ナビゲーション、ブレークポイント、繰り返されるモチーフ、珍しいレイアウトメカニクス。
- 署名モーション:オープニングアニメーション、表示効果、スクロール動作、イージング、スプリングのような動き、ホバー状態、トランジション、ロード状態。
- 署名インタラクション:ホイール動作、キーボード動作、クリック状態、コピー状態、アクティブナビゲーション、ドラッグ/スクロールジェスチャー、モバイルの変更。
- 署名ビジュアル:色、タイポグラフィの感触、コントラスト、境界線、シャドウ、マスキング、ブレンドモード、形状、イラスト、背景処理。
二次的なコンテンツを入力する前に、これらの署名部分を再現します。
フレームワークとモーションの翻訳ルール
ターゲットは任意のスタックを使用する場合があります。ユーザーが明示的に別の方法を要求しない限り、可視の動作をプレーンな静的ファイルに翻訳します。
一般的な翻訳:
- React、Next、またはAstroコンポーネント -> 再利用可能なCSSクラスを持つ繰り返しHTMLセクション。
- Tailwindユーティリティクラス -> 通常のCSSルール。
- フレームワークルート -> リンクされた
.htmlファイル。 - コンテンツコレクションまたはCMSデータ -> 静的なHTMLリストまたは小さなJSONファイル。
- テーマ設定 -> CSSカスタムプロパティ。
- Framer Motionスプリング -> バニラJavaScriptスプリングループ、
requestAnimationFrame、または注意深く調整されたCSSイージング。 scrollX/scrollY変換 -> CSSカスタムプロパティと変換にマッピングされたスクロール進行。- クリップ表示 ->
overflow: hiddenとtranslateY、clip-path、またはマスクアニメーション。 - スケール表示 ->
transform: scale(...)と transform-origin およびイージング。 - レイアウトモーション -> 変換と不透明度のトランジション、レイアウトを乱す幅/高さの変更は不可。
- スクロールリンク水平キャンバス -> ホイールリスナーと水平スクロール、スナップポイント、アクティブパネル検出、オプションの慣性イージング。
- ミニマップトラッカー -> アクティブ状態とスクロール位置に同期された変換/不透明度。
- クリップボードへのコピーアニメーション -> 翻訳/不透明度トランジションを伴う2状態テキスト切り替え。
- カーソル/クロスヘアの詳細 -> 参照の中心である場合、固定要素またはポインタ追従変換。
- ブレンド効果 -> CSS
mix-blend-mode、マスク、または必要な場合に簡略化された静的なコントラスト。
prefers-reduced-motionを尊重しますが、縮小モーションがアクティブでない限り、署名モーションを完全に削除しないでください。
静的パス互換性ルール
ターゲットサイトは、/assets/...、/posts/...、/blogなどのサーバールートルート、またはフレームワークルーティングを使用する場合があります。再作成された静的出力は、デフォルトでこれらのルート絶対パスを保持しないでください。
デフォルトルール:
- すべてのサイトローカルアセットと内部リンクにページ相対パスを使用します。
- ルートページからは、
assets/style.css、assets/script.js、posts/example.html、archive/index.htmlを使用します。 - ネストされたページからは、
../assets/style.css、../index.htmlなどの正しい深さ、または兄弟相対リンクを使用します。 /posts/foo、/tags/bar、/projectsなどのターゲットルートを、出力構造に応じてposts/foo.html、tags/bar.html、projects.html、またはprojects/index.htmlなどの生成された静的パスに変換します。- ユーザーが明示的にサーバールートのみの動作を受け入れない限り、内部ナビゲーションに
/assets/...、/posts/...、/data/...、/images/...、または/を保持しないでください。 - これをHTML属性、CSS
url(...)、ファビコン、カバー画像、フォント、数学/ベンダーアセット、JavaScript生成のカード/検索結果、コピーされたルートデータに適用します。
回避する…