從想法到個人網站 是做什麼的?
目標
將個人網站或部落格請求從最初的想法,轉變為經過驗證的本地靜態網站,並可選擇發布到即時 URL。
這是一個使用者導向的端到端管線。它應選擇並串聯既有的專業技能,在每個階段後強制執行閘道檢查,並將故障路由到最小且負責任的技能進行修復,僅在請求的結果確實達到或受阻於缺失的使用者/帳戶動作時才停止。
合約
輸入:
- 使用者想法、參考網址、範本、螢幕截圖、目標風格、個人身分素材、網站資料夾、內容草稿以及可選的發布目標。
- 可選的輸出資料夾、部署平台、儲存庫/帳戶狀態以及自訂網域。
輸出:
- 一個完整的本地靜態網站或更新的現有網站。
- 可選的即時部署或確切的平台步驟/配置(當部署需要使用者帳戶動作時)。
- 簡潔的交接資訊,包含使用的路由、網站資料夾、預覽或即時 URL、執行的驗證、變更的檔案以及剩餘的使用者可編輯內容。
邊界:
- 當某個專業技能適用時,不要直接實作其子技能的細節。
- 除非使用者明確要求該遠端動作,否則不要發布、推送、建立儲存庫/專案、綁定網域或變更 DNS。
- 不要跳過生成、重新建立、個人化、匯入後、大量編輯後或部署前的驗證。
- 當使用者素材缺失時,不要編造詳細的個人事實;使用可編輯的佔位符並記錄它們。
成功閘道:
- 網站達到使用者請求的終點:經過驗證的本地網站、可發布的套件或經過驗證的即時 URL。
- 所有相關階段閘道通過,或未解決的風險已明確陳述並由使用者接受。
若閘道失敗:
- 將故障路由到最小且負責任的技能。
- 重新執行受影響的驗證。
- 僅在缺失內容、缺失憑證、帳戶權限、無法取得的資產或外部平台動作阻止進展時,才詢問使用者。
子技能
將已安裝的技能用作建構模塊:
search-blog-theme:用於方向不明、風格探索或參考選擇。find-style-references:用於將所選方向具體化為真實網站、範本、螢幕截圖以及可建構的設計簡報。make-personal-site:用於從頭建立無依賴的靜態網站。copy-website-style:用於重新建立特定網站、範本、螢幕截圖或視覺系統。personalize-site:用於替換佔位符、複製的身分、後設資料、連結和個人資料內容。add-blog-posts:用於匯入 Markdown、Obsidian 筆記、Word 草稿、舊文章、資產、數學公式、連結和豐富的文章內容。edit-site-part:用於在循環過程中進行有針對性的修復或小幅本地調整。review-static-site:用於確定性驗證和瀏覽器驗證。publish-static-site:用於發布準備或部署。build-personal-site:僅在需要較低層級的路由決策時使用。
不要一次性載入所有子技能。僅在管線到達該階段時,才載入下一個子技能。
預設管線
對於廣泛的「從想法到網站」或「一鍵式個人部落格」請求,使用此封閉循環:
-
釐清終點。 輸入:使用者請求和可用素材。 輸出:路由計劃和預期終點:本地網站、可發布的網站或即時部署。 閘道:網站類型、可用輸入和停止點足夠明確,可供行動。
-
選擇方向。 輸入:想法、品味、範例、受眾或參考素材。 輸出:特定的視覺/網站方向。 閘道:方向足夠具體,可供建構。 如果不清楚:使用
search-blog-theme。 -
將風格具體化為參考。 輸入:所選方向、主題詞彙或使用者範例。 輸出:具體的參考集合和可建構的設計簡報。 閘道:簡報基於多個搜尋角度,且在可能的情況下至少檢查了 3 個強烈參考,並且足夠具體可供建構。 在原始建構之前使用
find-style-references,除非使用者提供了特定的參考網站以進行接近的重新建立。 -
建立或重新建立網站。 輸入:方向或參考 URL/螢幕截圖/範本。 輸出:包含代表性頁面和
EDITING.md的靜態網站資料夾。 閘道:所需的頁面類型存在,且導航指向真實頁面。 對於原始網站使用make-personal-site。 對於特定參考使用copy-website-style。 -
個人化內容。 輸入:生成的網站加上使用者身分、簡歷、連結、專案、頭像、履歷或提供的個人資料素材。 輸出:網站內容和後設資料反映使用者,且已移除複製來源的身分。 閘道:使用者提供的資訊出現在預期區域,且來源/示範殘留物已消失。 當需要替換身分或佔位符時使用
personalize-site。 -
加入寫作。 輸入:生成的或現有的網站加上文章草稿、筆記、Markdown、Word 檔案、圖片資料夾、數學公式、引用和連結。 輸出:文章/詳細頁面、更新的索引、複製的資產以及文章特定的備註。 閘道:文章能正確渲染,附有有效的連結、資產、數學公式、程式碼和響應式佈局。 當提供寫作內容時使用
add-blog-posts。 -
驗證。 輸入:靜態網站根目錄、預期的頁面範圍、禁止的來源字串以及可選的參考 URL。 輸出:通過/失敗報告或修復。 閘道:
review-static-site在路徑、編碼、隱私殘留、頁面類型、瀏覽器渲染、主控台/網路錯誤或行動裝置可用性方面沒有阻礙。 若閘道失敗:使用最小的子技能進行修復,然後重新執行受影響的驗證。 -
發布或準備。 輸入:經過驗證的靜態根目錄加上所需的平台或帳戶限制。 輸出:部署設定/配置、手動步驟或即時 URL。 閘道:部署根目錄正確,且即時或準備好的網站使用了正確的資料夾。 僅在使用者要求發布、部署或準備發布時使用
publish-static-site。 -
交接。 輸入:完成的網站和驗證/部署結果。 輸出:簡潔的最終摘要,包含網站位置、如何預覽或開啟它、驗證了什麼以及使用者接下來可以編輯什麼。
路由捷徑
- 僅有模糊想法:
search-blog-theme->find-style-references->make-personal-site->review-static-site。 - 已選定方向:
find-style-references->make-personal-site-> 若有需要則personalize-site->review-static-site。 - 參考網站/範本/螢幕截圖:
copy-website-style->personalize-site->review-static-site。 - 現有網站加上身分素材:
personalize-site->review-static-site。 - 現有網站加上文章:
add-blog-posts->review-static-site。 - 現有網站加上一個精確的變更:
edit-site-part-> 受影響的瀏覽器驗證,以及若共享結構已變更則review-static-site。 - 發布請求:
review-static-site->publish-static-site。 - 從想法到發布的完整請求:選擇方向 -> 尋找參考 -> 建立/重新建立 -> 個人化 -> 若有提供則加入文章 ->
review-static-site->publish-static-site。
一鍵式預設
當使用者要求一個完整的網站但將選擇留空時:
- 預設為此版本使用純靜態 HTML/CSS/JS。
- 預設輸出資料夾為使用者請求的資料夾,否則為工作區中一個明確的本地
site/資料夾。 - 預設為一個有用的首屏,而不是行銷登陸頁面。
- 對於缺失的個人事實,預設使用可編輯的佔位符。
- 在從品味詞彙開始建構之前,預設先研究真實的風格參考。
- 預設使用頁面相對路徑,以相容於直接開啟、本地 HTTP 和子路徑部署。
- 在任何發布步驟之前,預設進行本地驗證和預覽。
- 如果使用者詢問發布到何處但沒有偏好,則預設引導至 Cloudflare Pages 或 GitHub Pages 的純靜態發布。
閘道循環
在每個階段之後:
- 檢查階段閘道。
- 如果通過,則繼續。
- 如果失敗,則路由到能夠修復它的最小子技能。
- 僅重新執行相關的驗證。
- 繼續直到達到終點或仍有外部阻礙。
常見阻礙處理:
- 缺失個人資訊:保留中性的佔位符並記錄它們,除非使用者想要暫停。
- 缺失文章資產:保留文章,在
EDITING.md中標記缺失的資產,並報告它們。 - 缺失平台登入或權限:準備確切的發布步驟,而不是假裝部署已完成。
- 隱私或路徑阻礙:在發布前修復。
最終報告
保持最終回應簡短:
- 使用的路由。
- 網站資料夾。
- 預覽 URL、本地檔案或即時 URL。
- 建立或更新的主要頁面/內容。
- 執行的驗證。
- 發布狀態和任何需要的使用者動作。
除非使用者要求,否則不要貼上長篇審計日誌。