Communitygithub.com

Charlo-O/clone-design

端到端網站複製、登陸頁面混搭與設計系統萃取技能。當 Codex 被要求從網址 1:1 複製網站或登陸頁面、將來源網站轉換為當前專案的本地登陸頁面(保留佈局但替換文字與圖片資產)、將網站的設計系統萃取成 DESIGN.md、分析視覺語言,或將多個擷取頁面/狀態綜合為可重複使用的設計指引時使用。

clone-design 是什麼?

這個「clone-design」技能專為 AI 代理(如 Codex)設計,提供一個完整的工作流程來複製現有網站,然後根據當前專案進行適應或萃取其設計系統。它適用於兩種主要情境:一是「登陸頁面混搭」,從網址建立 1:1 複本,驗證後再將文案和圖片替換為專案相關內容,最終產出客製化的登陸頁面;二是「設計系統萃取」,從單一或多個擷取頁面(如登入後的不同 UI 狀態)產生一份結構化的 DESIGN.md 文件,詳述視覺主題、色彩調色板、字體排印規則等。此技能強調高傳真複製,優先使用內建瀏覽器/Playwright 工具來保留 DOM、CSS、字型和響應式行為,並在混搭前避免任何創意偏移。它還提供預設的檔案路徑、驗證檢查清單以及用於自動化設計文件產生的腳本,使其成為開發者將既有 UI 轉化為可操作資產的強大工具。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add Charlo-O/clone-design

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

clone-design 是做什麼的?

先複製一個網站,然後將其混搭成專案專用的登陸頁面,或將其提煉成 DESIGN.md。

預設姿態:在 1:1 複本被驗證之前,保留來源網站呈現的佈局,不做任何創意偏移。只有在驗證之後,才可以為當前專案替換文案、圖像和品牌特定內容。

使用時機

當使用者要求以下事項時,使用此技能:

  • 從網址複製一個網站或登陸頁面
  • 在改編前先 1:1 複製一個登陸頁面
  • 將另一個網站的登陸頁面轉換為當前本地專案的登陸頁面
  • 用當前專案資料夾中的文案替換複製網站的文案
  • 用專案相關的生成點陣圖資產替換複製的圖像
  • 將網站轉換為 DESIGN.md
  • 萃取網站的設計系統
  • 分析頁面的視覺語言
  • 分析已登入的產品 UI 或工作區
  • 綜合來自多個頁面或狀態的設計指引
  • 將 UI 複本轉化為可重複使用的設計指引
  • 直接將即時網址轉換為設計捆綁包

選擇模式

模式 A:登陸頁面混搭

當使用者想要複製另一個登陸頁面並將其改編為當前專案時使用。

流程:

URL -> 1:1 複本 -> 驗證的本地頁面 -> 專案文案映射 -> imagegen 資產 -> 最終登陸頁面

閱讀並遵循:

模式 B:設計系統萃取

當使用者想要 DESIGN.md、視覺語言分析或設計指引時使用。

流程:

URL 或 clone.html -> 擷取 -> design-md/<slug>/

閱讀並遵循:

來源擷取規則

如果使用者提供網址:

  • 不要要求使用者另外安裝或執行 frontend-ui-clone
  • 首先建立一個自包含的 HTML 快照
  • 重複使用與 frontend-ui-clone 相同的複製工作流程和保真度階梯
  • 將來源素材儲存在 captures/<slug>/ 下
  • 為每個擷取的頁面或狀態包含 clone.html
  • 在適當時加入螢幕截圖和 token 轉儲
  • 在混搭或提煉前,先在瀏覽器中驗證複本

如果使用者提供本機 .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.json
    • image-plan.json
    • qa/original-desktop.png
    • qa/clone-desktop.png
    • qa/final-desktop.png
    • 可選的行動裝置螢幕截圖

設計萃取輸出:

  • 輸出資料夾:design-md/<slug>/
  • 輸出檔案:
    • DESIGN.md
    • README.md
    • preview.html
    • preview-dark.html
  • 可選的證據檔案:evidence.json

1:1 複本標準

當輸入是網址時:

  • 在可用時優先使用內建瀏覽器/Playwright 工具
  • 使用與 frontend-ui-clone 相同的預設視口和滾動策略
  • 保留渲染後的 DOM、CSS、字型和解析後的資產 URL
  • 保留原始 DOM 結構、類別名稱、區塊順序、間距、圓角、陰影、字體排印、漸層和響應式行為
  • 在驗證的複本存在之前,不要重新設計、簡化、重塑品牌或重新佈局
  • 如果頁面需要認證,讓使用者在瀏覽器中完成登入,並保持相同的瀏覽器上下文存活
  • 登入後,在同一個工作階段中分別擷取每個請求的頁面或 UI 狀態
  • 如果第一次擷取出現空白英雄區或明顯的覆蓋層問題,則應用與 frontend-ui-clone 相同的升級思維:
    • 第 1 級:DOM + CSS 複製
    • 第 1a 級:混合複製,帶有目標修正
    • 第 1b 級:目標樣式烘焙
  • 在大約 1440 x 900 的解析度下進行桌面螢幕截圖 QA
  • 當頁面具有響應式時,在大約 390px 的寬度下進行行動裝置螢幕截圖 QA
  • 在繼續之前修復可見的不匹配

除非使用者明確要求這種廣度,否則不要自動爬取整個已認證的應用程式。偏好一個精選的關鍵頁面或狀態集合。

混搭規則

將複製的登陸頁面改編為當前專案時:

  1. 在撰寫文案之前,檢查當前專案資料夾以獲取產品背景。偏好 README、PRODUCT.md、package.json、現有登陸頁面、文件、原始碼字串、螢幕截圖和品牌資產。
  2. 對驗證過的複本執行 scripts/extract_landing_inventory.py 以初始化文字和圖片規劃。
  3. 建立一個從原始可見文字到替代文字的文案映射。保留相同的內容層級和近似文字長度,以使佈局保持完整。
  4. 將品牌名稱、標題、副標題、CTA、功能標籤、見證、常見問題文字和頁尾文案替換為專案相關的語言。
  5. 除非使用者明確要求結構變更,否則保留來源佈局、動畫時間、區塊順序和元件結構。
  6. 盤點點陣圖影像、英雄媒體、縮圖、頭像、產品模型和裝飾性照片。
  7. 當來源圖像不應保留時,使用 imagegen 技能生成專案相關的點陣圖替代品。將生成的資產儲存到 landing-pages/<slug>/assets/generated/ 並更新 HTML/CSS 引用。
  8. 偏好保留原始圖片尺寸、寬高比、裁切行為、object-fit、邊框圓角和視覺重量。
  9. 除非使用者要求,否則不要用生成的點陣圖取代簡單的 SVG 圖示、向量標記、CSS 漸層或幾何裝飾。
  10. 移除或替換第三方品牌標誌、名稱、螢幕截圖和商標,除非使用者明確希望為私人參考複本保留它們。
  11. 在文案和圖片替換後,在瀏覽器中驗證最終改編的頁面。修復文字溢出、損壞的圖片、行動裝置換行和佈局偏移。

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
  • 緊縮模糊的措辭
  • 保持 token 宣告基於來源
  • 將不確定的陳述標記為推斷

切勿發明:

  • 複本中不存在的顏色
  • CSS 中未觀察到的字型家族
  • 未萃取的中斷點
  • 需要你未擷取的執行時期狀態的互動
  • 針對你實際上未包含在工作階段中的頁面或流程的覆蓋範圍聲明

所需的 DESIGN.md 章節:

  1. 視覺主題與氛圍
  2. 色彩調色板與角色
  3. 字體排印規則
  4. 元件樣式
  5. 佈局原則
  6. 深度與層級
  7. 要點與禁忌
  8. 響應式行為
  9. 代理提示指南

最終回應

對於登陸頁面混搭模式,報告:

  • 來源 URL
  • 擷取資料夾和驗證過的複本路徑
  • 最終登陸頁面資料夾和 index.html
  • 哪些專案檔案為替代文案提供了資訊
  • 進行了多少次文案替換
  • 建立了多少張生成的圖片以及它們的儲存位置
  • 已執行的桌面/行動裝置瀏覽器驗證
  • 任何限制,例如未擷取的互動或無法乾淨替換的資產

對於設計萃取模式,報告:

  • 如果是從即時網址複製,則儲存擷取資料夾的位置
  • 它是否包含一個 clone.html 或多個具有各自 clone.html 的頁面資料夾,以及可選的 homepage.png / live.json
  • 輸出資料夾的儲存位置
  • 是否包含 DESIGN.md、README.md、preview.html 和 preview-dark.html
  • 如果產生了,evidence.json 的儲存位置
  • 結果是來自強複本來源還是較弱的備用方案
  • 最終綜合中包含多少個頁面或狀態
  • 任何值得注意的限制

相關技能