Communitygithub.com

YuukiMarine/websiteskills

透過對話建置並部署網站——收集需求、產出符合規範的 site.json、使用 Sitesmith 模板渲染,並透過 Nginx 發布。適用於「幫我建立/做一個網站」、登陸頁、個人/商業網站與作品集。

websiteskills 是什麼?

Sitesmith 是一個對話式網站建置工具,專門設計用來將使用者對話轉換成一個完整、可發布的靜態網站,且可選雙語支援。它的核心運作原則為產出「資料,而非程式碼」:使用者只需提供一個符合 JSON Schema 的 `site.json` 檔案,再由固定的、設計良好的模板進行渲染,確保輸出結果穩定且可更換主題。此技能特別適合用於快速建立登陸頁、個人或商業網站、作品集等場景,並支援常見的建置流程,包含需求收集、JSON 驗證、靜態渲染、預覽迭代,以及最終透過 Nginx 與 HTTPS 部署上線。平台支援方面,Sitesmith 可透過終端機工具指令串接執行,例如驗證指令 `validate.mjs`、渲染指令 `render.mjs` 與部署腳本 `deploy.sh`,並可與 Unsplash 圖片服務整合以自動取得真實圖片。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/YuukiMarine/websiteskills/tree/HEAD/skill

在你喜歡的 AI 中提問

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

說明文件

Sitesmith — 對話式網站建置工具

將幾輪對話轉換成一個完成、且可選雙語的網站並發布。您產出的是資料,不是程式碼:一個單一的 site.json 檔案,由固定且設計精美的模板進行渲染。這確保了輸出穩定且可更換外觀。

使用時機

當使用者想要建立或更新一個網站、登陸頁、個人或商業網站、或作品集時——例如「幫我做一個網站」、「I want to build a site」、「更新我的首頁」、「幫我的麵包店做一個登陸頁」。

快速參考

參考檔案——僅在需要時使用 skill_view("sitesmith", "<path>") 載入:

  • references/site.schema.json —— 每個 site.json 都必須符合的契約
  • references/sections.md —— 14 種區塊類型(包含 posts):使用時機、欄位說明、文字長度限制
  • references/theme.md —— 主題標記(模板、顏色、字型、圓角、密度)
  • references/assets.md —— 圖片策略(佔位圖 / Unsplash;嚴禁自行發想素材)
  • references/examples/innoe.site.json —— 完整的單頁範例(few-shot)
  • references/examples/multipage.site.json —— 多頁加部落格範例(few-shot)

腳本——透過終端機工具執行:

動作指令
驗證node ${HERMES_SKILL_DIR}/scripts/validate.mjs <site.json>
渲染node ${HERMES_SKILL_DIR}/scripts/render.mjs <site.json> <out-dir>
部署bash ${HERMES_SKILL_DIR}/scripts/deploy.sh <out-dir> <domain>

流程

  1. 需求收集(3–5 輪問答,將問題分組提問——不要像審訊一樣)。

    • 商家名稱 + 一句話說明他們做什麼;產業別 + 他們的客戶是誰。
    • 主要目標(來電 / 預約 / 註冊 / 銷售 / 展示)。
    • 語言——預設使用對話的語言;提供雙語選項(例如 en + zh)。
    • 範圍:單頁還是多頁? 預設為單頁。如果他們想要更多(或提到部落格),提供標準頁面組合(首頁 / 關於 / 服務 / 部落格 / 聯絡我們),並讓他們增刪——在建置前先確認頁面清單。
    • 前 3–5 項服務/產品;他們的差異化優勢;任何真實的數字;聯絡方式以及主要的行動呼籲。
    • 用一兩個詞表達風格(→ theme);素材(標誌?品牌色?真實照片?)。
    • 如果使用者很簡短或說「做得好看就好」,則依合理預設值進行(單頁是安全的預設值)。
  2. 草擬 site.json 需符合 references/site.schema.json 的規範。先研究相符的範例(單頁參考 innoe.site.json,多頁參考 multipage.site.json)。每個頁面挑選 5–8 個與真實內容匹配的區塊(請參閱 references/sections.md 了解目標與區塊骨幹的對應關係)。

    • 單頁: 所有內容都放在頂層的 sections 中。
    • 多頁: 首頁仍放在頂層的 sections 中;新增 pages[](每個子頁面一個項目,各自擁有自己的 sections)。導覽列會自動從頁面結構產生。部落格是一個包含 posts 區塊的頁面(輕量化:標題卡片,無文章內頁)。 選擇外觀(請參閱 references/theme.md):如果品牌具有強烈且明確的美學風格,可以選擇一個樣板模板(newchinese / cyber / portfolio),或者——預設方式——使用 template:"pro" 並自行設計一套專屬調色盤(primary / accent / neutral / font / radius / density),從品牌的感覺出發,讓每個網站獨一無二。所有圖片處理方式請遵循 references/assets.md。
  3. 驗證。 執行 validate.mjs。如果驗證失敗,請閱讀錯誤訊息,修正 JSON,然後重新執行。絕不能在不合法的檔案上繼續下一步。

  4. 渲染。 執行 render.mjs <site.json> <out-dir> → 產出靜態網站於 <out-dir>/dist 目錄下。如果已設定 UNSPLASH_ACCESS_KEY 環境變數,渲染時會自動將 unsplash 佔位圖替換為真實照片(並標示出處);若無此變數,則會渲染主題化的佔位圖——兩種情況都可以發布。

  5. 預覽與迭代。 用平實的語言摘要您所建置的內容(「一個 5 頁的雙語網站:首頁、關於、服務、部落格、聯絡我們」——或「一個包含 6 個區塊的單頁網站」)。告訴使用者網站仍然可以完全編輯——他們可以隨時要求您新增/刪除頁面或區塊、改寫文案、變更顏色,或新增部落格文章。修改方式為重新輸出完整的 site.json,然後重新驗證 + 重新渲染。

  6. 部署(僅在使用者核准預覽後執行)。執行 deploy.sh <out-dir> <domain> → 透過 Nginx 上線並啟用 HTTPS。回報上線 URL。

常見陷阱

  • 輸出的是資料,不是程式碼。 僅產出 site.json。切勿手寫 HTML/CSS。
  • Schema 是鐵律。 欄位名稱與列舉值必須完全相符;省略未知的欄位。
  • 嚴禁自行發想素材。 使用 Media 的 type:"placeholder"(裝飾用)或 "unsplash" 搭配 query(內容照片);只有在使用者提供真實 URL 時才能使用 "image"。標誌預設使用 type:"text",除非有真實的標誌檔案存在。
  • 在功能/服務介紹處優先使用圖示而非圖片——Lucide 圖示名稱永遠可渲染且可重新著色。
  • 每個 LocalizedText 都必須包含網站的所有語言。 文案要翻譯得自然流暢;絕不能留空任何一種語言。
  • 不要過度建置。 5–8 個區塊。交替使用不同的區塊背景色;絕不能連續兩個 dark 或兩個 primary。一定以 hero 開頭,以 cta 或 contact 結尾。
  • 禁止含有合規風險的聲明——不得編造認證、推薦、政府補助/補助金、獎項或使用者未提供的統計數據。
  • 單頁是預設選項。 只有在使用者想要一個更豐富/多頁的網站或部落格時,才新增 pages[]——並且必須先與他們確認頁面清單。部落格(posts)是標題列表,而非完整文章;請說明這點,並告知文章可以在之後新增。

驗證

  • validate.mjs 應以狀態碼 0 結束(它會列印解析後的區塊順序)。
  • render.mjs 應產出 <out-dir>/dist/index.html。
  • 部署後,curl -I https://<domain> 應回傳 200。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相關技能