複製網站風格 是做什麼的?
目標
將特定網站的視覺風格、版面、動畫和互動感受,重新實作為一個乾淨的靜態實作。
此技能適用於「做得像這樣」的任務。它的限制比寬鬆的主題參考更嚴格:輸出結果應與目標的識別性構圖和行為相似,同時使用原創、可維護的 HTML/CSS/JS。
核心原則:
- 複製風格和互動模式。
- 預設不複製受保護的程式碼、素材、個人身份、私人連結或分析腳本。
- 改寫一個乾淨的靜態版本。
- 使用頁面相對路徑的內部連結和素材,讓結果可透過直接開啟檔案、本機 HTTP 和靜態託管運作。
- 在真實瀏覽器中對目標進行驗證。
契約
輸入:
- 目標網址、螢幕截圖、模板、本機參考,或具體的視覺/動畫參考。
- 期望的範圍:首頁、選定頁面,或完整的可導覽靜態重現。
- 輸出資料夾、權限上下文,以及任何用於取代目標內容的使用者身份/內容。
輸出:
- 一個乾淨的純 HTML/CSS/JS 靜態重現,包含目標的識別性版面、動畫、互動感受和頁面類型。
- 使用佔位內容或使用者擁有的內容來取代複製的目標身份。
- 一個名為
EDITING.md的檔案,包含頁面地圖、內容位置、簡化的互動,以及被省略的路由。 - 比較與驗證摘要。
邊界:
- 不得重新分發受保護的程式碼、私有素材、分析腳本、原始個人內容,或未經授權的媒體。
- 當要求的範圍隱含一個可導覽的網站時,不得只做一個首頁就停止。
- 預設不保留根目錄絕對路徑的框架路由;應轉換為靜態相對路徑。
- 不得發布;請使用
publish-static-site。
成功門檻:
- 本機重現與目標的簽章版面、視覺語言和核心互動緊密匹配,達到要求保真度的水準。
- 重要的頁面類型已存在並連結。
- 目標身份已被取代或已獲得明確許可。
review-static-site能夠通過,或僅回報已接受的限制。
如果門檻未通過:
- 重新檢查目標,並對簽章版面/動畫進行迭代。
- 對身份殘留使用
personalize-site。 - 對結構/路徑/編碼/瀏覽器阻礙使用
review-static-site。
簡短流程
請遵循此流程進行網站重現:
- 在瀏覽器中探索目標。
- 繪製目標的內部頁面和可點擊路由的地圖。
- 檢查原始碼和素材作為研究。
- 提取簽章版面、動畫、互動效果和視覺元素。
- 取代原始網站的身份和個人內容。
- 使用純 HTML/CSS/JS 重建完整的可導覽網站。
- 將框架/根目錄路由轉換為靜態頁面相對路徑的連結。
- 新增一個編輯指南,供未來模型/使用者編輯使用。
- 在真實瀏覽器中透過 HTTP 在本機進行驗證。
- 與目標進行比較並迭代。
- 稽核是否有遺留的目標特定文字或素材。
使用時機
當使用者說出或暗示以下情況時,使用此技能:
- 複製這個網站風格。
- 重現這個頁面。
- 克隆這個網站。
- 製作這個網站的靜態版本。
- 讓它看起來像這個網址或螢幕截圖。
- 匹配原始的動畫、捲動、懸停或互動效果。
- 1:1、高保真度、像素級、同樣的感覺、同樣的動畫。
當使用者想要的是接近重現而非寬鬆靈感時,可將其用於來自網站、v0、Figma、GitHub 主題、Astro、Hugo、Jekyll、Quartz、Next、React、Tailwind 或其他基於框架的模板的參考。
不應使用時機
在以下情況下,請勿使用此技能:
- 使用者只想搜尋主題。請使用
search-blog-theme。 - 使用者想要一個從選定方向出發的原創個人網站。請使用
make-personal-site。 - 使用者想要內容遷移或文章匯入。請使用
add-blog-posts。 - 使用者只需要部署協助。請使用
publish-static-site。 - 使用者要求直接複製其不擁有之網站的受保護程式碼、私有素材或個人內容。
- 使用者明確想要保留原始框架和建置系統,而不是製作純靜態版本。
輸入
使用任何可用的資訊:
- 目標網址、螢幕截圖、影片、模板連結或本機參考。
- 使用者期望的輸出資料夾。
- 最終結果應保留佔位內容還是使用使用者自己的內容。
- 所需的頁面或區段。
- 使用者提供的預期範圍:僅首頁、選定頁面,或完整的可導覽網站。
- 使用者是否擁有目標或擁有重複使用素材/程式碼的權限。
- 任何所需的靜態限制:無建置步驟、無外部依賴、僅限本機部署等。
瀏覽器探索流程
在實作之前,若目標是網址或互動式參考,請在真實瀏覽器中探索目標。
將實際可用的互動式瀏覽器工具作為觀察目標和本機預覽的首選方式。「可用」表示該工具已在當前對話回合的可呼叫工具清單中公開,而不僅僅是在技能、插件清單或系統描述中被提及。在 Codex 中,這可能是當使用者或用戶端已將其路由至該回合時的瀏覽器/應用內瀏覽器插件;在其他代理中,這可能是等效的可見瀏覽器、瀏覽器使用工具或具備開發工具支援的瀏覽器。目標是像使用者一樣查看頁面:視區、動畫、捲動、懸停/點擊行為、行動版佈局、控制台狀態和網路失敗。
如果當前回合中沒有公開的互動式瀏覽器工具,請假裝瀏覽器流程已發生。如果目標探索或本機比較依賴於此,請要求使用者使用其客戶端的路由方法啟用或調用瀏覽器工具;對於 Codex,這可能意味著發送一個明確提及 @browser 的請求。如果使用者未重新路由或用戶端沒有此類工具,則回退至 Playwright、螢幕截圖、靜態稽核或原始碼檢查,並說明此限制。
當互動式瀏覽器工具實際可呼叫時,請勿預設使用 Playwright、僅無頭模式的螢幕截圖或原始原始碼檢查。螢幕截圖可以記錄觀察到的內容,但它們不能取代互動式瀏覽器流程。僅在沒有可呼叫的互動式瀏覽器工具、使用者明確要求 Playwright,或特別需要可重複的腳本化比較時,才使用 Playwright 作為回退。
當任務需要使用者的 Chrome 個人資料、現有的 Chrome 分頁、擴充功能、已認證頁面或 Chrome 特定的行為時,請使用 Chrome 自動化。
在探索過程中,檢查:
- 桌機版首屏:構圖、比例、間距、排版、顏色、可見導覽和主要視覺主題。
- 手機版首屏:佈局變化、隱藏式導覽、捲動行為和內容優先級。
- 開啟動畫序列:載入狀態、揭示順序、透明度/縮放/裁剪變化、延遲和緩動感覺。
- 捲動行為:垂直與水平捲動、固定區域、吸附點、慣性、捲動關聯變形和小地圖變化。
- 指標行為:懸停狀態、遊標細節、拖曳行為、指標跟隨元素和點擊區域。
- 點擊行為:導覽、切換、複製狀態、活動狀態、模態框和轉場效果。
- 鍵盤行為:方向鍵、Tab 焦點、相關時的 Escape/Enter 行為。
- 內部頁面地圖:主要導覽連結、頁首/頁尾連結、開啟內部頁面的卡片、文章/詳細資訊頁面、歸檔/分類/搜尋/主題/設定頁面、分頁和僅限行動選單的路由。
- 原始碼線索:DOM 結構、CSS 變數、類別名稱、行內樣式、載入的字型、圖片素材、打包的 CSS/JS 名稱和網路請求。
- 控制台狀態:可能影響行為的可見執行時期錯誤或警告。
擷取或在腦中記錄足夠的證據來引導實作。除非使用者要求,否則不要向使用者暴露冗長的探索日誌;用它來建立簽章清單和實作計畫。
原始碼檢查規則
對於公開網站,可以檢查頁面原始碼、打包的 CSS/JS、網路載入的素材和 DOM 結構,以了解佈局、斷點、CSS 變數、動畫計時、捲動行為和互動邏輯。
將檢查過的原始碼作為研究材料,而非預設的可交付程式碼。
除非符合以下任一條件,否則不得直接複製、重新分發或保留其他網站的程式碼、圖片、字型、個人內容、私人連結、分析腳本或打包素材:
- 使用者擁有該網站。
- 該來源或素材是明確的開源軟體且具有相容的授權。
- 使用者確認他們擁有重複使用的權限。
對於一般的複製品工作,請改寫一個乾淨、可維護的純 HTML/CSS/JS 版本,以捕捉可見的行為和設計語言。如果檢查到的實作細節很重要,請將概念轉換為原始程式碼。
保真度工作流程
將這些步驟視為認真重現工作中的必要內部工作:
- 在可能的情況下執行瀏覽器探索流程。
- 從可見導覽和重要的內部連結建立目標頁面地圖。
- 檢查目標原始碼和 DOM 以取得實作線索。
- 識別目標的簽章版面、簽章動畫、簽章互動和簽章視覺細節。
- 實作共享外殼,然後是連結的內部頁面。
- 透過 HTTP 預覽本機靜態版本。
- 在相似的瀏覽器視區中將本機結果與目標進行比較。
- 迭代,直到結果的風格足以匹配使用者的要求。
- 回報任何有意義的剩餘差異。
如果目標是以動畫為優先,請不要在 HTML 結構相似時就停止。
完整網站範圍規則
預設應將目標重現為一個可導覽的靜態網站,而不僅是單一首頁。
除非使用者明確要求「僅首頁」,否則請為目標的重要內部路由建立靜態頁面:
- 主要導覽頁面。
- 從首頁或主要清單連結到的文章/詳細資訊頁面。
- 歸檔、分類、標籤、連結、主題、預覽、設定或搜尋頁面(當它們是可見體驗的一部分時)。
- 僅限行動選單的目的地。
- 定義網站瀏覽方式的分頁或清單頁面。
對於大型網站,不要鏡像每一個真實內容項目。使用佔位內容重建網站結構和頁面類型:
- 一個或幾個具代表性的文章/詳細資訊頁面。
- 具代表性的歸檔/分類/清單頁面。
- 展示分頁、過濾、搜尋、卡片和側邊欄行為的佔位條目。
- 產生的靜態頁面之間可運作的內部連結。
在 EDITING.md 中記錄產生的頁面地圖。如果任何目標路由被故意省略,請說明原因以及如何新增它們。
簽章清單
在編碼之前,建立一個內部清單:
- 簽章版面:頁面結構、構圖、比例、間距、導覽、斷點、重複的主題和獨特的佈局機制。
- 簽章動畫:開啟動畫、揭示效果、捲動行為、緩動、彈簧式移動、懸停狀態、轉場效果、載入狀態。
- 簽章互動:滾輪行為、鍵盤行為、點擊狀態、複製狀態、活動導覽、拖曳/捲動手勢、行動版變化。
- 簽章視覺元素:顏色、排版感覺、對比度、邊框、陰影、遮罩、混合模式、形狀、插圖、背景處理。
在填入次要內容之前,先重現這些簽章元素。
框架與動畫轉譯規則
目標可能使用任何技術棧。除非使用者明確要求,否則請將可見行為轉譯為純靜態檔案。
常見的轉譯方式:
- React、Next 或 Astro 元件 -> 重複的 HTML 區段搭配可重複使用的 CSS 類別。
- Tailwind 工具類別 -> 標準 CSS 規則。
- 框架路由 -> 連結的
.html檔案。 - 內容集合或 CMS 資料 -> 靜態 HTML 清單或小型 JSON 檔案。
- 主題設定 -> CSS 自訂屬性。
- Framer Motion 彈簧 -> 原生 JavaScript 彈簧迴圈、
requestAnimationFrame或精心調整的 CSS 緩動。 scrollX/scrollY變形 -> 將捲動進度對應到 CSS 自訂屬性和變形。- 裁剪揭示效果 ->
overflow: hidden搭配translateY、clip-path或遮罩動畫。 - 縮放揭示效果 -> 帶有變形原點和緩動的
transform: scale(...)。 - 版面動畫 -> 變形和透明度轉場效果,而非引發版面重排的寬度/高度變更。
- 捲動關聯的水平畫布 -> 滾輪監聽器搭配水平捲動、吸附點、活動面板偵測,以及可選的慣性緩動。
- 小地圖追蹤器 -> 活動狀態搭配與捲動位置同步的變形/透明度。
- 複製到剪貼簿動畫 -> 雙狀態文字切換搭配 translate/opacity 轉場效果。
- 遊標/十字準線細節 -> 如果對參考至關重要,則使用固定元素或指標跟隨變形。
- 混合效果 -> 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 生成的卡片/搜尋結果,以及複製的路由資料。
避免直接從原始目標複製路徑。確保所有資產和連結都是獨立的。
內容替換規則
除非滿足以下條件,否則預設應以一般佔位內容取代目標的個人身份和內容:
- 使用者明確表示他們擁有目標內容。
- 使用者提供自己的內容來取代它。
- 使用者指示保留特定元素。
目標身份包括:人名、商標名稱、產品名稱、公司名稱、標誌、品牌詞語、個人簡介、聯絡方式、獨特的聲音、分析腳本和任何特定的個人資料。用通用的佔位符取代它們。請使用 personalize-site 來協助根據使用者偏好自訂內容。
保留的素材類型
除非滿足擁有權或許可條件,否則請勿在靜態網站資產資料夾中包含以下素材來源:
- 圖片(照片、插圖、螢幕截圖、Mockup、圖示、徽章、使用者上傳的檔案)。
- 來自 URL 或參考的字型(需要授權)。
- 從目標擷取的 SVG 或圖示(需要授權或遷移至可用的圖示集)。
- 嵌入的 iframe(影片、地圖、社群媒體嵌入)。請使用佔位區塊。
- 影片或音訊檔案。
- 資料擷取或 API 端點。
- 來自目標的供應商或捆綁的 JavaScript 程式碼(除非是相容的開源軟體)。
- 分析或第三方腳本標籤。
對於具有相容授權的開源 CSS/JS 程式碼(例如 normalize.css),可以包含其最小版本,但必須在 EDITING.md 中註明來源和授權。
動畫優先順序
當目標以動畫為核心時,請預設優先處理動畫:
- 先實作開場動畫序列。
- 先取得簽章動畫,然後才是次要的視覺細節。
- 在瀏覽器中進行互動式測試,驗證時機、緩動和視覺流暢度。
- 在目標頁面上進行同框比較,檢查感覺是否匹配。
當動畫是目標的識別性特徵時,不要在沒有適當動畫的情況下視為「完成」。
行動版優先
預設支援行動版和響應式斷點,除非目標單一且僅限桌機版。
- 為行動版重新思考版面。
- 轉換導覽模式(漢堡選單、底部導覽、可折疊側邊欄)。
- 在真實行動版視區內測試互動(點擊、拖曳、側滑)。
- 在觸控裝置上測試捲動和吸附行為。
成功檢查清單
在完成來源檢查、簽章清單和實作迭代之後,將實際驗證留給人類使用者來進行最終比較。不過,在交付之前,請自行檢查以下事項:
- 簽章版面已在輸出中重現。
- 簽章動畫和互動流暢度已在瀏覽器中測試過。
- 頁面地圖包含所有可見的內部路由。
- 頁面之間存在可運作的內部連結。
- 導覽連結使用靜態相對路徑。
- 所有素材都使用靜態相對路徑。
- 無目標特定的文字殘留。
- 無複製的分析腳本。
- CSS 自訂屬性用於主題風格。
- 輸出可透過直接開啟 HTML 檔案運作。
-
EDITING.md存在並詳細說明了結構。 - 首屏的整體感覺與目標匹配(請使用者確認)。
編輯指南
建立一個 EDITING.md 檔案。其結構範例如下:
# 編輯指南
## 頁面地圖
- `index.html` — 首頁
- `projects/index.html` — 專案清單
- `projects/example.html` — 範例專案
- `blog/index.html` — 部落格歸檔
- `blog/example.html` — 範例文章
## 內容位置
- 首頁英雄區塊:`index.html` 第 5-15 行
- 專案資料:`projects/data.json`
- 部落格文章資料:`blog/posts/` 中的 `.json` 檔案
## 已省略的路由
(列出已省略的路由及其原因)
探索日誌(內部)
使用內部分析來計畫實作。除非使用者明確要求,否則不要向使用者暴露完整的探索日誌。請改為在完成探索後,用一兩句話總結發現的要點,特別是與實作相關的部分。