Communitygithub.com

zijieguo2003/blog-builder-skill

從零開始快速建立個人部落格的指南。涵蓋框架選擇(Hugo、Hexo、Astro、Next.js)、主題設定、部落格文章範本生成(含 frontmatter)、部署至 GitHub Pages / Vercel / Cloudflare Pages,以及完整的 SEO 設定(sitemap、robots.txt、Open Graph、標準網址)。

blog-builder-skill 是什麼?

這個技能提供了一個完整的個人部落格建置流程,從框架選擇到上線部署並完成 SEO 設定。它會根據使用者的技術背景(非技術人員、JavaScript 開發者、Python 開發者等)和既有網站狀態,推薦最合適的靜態網站生成器(如 Hugo、Hexo、Astro、Next.js),並引導完成主題安裝與設定。接著,技能會根據所選框架提供對應的參考檔案(參考資料夾中的 .md 文件),協助使用者生成包含完整 frontmatter 的文章範本,並生成可直接提交的 GitHub Actions CI/CD YAML 設定檔,支援 GitHub Pages、Vercel 與 Cloudflare Pages 三種部署方式。最後,技能會協助設定完整的 SEO,包含 sitemap.xml、robots.txt、Open Graph 標籤與標準網址,確保部落格在搜尋引擎中有良好的曝光。本技能支援所有主流靜態部落格框架,適合任何想快速建立並最佳化部落格的使用者。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add zijieguo2003/blog-builder-skill

在你喜歡的 AI 中提問

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

說明文件

部落格建置器

協助使用者從選擇框架開始,到完成正式上線並附帶正確的 SEO 設定,打造個人部落格。完整範圍:框架選擇 -> 主題 -> 文章範本 -> 部署 -> SEO。

工作流程

步驟 1 – 了解使用者背景

詢問(或從對話中推測):

  • 技術背景?(非技術人員 / JavaScript 開發者 / Python 開發者 / 其他)
  • 從零開始還是已有現有網站?
  • 偏好的部署目標:GitHub Pages、Vercel、Cloudflare Pages?
  • 內容方向:寫作、作品集、教學部落格、技術文件?

步驟 2 – 推薦框架

情況推薦
非技術人員,只想寫文章Hugo – 零 JavaScript、速度快、主題庫豐富
已經會寫 JavaScript/TypeScript,想要元件控制Astro – Islands 架構,優秀開發者體驗
喜愛主題生態系統,熟悉 NodeHexo – 成熟的外掛生態系統
React 開發者,想要完全控制Next.js – App Router + MDX

附上簡短推薦理由。在繼續前請先確認。

步驟 3 – 框架設定

閱讀對應的參考檔案,引導使用者進行安裝並套用起始主題:

框架參考檔案
Hugoreferences/hugo.md
Hexoreferences/hexo.md
Astroreferences/astro.md
Next.jsreferences/nextjs.md

步驟 4 – 生成文章範本

產出一份立即可用的文章範本檔案,附帶完整的 frontmatter。 位於 assets/post-templates/ 的範本檔案是起點——請根據使用者選擇的主題和偏好進行複製與調整。

步驟 5 – 部署

閱讀 references/deployment.md 以取得適當的 CI/CD 工作流程。提供完整的 GitHub Actions YAML 設定檔,準備好即可提交。

關鍵注意事項:

  • GitHub Pages:將檔案推送到 .github/workflows/deploy.yml;在儲存庫設定中啟用 Pages
  • Vercel:在控制台中連接儲存庫;設定框架預設值與輸出目錄
  • Cloudflare Pages:建置指令 = npm run build,輸出目錄 = dist(Astro/Hexo/Next.js)或 public(Hugo)

步驟 6 – SEO 設定

每個部落格都需要:

  1. sitemap.xml – 因框架而異;請參見 references/.md
  2. robots.txt – 提供實際檔案內容,而非僅描述
  3. Open Graph 標籤 – og:title、og:description、og:image、og:url 的實際標記
  4. 標準網址 – 在設定檔中設定 baseURL / site,使 sitemap 與 OG 標籤正確運作

務必提醒:網站網址必須在框架設定檔中設定,sitemap 才能產生正確的絕對網址。

指導原則

  • 提供實際的檔案內容(程式碼、YAML、TOML),而非僅描述
  • 只包含必要的欄位——避免過多樣板
  • 點出一兩個最常見的陷阱(例如 Hugo 的 baseURL、Astro 的 site 欄位)
  • 偏好可複製貼上的範例

相關技能