Communitygithub.com

從想法到個人網站

執行從模糊構想到個人網站或部落格的完整工作流程。當使用者想要一鍵式或端到端的流程,從想法、參考網址、模板、個人素材、風格方向或寫作草稿,到具體的風格參考、經過驗證的靜態個人網站,並可選擇在 GitHub Pages、Cloudflare Pages、Netlify 或 Vercel 上進行即時部署。

從想法到個人網站 是什麼?

此技能將個人網站或部落格的請求,從最初的想法引導至經過驗證的本地靜態網站,並可選擇發布到線上 URL。它是一個使用者導向的端到端管線,會選擇並串聯既有的專業子技能,在每個階段後強制執行閘道檢查,並將故障路由到最小且最相關的子技能進行修復,直到達成請求的目標或因缺少使用者操作而受阻為止。此技能支援多種路由捷徑,例如單純的想法、具體的風格方向、參考網站或範本、現有網站加上身分素材或文章,以及發布請求。它預設使用純靜態 HTML/CSS/JS,並提供一鍵式預設選項,例如預設輸出資料夾為 `site/`,預設研究真實的風格參考,並在部署前進行本地驗證和預覽。此技能依賴多個子技能,如 `search-blog-theme`、`find-style-references`、`make-personal-site`、`copy-website-style`、`personalize-site`、`add-blog-posts`、`edit-site-part`、`review-static-site` 和 `publish-static-site`。

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

在你喜歡的 AI 中提問

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

說明文件

從想法到個人網站 是做什麼的?

目標

將個人網站或部落格請求從最初的想法,轉變為經過驗證的本地靜態網站,並可選擇發布到即時 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:僅在需要較低層級的路由決策時使用。

不要一次性載入所有子技能。僅在管線到達該階段時,才載入下一個子技能。

預設管線

對於廣泛的「從想法到網站」或「一鍵式個人部落格」請求,使用此封閉循環:

  1. 釐清終點。 輸入:使用者請求和可用素材。 輸出:路由計劃和預期終點:本地網站、可發布的網站或即時部署。 閘道:網站類型、可用輸入和停止點足夠明確,可供行動。

  2. 選擇方向。 輸入:想法、品味、範例、受眾或參考素材。 輸出:特定的視覺/網站方向。 閘道:方向足夠具體,可供建構。 如果不清楚:使用 search-blog-theme。

  3. 將風格具體化為參考。 輸入:所選方向、主題詞彙或使用者範例。 輸出:具體的參考集合和可建構的設計簡報。 閘道:簡報基於多個搜尋角度,且在可能的情況下至少檢查了 3 個強烈參考,並且足夠具體可供建構。 在原始建構之前使用 find-style-references,除非使用者提供了特定的參考網站以進行接近的重新建立。

  4. 建立或重新建立網站。 輸入:方向或參考 URL/螢幕截圖/範本。 輸出:包含代表性頁面和 EDITING.md 的靜態網站資料夾。 閘道:所需的頁面類型存在,且導航指向真實頁面。 對於原始網站使用 make-personal-site。 對於特定參考使用 copy-website-style。

  5. 個人化內容。 輸入:生成的網站加上使用者身分、簡歷、連結、專案、頭像、履歷或提供的個人資料素材。 輸出:網站內容和後設資料反映使用者,且已移除複製來源的身分。 閘道:使用者提供的資訊出現在預期區域,且來源/示範殘留物已消失。 當需要替換身分或佔位符時使用 personalize-site。

  6. 加入寫作。 輸入:生成的或現有的網站加上文章草稿、筆記、Markdown、Word 檔案、圖片資料夾、數學公式、引用和連結。 輸出:文章/詳細頁面、更新的索引、複製的資產以及文章特定的備註。 閘道:文章能正確渲染,附有有效的連結、資產、數學公式、程式碼和響應式佈局。 當提供寫作內容時使用 add-blog-posts。

  7. 驗證。 輸入:靜態網站根目錄、預期的頁面範圍、禁止的來源字串以及可選的參考 URL。 輸出:通過/失敗報告或修復。 閘道:review-static-site 在路徑、編碼、隱私殘留、頁面類型、瀏覽器渲染、主控台/網路錯誤或行動裝置可用性方面沒有阻礙。 若閘道失敗:使用最小的子技能進行修復,然後重新執行受影響的驗證。

  8. 發布或準備。 輸入:經過驗證的靜態根目錄加上所需的平台或帳戶限制。 輸出:部署設定/配置、手動步驟或即時 URL。 閘道:部署根目錄正確,且即時或準備好的網站使用了正確的資料夾。 僅在使用者要求發布、部署或準備發布時使用 publish-static-site。

  9. 交接。 輸入:完成的網站和驗證/部署結果。 輸出:簡潔的最終摘要,包含網站位置、如何預覽或開啟它、驗證了什麼以及使用者接下來可以編輯什麼。

路由捷徑

  • 僅有模糊想法: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 的純靜態發布。

閘道循環

在每個階段之後:

  1. 檢查階段閘道。
  2. 如果通過,則繼續。
  3. 如果失敗,則路由到能夠修復它的最小子技能。
  4. 僅重新執行相關的驗證。
  5. 繼續直到達到終點或仍有外部阻礙。

常見阻礙處理:

  • 缺失個人資訊:保留中性的佔位符並記錄它們,除非使用者想要暫停。
  • 缺失文章資產:保留文章,在 EDITING.md 中標記缺失的資產,並報告它們。
  • 缺失平台登入或權限:準備確切的發布步驟,而不是假裝部署已完成。
  • 隱私或路徑阻礙:在發布前修復。

最終報告

保持最終回應簡短:

  • 使用的路由。
  • 網站資料夾。
  • 預覽 URL、本地檔案或即時 URL。
  • 建立或更新的主要頁面/內容。
  • 執行的驗證。
  • 發布狀態和任何需要的使用者動作。

除非使用者要求,否則不要貼上長篇審計日誌。

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

Route and coordinate the personal website skill suite for creating, recreating, personalizing, adding content to, validating, editing, or preparing a static personal website or blog. Use when the agent needs to choose between theme search, style reference research, original build, website style recreation, personalization, post import, review, local edits, or publishing preparation, or when the user asks what step comes next in an existing site-building workflow.

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

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.

相關技能