clone-design は何をしますか?
まずウェブサイトをクローンし、その後、プロジェクト固有のランディングページにリミックスするか、DESIGN.mdに抽出します。
デフォルトの姿勢: 1:1のクローンが検証されるまで、ソースサイトのレンダリングされたレイアウトを創造的な逸脱なしに維持します。その後にのみ、現在のプロジェクト用にコピー、画像、ブランド固有のコンテンツを置き換えることができます。
使用時機
ユーザーが以下の依頼をした場合にこのスキルを使用します:
- URLからウェブサイトやランディングページをクローンする
- ランディングページを適応前に1:1で複製する
- 別のウェブサイトのランディングページを現在のローカルプロジェクトのランディングページに変換する
- クローンしたウェブサイトのコピーを現在のプロジェクトフォルダのコピーで置き換える
- クローンした画像をプロジェクト関連の生成ラスターアセットで置き換える
- ウェブサイトを
DESIGN.mdに変換する - サイトのデザインシステムを抽出する
- ページのビジュアル言語を分析する
- ログイン済みの製品UIやワークスペースを分析する
- 複数のページや状態からデザインガイダンスを統合する
- UIクローンを再利用可能なデザインガイダンスに変換する
- ライブURLから直接デザインバンドルを作成する
モードの選択
モードA: ランディングページリミックス
ユーザーが別のランディングページをクローンして現在のプロジェクトに適応させたい場合に使用します。
パイプライン:
URL -> 1:1クローン -> 検証済みローカルページ -> プロジェクトコピーマップ -> imagegenアセット -> 最終ランディングページ
以下を読んで従ってください:
モードB: デザインシステム抽出
ユーザーがDESIGN.md、ビジュアル言語分析、またはデザインガイダンスを求める場合に使用します。
パイプライン:
URL または clone.html -> キャプチャ -> design-md/<slug>/
以下を読んで従ってください:
- references/ui_clone_workflow.md
- references/multi_page_session_workflow.md (ログイン、複数ページ、または複数の状態が重要な場合)
ソースキャプチャルール
ユーザーがURLを指定した場合:
- ユーザーに
frontend-ui-cloneを個別にインストールまたは実行するように依頼しないでください - 最初に自己完結型のHTMLスナップショットを作成します
frontend-ui-cloneと同じクローンワークフローと忠実度ラダーを再利用します- ソースマテリアルを
captures/<slug>/の下に保存します - キャプチャしたすべてのページまたは状態に
clone.htmlを含めます - 必要に応じてスクリーンショットとトークンダンプを追加します
- リミックスまたは抽出の前に、ブラウザでクローンを検証します
ユーザーがローカルの.htmlファイルを指定した場合:
- それを直接使用します
- 単一ファイル、複数ファイル、または複数の
clone.htmlファイルを含むキャプチャディレクトリを受け入れます
サイトがクライアントサイドレンダリングに依存している場合、生のHTTPフェッチからのリミックスやDESIGN.mdの作成は避けてください。
デフォルトパス
ユーザーがパスを指定しない場合:
キャプチャファイル:
- 単一ページキャプチャフォルダ:
captures/<slug>/ - 複数ページキャプチャフォルダ:
captures/<slug>/<page-slug>/ - ページごとのファイル:
clone.html,homepage.png,live.json - オプションのサイトレベルキャプチャマニフェスト:
captures/<slug>/capture-plan.json
ランディングリミックス出力:
- 出力フォルダ:
landing-pages/<slug>/ - 最終ページ:
index.html - 検証済みソースクローン:
source-clone.html - 抽出されたインベントリ:
content-inventory.json - 生成されたアセット:
assets/generated/ - 計画およびQAファイル:
copy-map.jsonimage-plan.jsonqa/original-desktop.pngqa/clone-desktop.pngqa/final-desktop.png- オプションのモバイルスクリーンショット
デザイン抽出出力:
- 出力フォルダ:
design-md/<slug>/ - 出力ファイル:
DESIGN.mdREADME.mdpreview.htmlpreview-dark.html
- オプションの証拠ファイル:
evidence.json
1:1クローンスタンダード
入力がURLの場合:
- 可能な場合は組み込みのブラウザ/Playwrightツールを優先します
frontend-ui-cloneと同じデフォルトビューポートとスクロール戦略を使用します- レンダリングされたDOM、CSS、フォント、および解決済みのアセットURLを保持します
- 元のDOM構造、クラス名、セクション順序、スペーシング、半径、シャドウ、タイポグラフィ、グラデーション、およびレスポンシブ動作を保持します
- 検証済みのクローンが存在する前に、再設計、簡略化、ブランド変更、またはレイアウト変更を行わないでください
- ページに認証が必要な場合、ユーザーにブラウザでログインを完了させ、同じブラウザコンテキストを維持します
- ログイン後、同じセッション内で要求された各ページまたはUI状態を個別にキャプチャします
- 最初のキャプチャに空白のヒーローや明らかなオーバーレイの問題がある場合、
frontend-ui-cloneと同じエスカレーションマインドセットを適用します:- レベル1: DOM + CSSクローン
- レベル1a: ターゲット修正を施したハイブリッドクローン
- レベル1b: ターゲットスタイルベイク
- デスクトップスクリーンショットQAを約
1440 x 900で行います - ページがレスポンシブである場合、モバイルスクリーンショットQAを約
390px幅で行います - 続行する前に、目に見える不一致を修正します
ユーザーがその広範さを明確に要求しない限り、認証済みアプリ全体を自動クロールしないでください。主要なページまたは状態の厳選されたセットを優先します。
リミックスルール
クローンしたランディングページを現在のプロジェクトに適応させる場合:
- コピーを書く前に、現在のプロジェクトフォルダを調べて製品コンテキストを取得します。
README、PRODUCT.md、package.json、既存のランディングページ、ドキュメント、ソース文字列、スクリーンショット、ブランドアセットを優先します。 - 検証済みクローンに対して
scripts/extract_landing_inventory.pyを実行し、テキストと画像の計画を準備します。 - 元の表示テキストから置換テキストへのコピーマップを作成します。同じコンテンツ階層を維持し、レイアウトが崩れないようにテキストの長さをほぼ同じにします。
- ブランド名、見出し、サブ見出し、CTA、機能ラベル、推薦文、FAQテキスト、フッターコピーをプロジェクト関連の言語に置き換えます。
- ユーザーが明示的に構造変更を要求しない限り、ソースのレイアウト、アニメーションタイミング、セクション順序、コンポーネント構造を維持します。
- ラスター画像、ヒーローメディア、サムネイル、アバター、製品モックアップ、装飾写真をインベントリします。
- ソース画像を残すべきでない場合、プロジェクト関連のラスター置換には
imagegenスキルを使用します。生成されたアセットをlanding-pages/<slug>/assets/generated/に保存し、HTML/CSS参照を更新します。 - 元の画像の寸法、アスペクト比、クロップ動作、object-fit、ボーダー半径、視覚的な重みを維持することを優先します。
- ユーザーが要求しない限り、単純なSVGアイコン、ベクターマーク、CSSグラデーション、または幾何学的な装飾を生成されたビットマップに置き換えないでください。
- ユーザーがプライベート参照クローン用に明示的に保持したい場合を除き、サードパーティのブランドロゴ、名前、スクリーンショット、商標を削除または置き換えます。
- コピーと画像の置き換え後、ブラウザで最終的な適応ページを検証します。テキストオーバーフロー、画像切れ、モバイルでの折り返し、レイアウトのずれを修正します。
DESIGN.md生成
デザイン抽出モードの場合、バンドルされたスクリプトを使用します:
python3 scripts/generate_design_md.py "$CLONE_HTML" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
複数のキャプチャページの場合:
python3 scripts/generate_design_md.py \
"captures/$SLUG/home/clone.html" \
"captures/$SLUG/workspace/clone.html" \
"captures/$SLUG/settings-modal-open/clone.html" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
または、キャプチャルートを直接スキャンします:
python3 scripts/generate_design_md.py \
--capture-dir "captures/$SLUG" \
--name "$SITE_NAME" \
--url "$SITE_URL" \
--out-dir "design-md/$SLUG" \
--json-out "design-md/$SLUG/evidence.json"
これらの値がない場合はオプションフラグを省略します。
生成後:
- 生成された
DESIGN.mdを読みます - 曖昧な表現を明確にします
- トークンクレームをソースに基づいて維持します
- 不確かなステートメントは推測としてマークします
以下のことを決して捏造しないでください:
- クローンに存在しない色
- CSSで観測されなかったフォントファミリー
- 抽出されなかったブレークポイント
- キャプチャしなかったランタイム状態を必要とするインタラクション
- セッションに実際に含めなかったページやフローに対するカバレッジクレーム
必須のDESIGN.mdセクション:
- ビジュアルテーマと雰囲気
- カラーパレットと役割
- タイポグラフィルール
- コンポーネントスタイリング
- レイアウト原則
- 奥行きとエレベーション
- すべきこととすべきでないこと
- レスポンシブ動作
- エージェントプロンプトガイド
最終応答
ランディングリミックスモードの場合、以下を報告します:
- ソースURL
- キャプチャフォルダと検証済みクローンパス
- 最終ランディングページフォルダと
index.html - 置換コピーの決定に使用したプロジェクトファイル
- 行われたコピー置換の数
- 作成された生成画像の数とその保存先
- 実行されたデスクトップ/モバイルブラウザ検証
- キャプチャされなかったインタラクションやクリーンに置き換えられなかったアセットなどの制限事項
デザイン抽出モードの場合、以下を報告します:
- ライブURLからクローンした場合、キャプチャフォルダが保存された場所
- 単一の
clone.htmlが含まれているか、複数のページフォルダにそれぞれclone.htmlが含まれているか、およびオプションでhomepage.png/live.jsonが含まれているか - 出力フォルダが保存された場所
DESIGN.md、README.md、preview.html、preview-dark.htmlが含まれているかevidence.jsonが生成された場合、その保存先- 結果が強力なクローンソースから得られたものか、弱いフォールバックから得られたものか
- 最終的な統合に含まれたページまたは状態の数
- 顕著な制限事項