建立個人網站
目標
協調個人網站技能套件,形成可靠的工作流程。
這是一個編排技能,而非實作技能。它應路由到正確的專業技能,執行品質關卡,並持續推動工作流程,直到當前請求達到其自然的終點。
請勿重複子技能中的詳細實作規則。當達到子技能的步驟時,請載入並遵循該子技能。
對於用戶面向的「從構想到個人網站」或一鍵啟動請求,請優先使用 from-idea-to-personal-site。當下一步或子技能選擇是主要問題時,請將此技能用作較低級別的路由協調器。
合約
輸入:
- 用戶請求、網站資料夾或所需的輸出資料夾、參考資料、身分資料、內容資料,以及可選的發布目標。
- 當用戶詢問下一步操作時的當前工作流程狀態。
輸出:
- 選定的工作流程路由和執行的子技能。
- 根據請求,輸出本地靜態網站、驗證過的現有網站、匯入的內容、有針對性的編輯或發布準備。
- 交接摘要,包含網站資料夾、預覽/發布狀態、已執行的驗證以及剩餘的手動步驟。
邊界:
- 當專業子技能適用時,請勿直接實作子技能的細節。
- 預設情況下,請勿執行每個子技能;選擇滿足請求的最短路徑。
- 除非明確要求,否則請勿發布、推送、建立專案、綁定網域或更改 DNS。
- 在生成、重建、個人化、文章匯入或廣泛編輯後,請勿跳過
review-static-site。
成功關卡:
- 選定的子技能鏈達到用戶的自然終點:已選定方向、網站已建立、內容已新增、網站已驗證、編輯已完成,或部署已準備/執行。
- 必須的品質關卡已通過,或用戶明確接受已記錄的限制。
如果關卡失敗:
- 將失敗的關卡路由到最小的責任子技能。
- 重新執行受影響的驗證。
- 僅在缺少用戶內容、缺少憑證、無法取得資產或需要外部帳戶操作而無法繼續時,才停止並報告阻礙因素。
子技能
將這些技能用作工作流程建置區塊:
search-blog-theme:發現並比較個人網站/部落格主題方向。find-style-references:搜尋並檢查真實網站/範本/螢幕截圖,以獲取所選方向,並產出可用於建置的參考簡報。make-personal-site:建立一個零依賴的原創靜態個人網站。copy-website-style:重建特定參考網站的風格、佈局、動畫和頁面類型。personalize-site:將佔位符/演示/來源身分替換為用戶自己的內容。add-blog-posts:將 Markdown、Obsidian 筆記、Word 草稿、舊 HTML 文章、圖片、連結和其他寫作內容匯入現有網站。edit-site-part:對特定區塊、元件、文案區塊、樣式細節或互動進行有焦點的本地更改。review-static-site:驗證靜態輸出,檢查連結、頁面類型、瀏覽器渲染、編碼、殘留佔位符、直接開啟相容性和路徑正確性。publish-static-site:準備或執行部署到 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel。
如果子技能名稱更改,請優先使用具有匹配用途的本地安裝技能。
子技能合約矩陣
使用此矩陣來決定交接和修復循環:
| 子技能 | 必要輸入 | 預期輸出 | 成功關卡 | 如果關卡失敗 |
|---|---|---|---|---|
search-blog-theme | 用戶品味、目的、參考資料或關鍵字 | 3-5 個方向、已驗證的參考 URL、一個建議 | 方向足夠具體以進行建置 | 搜尋更多參考資料、強化比喻或詢問一個偏好問題 |
find-style-references | 所選風格方向、網站類型、氛圍詞語或範例 | 4-8 個真實參考資料、瀏覽器觀察、可用於建置的設計簡報 | 盡可能從多個搜尋角度進行,並檢查至少 3 個強參考資料 | 擴大搜尋範圍、檢查更強的參考資料,或返回 search-blog-theme |
make-personal-site | 方向、內容/個人資料提示、頁面範圍、輸出資料夾 | 具有代表性頁面、資產和 EDITING.md 的純靜態網站 | 必需的頁面類型、相對路徑、UTF-8 原始碼、本地預覽 | 修正結構/路徑/資產,然後執行 review-static-site |
copy-website-style | 目標 URL/螢幕截圖/範本和範圍 | 具有頁面對映表、佔位符/用戶內容和 EDITING.md 的靜態風格重建 | 簽名佈局/動畫/頁面類型符合要求的保真度 | 重新檢查目標、迭代重建,然後執行 review-static-site |
personalize-site | 現有網站加上用戶身分/內容 | 已替換的身分、連結、元資料、資產、佔位符/來源清理 | 用戶內容可見且殘留物已移除 | 重新盤點內容位置,或使用 edit-site-part 進行佈局調整 |
add-blog-posts | 現有網站加上來源文章/資產 | 新的文章頁面、更新的索引/資料、複製的資產、編輯筆記 | 文章可渲染、連結/資產/數學/富文本內容正常運作 | 修正轉換/索引/資產,或使用 edit-site-part 解決本地呈現問題 |
edit-site-part | 現有網站加上目標頁面/區域/更改 | 小範圍的程式碼/內容/樣式/互動編輯 | 相同瀏覽器區域顯示請求的更改,且未造成無關的損壞 | 重新對應來源並進行更小的修正編輯 |
review-static-site | 靜態根目錄、預期範圍、可選的禁止字串/參考資料 | 發現或修正、稽核/瀏覽器結果、通過/失敗狀態 | 沒有遺留的阻礙因素 | 將阻礙因素路由到最小的責任子技能 |
publish-static-site | 已驗證的部署根目錄加上選擇的平台/模式 | 部署設定/配置、可選的即時 URL、部署後檢查 | 正確的資料夾已部署且即時 URL 可運作 | 修正本地阻礙因素、部署設定或帳戶/DNS 步驟 |
操作原則
- 先路由,再執行。在進行廣泛編輯之前,決定正確的鏈結。
- 確保每個步驟的輸出可供下一步使用。
- 除非用戶明確要求其他技術棧,否則在此版本中優先使用純 HTML/CSS/JS 和零依賴。
- 請勿將個人網站或部落格變成行銷登陸頁面。
- 當用戶資料缺失時,請勿虛構詳細的個人事實。
- 在風格重建中,預設情況下應替換複製的來源網站身分。
- 預設情況下使用頁面相對連結和資產;避免使用根目錄絕對路徑的網站本地路徑,例如
/assets/...或/posts/...。 - 在任何生成、重建、個人化、文章匯入或廣泛編輯之後,使用
review-static-site進行驗證。 - 除非用戶明確要求發布,否則停在本地驗證過的網站。
- 除非用戶明確要求,否則請勿建立儲存庫、推送程式碼、部署、綁定網域或更改 DNS。
接收
僅收集下一個決策所需的資訊。請勿過度訪談用戶。
有用的輸入:
- 所需的輸出資料夾或現有網站資料夾。
- 用戶是想要新網站、重建參考網站、匯入內容、個人化、本地編輯、驗證還是發布。
- 參考 URL、螢幕截圖、範本或主題詞語。
- 用戶身分資料:姓名、簡介、連結、履歷、專案、頭像/標誌、舊首頁、GitHub 個人資料。
- 內容資料:Markdown、Obsidian 筆記、Word 文件、舊文章、圖片資料夾或貼上文字。
- 發布目標:GitHub Pages、Cloudflare Pages、Netlify、Vercel 或僅提供指引。
如果請求足夠明確,請繼續。僅當多個路由可能產生截然不同的工作時,才提出一個簡潔的問題。
路由
根據用戶的當前狀態選擇工作流程:
- 模糊的想法或「幫我找個風格」:在原始建置之前,使用
search-blog-theme,然後使用find-style-references。 - 已選定方向且沒有特定目標網站:使用
find-style-references,然後使用make-personal-site。 - 特定的目標 URL/螢幕截圖/範本需要緊密匹配:使用
copy-website-style。 - 現有生成的網站仍有佔位符或複製的身分:使用
personalize-site。 - 現有網站加上新文章/筆記/文件:使用
add-blog-posts。 - 現有網站加上一個小的視覺/文案/佈局/互動更改:使用
edit-site-part。 - 「檢查這個網站」、「這樣夠好嗎?」、「發布前檢查」:使用
review-static-site。 - 「部署」、「發布」、「GitHub Pages」、「Cloudflare Pages」、「Netlify」、「Vercel」:在
review-static-site之後使用publish-static-site。
當用戶要求完整的一鍵建置時,選擇處理真實輸入的最短路徑。請勿因為它存在就執行每個子技能。
路由範例
使用這些範例來穩定路由:
| 用戶請求模式 | 路由 |
|---|---|
| 「我想要一個獨特的個人部落格,幫我選擇一個風格」 | search-blog-theme |
| 「在建置之前,為這個選擇的風格找一些真實的參考資料」 | find-style-references |
| 「根據這個選擇的方向幫我建立一個個人網站」 | find-style-references -> make-personal-site -> review-static-site |
| 「從頭開始建立一個完整的個人部落格」 | 如果需要 search-blog-theme -> find-style-references -> make-personal-site -> 如果內容存在則 personalize-site -> review-static-site |
| 「將這個 URL 作為參考並重建它」 | copy-website-style -> personalize-site -> review-static-site |
| 「複製這個網站,但將該人的內容替換為我的」 | copy-website-style -> personalize-site -> review-static-site |
| 「這是我生成的網站,用我的簡介/專案/連結替換佔位符」 | personalize-site -> review-static-site |
| 「將這篇 Markdown/Obsidian/Word 文章新增到網站」 | add-blog-posts -> review-static-site |
| 「更改這個區塊/顏色/標題/卡片/選單」 | edit-site-part;僅在共享結構或資產更改時新增 review-static-site |
| 「檢查這個網站是否準備好了」 | review-static-site |
| 「將此部署到 Cloudflare Pages/GitHub Pages/Netlify/Vercel」 | review-static-site -> publish-static-site |
| 「它在本地通過 HTTP 可以正常運作,但雙擊 index.html 卻不行」 | review-static-site;在發布前修復路徑關卡失敗 |
標準管線
從構想到原創網站
當用戶只有粗略的目標或風格偏好時使用。
- 如果視覺方向不明確,使用
search-blog-theme。 - 使用
find-style-references將所選方向落實到真實網站/範本/螢幕截圖中。 - 使用
make-personal-site建立靜態網站。 - 如果用戶提供了身分/內容,或網站有應填寫的佔位符,則使用
personalize-site。 - 使用
review-static-site作為嚴格的品質檢查關卡。 - 除非請求發布,否則以本地預覽指示結束。
從參考到個人網站
當用戶提供要匹配的目標 URL、螢幕截圖、v0 範本、Figma 設計或現有網站時使用。
- 使用
copy-website-style重建佈局、動畫、頁面類型和互動。 - 使用
personalize-site替換目標身分和佔位符內容。 - 如果用戶提供了寫作內容,則使用
add-blog-posts。 - 使用
review-static-site作為嚴格的品質檢查關卡。 - 除非請求發布,否則以本地預覽指示結束。
內容優先的部落格
當用戶最強的輸入是文章、筆記、Markdown、Word 檔案或舊寫作檔案時使用。
- 僅在沒有網站/主題存在時使用
search-blog-theme。 - 如果需要新的原創視覺系統,則使用
find-style-references。 - 如果尚無靜態網站,則使用
make-personal-site。 - 使用
add-blog-posts將內容匯入現有網站的文章系統。 - 如果身分/個人資料內容仍然通用,則使用
personalize-site。 - 使用
review-static-site作為嚴格的品質檢查關卡。 - 除非請求發布,否則以本地預覽指示結束。
現有網站改進
當用戶已經有一個生成的網站資料夾時使用。
- 檢查網站和存在的
EDITING.md。 - 對於身分/內容替換,使用
personalize-site。 - 對於文章匯入,使用
add-blog-posts。 - 對於有焦點的設計或文案更改,使用
edit-site-part。 - 當更改影響導航、頁面類型、資產、編碼、發布準備或多於一個頁面時,使用
review-static-site。
發布就緒的網站
當用戶要求發布或部署時使用。
- 首先使用
review-static-site。 - 如果審查發現問題,則修復阻礙因素或路由到相關的子技能。
- 僅在網站通過必要的本地檢查或用戶接受已知風險後,才使用
publish-static-site。 - 部署發生時驗證即時 URL。
品質關卡
在相關關卡通過或用戶接受明確的限制之前,工作流程尚未完成。
主題關卡:
- 視覺方向或參考資料足夠具體以進行建置。
- 如果建置是原創的並且基於品味詞語,則應從多個角度搜尋真實的風格參考資料,並在可能的情況下檢查至少 3 個強參考資料,或者用戶明確放棄了該步驟。
- 所選方法符合用戶的網站類型:部落格、作品集、研究首頁、數位花園、筆記、連結或混合型。
結構關卡:
- 必需的頁面類型存在,而不僅僅是首頁。
- 類似部落格的網站包括至少一個文章/詳細頁面和一個列表/歸檔入口點。
- 導航指向真實生成的頁面。
內容關卡:
- 用戶提供的身分/內容出現在預期的位置。
- 僅顯示佔位符的內容已清楚標記或替換。
- 複製的來源網站身分已從風格重建中移除,除非用戶擁有它或擁有權限。
路徑關卡:
- 預設情況下,網站本地連結和資產使用頁面相對路徑。
- 巢狀頁面使用正確的
../深度。 - HTML、CSS
url(...)、JavaScript 生成的連結、資料檔案、封面圖片、字型以及廠商資產應避免意外的根目錄絕對路徑。 - 直接開啟
index.html不應遺失 CSS、JS、圖片或導航。
編碼關卡:
- 所有來源檔案使用 UTF-8 編碼(無 BOM)。
- 非 ASCII 字元(變音符號、中文、表情符號等)在文字內容中正確顯示,且在程式碼註解中相容。
- 無編碼警告或亂碼出現。
預覽關卡(本地):
- 可以通過本地 HTTP 伺服器或直接檔案存取來預覽網站。
- 瀏覽器渲染時無主控台錯誤或資源載入失敗。
- 所有內部導航路徑在靜態預覽中正常工作。
發布關卡(僅當明確請求時):
review-static-site傳回路徑、結構和內容通過的結果,或用戶接受失敗。- 所選平台的部署配置是有效的。
- 即時 URL 在部署後可存取且正確渲染。
失敗處理
品質關卡失敗後的路由規則:
- 路徑失敗:如果根目錄絕對路徑或頁面相對深度中斷資源,則路由到
edit-site-part以修復樣式/腳本/圖片路徑;如果影響多個頁面,則路由到make-personal-site或copy-website-style以進行結構重寫。 - 內容失敗:如果殘留身分或佔位符,則路由到
personalize-site。 - 文章失敗:如果連結、圖片、數學或渲染中斷,則路由到
add-blog-posts;如果資產或佈局需要調整,則路由到edit-site-part。 - 結構失敗:如果導航、索引或歸檔不完整,則路由到
make-personal-site或copy-website-style(取決於網站來源),以填寫缺失的頁面。 - 部署失敗:路由到
publish-static-site,並在必要時加上明確的平台設定步驟。 - 多個失敗:一次處理一個,從結構或路徑開始。在重新路由到下一個子技能之前,請使用
review-static-site重新驗證。
如果阻礙因素明確是缺失的用戶輸入、缺少憑證、無法取得的遠端資產或需要外部帳戶操作,則停止並報告,不要嘗試虛構解決方案。