Communitygithub.com

Gyschuaner/from-idea-to-personal-site

路由並協調個人網站技能套件,用於建立、重建、個人化、新增內容、驗證、編輯或準備靜態個人網站或部落格。當代理需要在主題搜尋、風格參考研究、原始建置、網站風格重建、個人化、文章匯入、審查、本地編輯或發布準備之間做出選擇,或用戶詢問現有網站建置工作流程中的下一步時,請使用此技能。

from-idea-to-personal-site 是什麼?

此技能作為一個編排技能,協調一組專門的子技能(如 `search-blog-theme`、`make-personal-site`、`review-static-site` 等),以實現從構想到發布的可靠靜態個人網站工作流程。它並非實作技能,而是負責根據用戶請求、目前工作階段狀態和品質關卡,路由到最簡短的子技能鏈,直到請求自然結束。此技能支援多種平台(GitHub Pages、Cloudflare Pages、Netlify、Vercel),並強調在產生、重建、個人化或文章匯入後,強制通過 `review-static-site` 進行品質驗證。其核心優勢在於避免不必要的子技能執行,專注於選擇正確的路徑,並在失敗時將問題路由到最小的責任子技能,從而維持高效且可靠的開發流程。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/Gyschuaner/from-idea-to-personal-site/tree/HEAD/.agents/skills/build-personal-site

在你喜歡的 AI 中提問

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

說明文件

建立個人網站

目標

協調個人網站技能套件,形成可靠的工作流程。

這是一個編排技能,而非實作技能。它應路由到正確的專業技能,執行品質關卡,並持續推動工作流程,直到當前請求達到其自然的終點。

請勿重複子技能中的詳細實作規則。當達到子技能的步驟時,請載入並遵循該子技能。

對於用戶面向的「從構想到個人網站」或一鍵啟動請求,請優先使用 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;在發布前修復路徑關卡失敗

標準管線

從構想到原創網站

當用戶只有粗略的目標或風格偏好時使用。

  1. 如果視覺方向不明確,使用 search-blog-theme。
  2. 使用 find-style-references 將所選方向落實到真實網站/範本/螢幕截圖中。
  3. 使用 make-personal-site 建立靜態網站。
  4. 如果用戶提供了身分/內容,或網站有應填寫的佔位符,則使用 personalize-site。
  5. 使用 review-static-site 作為嚴格的品質檢查關卡。
  6. 除非請求發布,否則以本地預覽指示結束。

從參考到個人網站

當用戶提供要匹配的目標 URL、螢幕截圖、v0 範本、Figma 設計或現有網站時使用。

  1. 使用 copy-website-style 重建佈局、動畫、頁面類型和互動。
  2. 使用 personalize-site 替換目標身分和佔位符內容。
  3. 如果用戶提供了寫作內容,則使用 add-blog-posts。
  4. 使用 review-static-site 作為嚴格的品質檢查關卡。
  5. 除非請求發布,否則以本地預覽指示結束。

內容優先的部落格

當用戶最強的輸入是文章、筆記、Markdown、Word 檔案或舊寫作檔案時使用。

  1. 僅在沒有網站/主題存在時使用 search-blog-theme。
  2. 如果需要新的原創視覺系統,則使用 find-style-references。
  3. 如果尚無靜態網站,則使用 make-personal-site。
  4. 使用 add-blog-posts 將內容匯入現有網站的文章系統。
  5. 如果身分/個人資料內容仍然通用,則使用 personalize-site。
  6. 使用 review-static-site 作為嚴格的品質檢查關卡。
  7. 除非請求發布,否則以本地預覽指示結束。

現有網站改進

當用戶已經有一個生成的網站資料夾時使用。

  1. 檢查網站和存在的 EDITING.md。
  2. 對於身分/內容替換,使用 personalize-site。
  3. 對於文章匯入,使用 add-blog-posts。
  4. 對於有焦點的設計或文案更改,使用 edit-site-part。
  5. 當更改影響導航、頁面類型、資產、編碼、發布準備或多於一個頁面時,使用 review-static-site。

發布就緒的網站

當用戶要求發布或部署時使用。

  1. 首先使用 review-static-site。
  2. 如果審查發現問題,則修復阻礙因素或路由到相關的子技能。
  3. 僅在網站通過必要的本地檢查或用戶接受已知風險後,才使用 publish-static-site。
  4. 部署發生時驗證即時 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 重新驗證。

如果阻礙因素明確是缺失的用戶輸入、缺少憑證、無法取得的遠端資產或需要外部帳戶操作,則停止並報告,不要嘗試虛構解決方案。

Individual skills in this repo

This repo contains 10 individual skills — each has its own dedicated page.

Gyschuaner/from-idea-to-personal-site

Use this skill to add, import, or migrate one or more blog posts, notes, essays, articles, Markdown files, Word documents, or rich-content writing folders into an existing static personal website or blog while preserving the site's current article style, content structure, navigation, indexes, archives, tags, assets, math, links, tables, code blocks, embeds, and homepage entry points. Use it for pasted posts, local Markdown files, Obsidian notes, .docx drafts, old static HTML posts, exported blog content, or small-to-medium batches of posts after a site has already been created.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to recreate, copy, clone, remix, or closely match the look, layout, motion, or interaction feel of a specific website, URL, screenshot, or template using plain HTML, CSS, and JavaScript. Use it to inspect public source as research, rewrite original code, avoid direct reuse of protected assets, and validate the result in a browser.

Gyschuaner/from-idea-to-personal-site

Use this skill to make focused, small-scope edits to a generated static website, personal blog, portfolio, digital garden, or style recreation. Use it when the user wants to adjust one page section, component, visual detail, copy block, responsive issue, or lightweight interaction without rebuilding the whole site. Typical requests include changing a hero block, card layout, sidebar, footer, button, mobile menu, spacing, color, typography, animation intensity, or a small piece of page copy.

Gyschuaner/from-idea-to-personal-site

Use this skill after a personal website or blog style direction is roughly known and before building an original site. It searches for real websites, templates, portfolios, blogs, screenshots, or design examples that match the chosen direction, inspects them with browser or screenshot tools when available, and turns the findings into a practical design reference brief for make-personal-site. Use it for requests like finding references for a natural technical blog, cozy research homepage, brutalist portfolio, digital garden, minimal notes site, or any named visual direction that still needs concrete examples.

Gyschuaner/from-idea-to-personal-site

Run the complete idea-to-personal-website or blog workflow. Use when the user wants a one-click or end-to-end pipeline from a vague idea, reference URL, template, personal materials, style direction, or writing drafts to concrete style references, a validated static personal site, and optionally a live deployment on GitHub Pages, Cloudflare Pages, Netlify, or Vercel.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to create, implement, redesign, or update a zero-dependency personal website, personal blog, homepage, portfolio, research homepage, or digital garden using plain HTML, CSS, and JavaScript. Use it after a theme direction has been chosen, or when the user wants a no-framework site that can be opened directly in the browser and deployed as static files.

Gyschuaner/from-idea-to-personal-site

Use this skill to turn a generated static personal website, blog, portfolio, digital garden, or style recreation into the user's own site by replacing placeholder identity, profile copy, links, projects, featured items, contact details, metadata, and demo page content. Use it after make-personal-site or copy-website-style, or when a user provides an existing static site folder and personal materials such as a bio, resume, README, GitHub profile, old homepage, Markdown notes, or social links.

Gyschuaner/from-idea-to-personal-site

Publish, deploy, or prepare a finished static personal website, blog, portfolio, or style recreation for hosting on GitHub Pages, Cloudflare Pages, Netlify, or Vercel. Use when the user asks to publish a static site, configure deployment settings, add GitHub Pages workflows, choose a static hosting platform, prepare a repo for Pages/Cloudflare/Netlify/Vercel, verify a deployed URL, or explain how to deploy a site folder such as site/, dist/, out/, public/, or docs/.

Gyschuaner/from-idea-to-personal-site

Use this skill to inspect, validate, QA, or sanity-check a generated static website, personal blog, portfolio, digital garden, or style recreation before handoff or publishing. Use it for local folders such as site/, dist/, out/, or public/ to check broken links, missing page types, browser rendering, console errors, desktop/mobile screenshots, UTF-8 source readability, mojibake, relative asset paths, direct-open/file compatibility, placeholder content, and leftover copied source-specific text.

Gyschuaner/from-idea-to-personal-site

Use this skill when the user wants to find, compare, choose, or adapt a visual theme for a personal blog, personal homepage, portfolio, research homepage, digital garden, or static website. Use it to turn references from v0, Figma, GitHub themes, existing websites, screenshots, keywords, or natural-language taste preferences into natural, practical theme recommendations.

相關技能