Communitygithub.com

個人部落格風格引導工作坊

協助非程式設計者使用 Codex 建立、啟動和維護個人部落格或作品集網站。透過組合現成的靜態模板、Markdown 內容、基於 Git 的 CMS 工具、部署平台以及迭代式的視覺風格探索對話來達成。當使用者想要「隨興編碼」建立個人部落格、逐步透過問答與風格看板探索偏好風格、設定無程式碼發布流程、將個人寫作遷移至部落格、選擇 Astro/HugoBlox/Pages CMS 路線、修復已產生的部落格專案,或為非技術使用者建立可重複使用的部落格建置工作流程時,即可使用此技能。

個人部落格風格引導工作坊 是什麼?

這是一個專為非程式設計者設計的個人部落格建置技能,能讓使用者透過自然語言與 Codex 互動,無需具備 Git、Node.js 或部署知識即可建立、啟動和維護網站。它提供一套經過驗證的工具組合(預設為 Astro、HugoBlox、Pages CMS 及 GitHub Pages / Cloudflare Pages),並透過結構化的流程逐步引導:先分類任務、詢問必要問題、探索視覺風格、產生建置簡報、逐步建置或修復、確保維護流程顯而易見,最後進行驗證與交接。此技能避免了從零開始撰寫程式碼或強加設計風格的常見陷阱,而是透過方向卡和風格簡報來發現使用者的品味,並確保最終產出是一個可被非技術使用者輕鬆維護的「無趣」架構。適用於 Claude Code、Codex 等支援技能系統的 AI 代理平台。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add Puss-M/personal-blog-vibe-harness

在你喜歡的 AI 中提問

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

說明文件

個人部落格風格引導工作坊 是做什麼的?

操作目標

引導 Codex 扮演一個耐心且務實的個人部落格建置工作流程。最終使用者不需要了解 Git、Node、Hugo、Frontmatter、建置日誌、部署設定或視覺設計詞彙,就能獲得一個可維護的網站。

不要重新發明部落格框架、CMS 或託管平台。組合成熟的工具,保持架構簡單乏味,並讓每一步交接文件對非程式設計者可讀。

不要替新部落格默默強加某種視覺風格。在實作版型之前,透過簡短提問、方向選項和預覽來發掘使用者的品味。

預設技術棧

除非本地證據指向其他選項,否則優先採用此路線:

  1. 對於簡單的個人部落格、寫作檔案、電子報或輕量級作品集,使用 Astro 入門套件。
  2. 對於學術、研究、履歷、實驗室、技術作品集或大量 Markdown 的專業網站,使用 HugoBlox 入門套件。
  3. 當使用者需要瀏覽器 UI 來編輯內容時,使用 Pages CMS 進行基於儲存庫的內容編輯。
  4. 對於 GitHub 原生免費部署,使用 GitHub Pages;若使用者已使用 Cloudflare 或想要自訂網域路徑,則使用 Cloudflare Pages。

在做出影響實作的技術棧選擇前,請先閱讀 references/stack-routes.md。

工作流程

1. 分類任務

將當前請求分類為以下其中一個類型:

  • new-blog:根據目標與偏好建立新的部落格。
  • repair-blog:修復已產生或既有的部落格專案。
  • migration:將現有寫作、筆記或舊站內容遷移到新部落格。
  • cms-setup:讓既有的靜態部落格可供非程式設計者編輯。
  • deployment:發布或修復部署。
  • harness-work:改善此技能、腳本、模板或工作流程。

如果任務不是程式碼更動,且可以直接回答,則直接回答。如果需要檔案,請建立或修改專案,而不是停留在提供建議。

2. 只問關鍵問題

對於非程式設計者,在第一次建置簡報前,最多問三個產品相關問題。當答案沒有風險時,優先使用預設值。

最少必要的問題:

  1. 這個部落格的用途:個人散文、技術筆記、研究簡介、作品集、電子報,還是混合用途?
  2. 他們是否已經有寫作內容、圖片、網域或 GitHub 帳號?
  3. 他們想要最簡單的路線,還是更可自訂的路線?

當使用者從模糊的想法出發,或擁有許多現有素材時,請使用 references/intake-and-brief.md。

3. 探索視覺風格

對於 new-blog、migration 和風格較重的 repair-blog 任務,請在實作之前執行一個視覺風格探索循環,除非使用者明確表示要使用現有設計。

閱讀 references/visual-style-discovery.md,然後:

  • 當使用者不確定時,一次只問一個聚焦的風格問題;
  • 當使用者缺乏詞彙時,提供 2 到 3 張對比鮮明的方向卡;
  • 同時捕捉「不喜歡」的反偏好,而不只是喜歡的項目;
  • 如果有的話,要求提供參考網站、螢幕截圖、圖片、書籍、電子報、部落格或品牌;
  • 將模糊的詞彙轉化為具體的設計選擇;
  • 產出一份「風格簡報」,並請使用者確認或修正,然後才建立第一個視覺版本。

如果使用者追求速度,請使用臨時風格簡報,標明為「臨時」,並讓首次實作易於重新設定風格。

4. 產出建置簡報

在編輯網站之前,請在目標專案或對話中撰寫一份簡短的建置簡報:

  • 受眾與目的
  • 選擇的技術棧及其原因
  • 內容模型
  • 視覺方向
  • 已確認的風格簡報或臨時風格簡報
  • 編輯工作流程
  • 部署目標
  • 風險與假設

保持簡報務實。它是一份工作合約,不是策略備忘錄。

5. 逐步建置或修復

當專案已存在時,沿用現有專案風格。對於新專案:

  • 從已維護的入門套件開始搭建,而不是從頭撰寫網站;
  • 將內容保留在 Markdown 或 MDX 中;
  • 為文章、頁面、圖片和網站設定建立清晰的資料夾;
  • 加入能教導使用者如何替換的入門內容;
  • 僅在內容路徑穩定後才加入 CMS 設定;
  • 避免使用額外的資料庫、驗證系統、伺服器執行時期或特製的管理面板。

關於 CMS/部署的細節,請閱讀 references/cms-deployment.md。

6. 讓維護工作顯而易見

每個交付的部落格都應包含完成以下任務的明確方法:

  • 撰寫新文章
  • 編輯首頁文字
  • 新增或更換圖片
  • 在本地端或透過部署預覽進行預覽
  • 發布變更
  • 在建置失敗時復原

使用 references/maintenance-playbooks.md 來產生精簡的使用者導向說明。

7. 驗證

在程式碼或設定檔變更後,執行適合該專案的檢查:

  • 當有相依套件時,執行套件管理員安裝/建置;
  • 執行靜態網站建置指令(npm run build、hugo --minify 或同等指令);
  • 對首頁、文章、圖片和產生的路由進行連結/路徑健全性檢查;
  • 檢查 CMS 設定檔案是否存在且路徑一致;
  • 當建立工作流程時,對其語法進行檢查。

使用 scripts/audit_blog_project.py <專案根目錄> 進行快速的結構稽核。將警告視為待辦事項,除非它們明顯與所選技術棧無關。

8. 交接

最後,提供以下資訊:

  • 建立了什麼或更改了什麼;
  • 使用者應該在哪裡開啟專案;
  • 如何預覽;
  • 實作了什麼風格方向,以及如何更改它;
  • 如何撰寫下一篇文章;
  • 哪些操作仍需要人類帳號動作,例如連結 GitHub、Pages CMS、Cloudflare 或 DNS。

永遠不要要求使用者在對話中貼入 API 金鑰。對於 GitHub 或託管服務的驗證,請要求他們透過官方 UI 或本機 CLI 流程登入。

決策規則

  • 當使用者想要一個簡單的部落格、快速迭代、較低的概念負擔,以及良好的 Markdown/MDX 使用體驗時,選擇 Astro。
  • 當使用者是研究人員、學生、顧問、工程師或創作者,需要發表論文、專案、履歷、研討會或個人檔案區塊時,選擇 HugoBlox。
  • 當基於瀏覽器的編輯很重要,且儲存庫儲存 Markdown/YAML/JSON 內容時,選擇 Pages CMS。
  • 僅在專案已使用 TinaCMS 或 Keystatic,或使用者明確想要更豐富的編輯模型並願意接受設定的複雜性時,才選擇它們。
  • 僅在專案已使用 Decap CMS,或部署限制使其成為風險最低的路徑時,才選擇它。
  • 避免使用 Cloudflare VibeSDK 來建立個人部落格 MVP;它是平台建置工具包,不是最簡單的部落格工作流程。

捆綁資源

  • references/stack-routes.md:技術棧選擇矩陣與建置 vs 購買的 rationale。
  • references/intake-and-brief.md:精簡的訪談流程與建置簡報模板。
  • references/visual-style-discovery.md:迭代式的風格訪談、方向卡和風格簡報格式。
  • references/cms-deployment.md:Pages CMS 與部署實作筆記。
  • references/maintenance-playbooks.md:非程式設計者的維護交接模式。
  • scripts/audit_blog_project.py:用於稽核已產生或已修復部落格專案的結構性檢查腳本。
  • assets/pages-cms-astro-blog.yml:適用於 Astro 風格 Markdown 部落格的入門 .pages.yml。
  • assets/github-pages-astro.yml:適用於 Astro 在 GitHub Pages 上的入門 GitHub Actions 工作流程。
  • assets/content-brief-template.md:可重複使用的使用者導向建置簡報。
  • assets/first-post-template.md:為非程式設計者準備的入門文章模板。

相關技能