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> |
流程
-
需求收集(3–5 輪問答,將問題分組提問——不要像審訊一樣)。
- 商家名稱 + 一句話說明他們做什麼;產業別 + 他們的客戶是誰。
- 主要目標(來電 / 預約 / 註冊 / 銷售 / 展示)。
- 語言——預設使用對話的語言;提供雙語選項(例如 en + zh)。
- 範圍:單頁還是多頁? 預設為單頁。如果他們想要更多(或提到部落格),提供標準頁面組合(首頁 / 關於 / 服務 / 部落格 / 聯絡我們),並讓他們增刪——在建置前先確認頁面清單。
- 前 3–5 項服務/產品;他們的差異化優勢;任何真實的數字;聯絡方式以及主要的行動呼籲。
- 用一兩個詞表達風格(→
theme);素材(標誌?品牌色?真實照片?)。 - 如果使用者很簡短或說「做得好看就好」,則依合理預設值進行(單頁是安全的預設值)。
-
草擬
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。
- 單頁: 所有內容都放在頂層的
-
驗證。 執行
validate.mjs。如果驗證失敗,請閱讀錯誤訊息,修正 JSON,然後重新執行。絕不能在不合法的檔案上繼續下一步。 -
渲染。 執行
render.mjs <site.json> <out-dir>→ 產出靜態網站於<out-dir>/dist目錄下。如果已設定UNSPLASH_ACCESS_KEY環境變數,渲染時會自動將unsplash佔位圖替換為真實照片(並標示出處);若無此變數,則會渲染主題化的佔位圖——兩種情況都可以發布。 -
預覽與迭代。 用平實的語言摘要您所建置的內容(「一個 5 頁的雙語網站:首頁、關於、服務、部落格、聯絡我們」——或「一個包含 6 個區塊的單頁網站」)。告訴使用者網站仍然可以完全編輯——他們可以隨時要求您新增/刪除頁面或區塊、改寫文案、變更顏色,或新增部落格文章。修改方式為重新輸出完整的
site.json,然後重新驗證 + 重新渲染。 -
部署(僅在使用者核准預覽後執行)。執行
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。