個人化網站
目標
將已生成的靜態網站個人化,使其感覺像使用者自己的網站,而非範本、展示版或複製的參考網站。
此技能編輯內容和元資料。它不會選擇主題、重新設計版面、重現參考網站、遷移大量文章存檔、發佈網站,或將專案轉換到另一個框架。
合約
輸入:
- 現有已生成的靜態網站資料夾、
EDITING.md、頁面地圖或交接備註。 - 使用者提供的身份/內容:自傳、履歷、GitHub README、舊首頁、社交連結、專案、頭像/標誌、聯絡資訊或特定替換項目。
- 現有資料檔、JavaScript 資料區塊、元資料以及要替換的佔位/來源網站內容。
輸出:
- 個人化的可見內容、元資料、連結、圖片以及源碼層級的身份欄位。
- 已移除或替換的範本/展示/來源網站殘留。
- 更新的
EDITING.md,描述已填寫的欄位、剩餘的佔位符以及內容位置。
邊界:
- 不得選擇新主題、重新設計版面、重現新的參考網站、匯入大量寫作存檔、發佈或轉換框架。
- 不得虛構特定的個人事實、雇主、學校、獎項、日期、地點或指標。
- 避免在最終報告中不必要地貼回使用者的私人資料。
成功門檻:
- 使用者提供的身份/內容出現在正確的瀏覽器可見位置。
- 重要的佔位符和來源網站身份已被移除或有意義地記錄。
- 變更的內部連結/資源仍保持頁面相對路徑且有效。
review-static-site能通過,或僅回報可接受的限制。
若門檻未通過:
- 重新盤點 HTML、元資料、資料檔和 JavaScript 渲染的內容。
- 替換遺漏的佔位/來源字串。
- 對於因新內容引起的版面微調問題,使用
edit-site-part。 - 修正後再次執行
review-static-site。
1. 輸入
使用任何可用的材料:
- 靜態網站資料夾,通常是
site/、dist/、out/或public/。 - 來自其他技能的
EDITING.md、頁面地圖或交接備註。 - 使用者提供的自傳、履歷、CV、GitHub README、舊首頁、社交連結、專案清單、頭像、標誌或聯絡資訊。
- 現有資料檔,例如
profile.json、posts.json、projects.json,或assets/script.js中的資料區塊。 - 使用者提供的特定替換指示。
如果缺少重要資訊,請使用清晰的佔位符,而非虛構詳細的個人事實。
2. 內容盤點
在編輯之前,先找出個人或佔位內容所在的位置。
檢查:
- HTML 檔案和子頁面。
<title>、中繼描述、Open Graph/Twitter 元資料、favicon/標誌參考以及可見標題。- 頁首、導航、英雄區、個人資料/關於區塊、聯絡區塊、頁尾、側邊欄、卡片和覆蓋層。
- JSON 檔案、JavaScript 資料區塊或重複的 HTML 清單中的重複內容。
- 文章/詳細示範頁面、專案頁面、筆記頁面、連結頁面和特殊頁面。
EDITING.md的指示以及任何已記錄的內容位置。
尋找常見的佔位或示範文字,例如 your name、[email protected]、example.com、lorem ipsum、sample post、sample project、TODO、replace me 以及類似的字串。
3. 個人身份替換
一致地替換可見和源碼層級的身份欄位。
典型欄位:
- 網站標題、作者姓名、顯示名稱、角色、標語、簡短自傳、位置、可用性/狀態和興趣。
- 電子郵件、社交連結、GitHub、X/Twitter、LinkedIn、Bluesky、RSS、電子報、履歷/CV 以及使用者提供的其他連結。
- 頭像、標誌、favicon、替代文字、圖片說明和个人檔案標籤。
- 首頁英雄區文案、關於頁面文案、聯絡頁面文案、頁尾文字以及中繼描述。
不要虛構特定的雇主、學校、獎項、出版物、指標、地點或年份。如果使用者未提供某項資訊,請保持中立且易於替換。
替換連結或資源時,請保持靜態路徑相容性:
- 保持網站內部連結和資源為頁面相對路徑,而非根目錄絕對路徑。
- 從根頁面,使用像
assets/avatar.png、about.html和posts/example.html這樣的路徑。 - 從巢狀頁面,使用正確的深度,例如
../assets/avatar.png和../index.html。 - 除非網站有意設計為僅伺服器根目錄,且使用者接受直接開啟檔案可能中斷,否則不要為內部連結引入
/assets/...、/posts/...、/images/...、/data/...或/。 - 外部連結(例如 GitHub、LinkedIn、電子郵件和個人網域)可以保留為絕對 URL。
4. 來源網站和範本清理
在個人化風格重現的網站時,預設情況下應移除原始網站的身份和特定來源內容。
替換或移除:
- 原始作者姓名、帳號、網域、電子郵件、社交連結、分析 ID、朋友連結、私人 URL、授權文字、網站統計資料和社群連結。
- 原始文章目錄、文章正文、專案名稱、個人推薦和個人宣稱。
- 從原始網站下載的頭像、封面、螢幕截圖、標誌或其他資源,除非使用者擁有或獲得許可。
保留視覺結構和互動模式,但讓內容明顯屬於使用者,或保持為中立的佔位內容。
5. 內容改編
將使用者的材料改編為網站既有的風格和版面,而不是到處貼上冗長的原始文字。
使用網站的概念來塑造文案:
- 極簡網站:簡潔、平靜、直接。
- 終端機/存檔風格:個人檔案、記錄、狀態、目錄或類似配置的用語。
- Bento 風格:簡短的模組化片段。
- 研究首頁:正式、精確、以專案/出版物為導向。
- 部落格或數位花園:寫作主題、近期筆記、標籤和閱讀路徑。
- 作品集:精選作品、角色、成果、技術棧和連結。
保持文字長度適合現有的容器。如果使用者提供的段落對於卡片來說太長,請進行摘要,並將完整版本放在關於頁面。
優先編輯集中存在的資料來源。如果內容在檔案間重複,請一致地更新所有可見和元資料的副本。
6. 驗證
使用實際可用的互動式瀏覽器工具作為檢查本機預覽並確認個人化內容確實出現在正確位置的首要方法。"可用"意味著它在當前輪次的可用工具清單中。在 Codex 中,這可能是 Browser/應用內瀏覽器外掛(當被路由到該輪次時);在其他代理程式中,可能是等效的可見瀏覽器、browser-use 工具或 devtools 支援的瀏覽器。
如果沒有可呼叫的互動式瀏覽器工具,請不要假設瀏覽器放置檢查已完成。如果視覺放置很重要,請要求使用者啟用或呼叫瀏覽器工具;對於 Codex,可能意味著發送一個明確提及 @browser 的請求。如果使用者未重新路由或用戶端沒有此類工具,則回退到 Playwright、螢幕截圖、靜態審計或原始碼檢查,並說明限制。
當互動式瀏覽器工具實際上可呼叫時,不要預設使用 Playwright 或僅螢幕截圖驗證。僅在沒有互動式瀏覽器工具可呼叫、使用者明確要求,或特別需要可重複的腳本化回歸測試時,才使用 Playwright 作為回退方案。
檢查應顯示使用者資訊的頁面,例如首頁、關於/個人檔案、聯絡方式、專案、連結以及代表性的文章/詳細頁面。確認使用者提供的姓名、標語、自傳、頭像/標誌、聯絡資訊、社交連結、專案名稱和精選項目出現在預期的位置。
同時確認重要的佔位內容或來源網站身份在瀏覽器中不再可見。這是一個內容放置檢查,而非完整的視覺重新設計審查。
如果個人化更改了頭像、favicon、社交圖示、專案連結、文章連結或資料驅動的卡片,請確認變更後的路徑從受影響的頁面深度能夠正常運作,且沒有意外引入根目錄絕對路徑的網站內部連結。
在結束時呼叫或建議使用 review-static-site。
編輯指南
當 EDITING.md 存在時更新它,或者如果網站旨在可重複使用,則建立它。
記錄:
- 哪些個人欄位已被填寫。
- 哪些內容仍僅是佔位符。
- 個人檔案、連結、專案、精選項目、文章、圖片和主題文字現在位於何處。
- 任何已複製到網站內的使用者提供資源及其引用位置。
- 任何有意移除或替換的來源網站內容。
為將來的代理程式和使用者保留此指南,而非作為網站內的行銷文案。
輸出
完成時,簡短報告:
- 哪些個人資訊和頁面已更新。
- 哪些檔案已更改。
- 還有哪些佔位符或特定來源殘留,如果有的話。
review-static-site是否已執行或應在下一步執行。
請勿不必要地貼回使用者的私人個人資料。