Communitygithub.com

tsumu-build-site

設計技能。從頭建立一個全新的可編輯 Tsumu 網站或著陸頁,包含多頁面、響應式及動畫設計,並自動提供一次性 Tsumu 匯入連結。不適用於修改現有網站。

tsumu-build-site 是什麼?

這個技能專為從零開始在 Tsumu 中創建全新網站而設計。它透過兩階段流程運作:首先,根據使用者需求設計原創的網站概念(包括資訊架構、版面、內容和視覺風格),並可選擇建立原型;接著,將此設計轉換為原生的 Tsumu SiteDoc 格式,以確保在 Tsumu 編輯器中可完整編輯。此技能會自動產生一個私人的一次性匯入連結(importUrl),使用者點擊後即可將網站匯入 Tsumu。它支援多頁面、響應式設計以及有限的原生動畫和腳本功能。嚴禁將此技能用於修改現有網站(應改用 tsumu-edit-site),也絕不能偽造匯入連結或假裝網站已部署。此技能通常透過 MCP 工具(如 stage_site_doc)實現,並要求使用者授權才能建立新網站。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/abshrimp/tsumu-mcp/tree/HEAD/plugins/claude/skills/tsumu-build-site

在你喜歡的 AI 中提問

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

說明文件

建立新的 Tsumu 網站

當使用者要求在 Tsumu 中製作新網站時使用。交付的產物是一個真實、可編輯的 Tsumu 網站,不是設計說明、螢幕截圖、HTML 模擬或空網站。

交付物:私人的 Tsumu 匯入連結

針對使用者要求的新網站,stage_site_doc 的成功結果會包含一個 importUrl。這是請求者用來在 Tsumu 中開啟所產生網站的交接成品。請提供該確切連結,並附上已建置內容的簡短說明;無需額外請求該連結。此連結是私有的,不應複製到日誌、不相關的上下文或第三方服務。絕不自行編造或重構此連結。

分階段產生的連結不是已匯入、已發佈或已部署的證明。請勿聲稱已執行這些操作。

選擇工作流程

  • 建立新網站: 直接使用 stage_site_doc,即使沒有配對現有網站也可以。使用者在 MCP OAuth 畫面中可以僅授權建立新網站,而無需提供網站連接碼。現有的配對網站授權也可能用於分階段建立新網站。
  • 改為編輯使用者的現有網站: 啟動 tsumu-edit-site 並使用配對的編輯器工具。請不要分階段複製或覆寫現有網站。
  • 沒有分階段工具或未成功授權: 請勿偽造 URL。如果可以使用成品建立功能,請產出可下載的有效 doc.json;否則,說明缺少的功能以及可以採取的行動。
  • create_site 是用於在已配對的編輯器中建立瀏覽器本機的空網站。它不會上傳完整的產生設計,並且需要再次配對新網站。請勿將其用作 stage_site_doc 的替代品。

兩階段建立:自由設計,然後轉換為 Tsumu

第一階段 — 在處理 SiteDoc 格式之前,先建立原創的網站概念。 將使用者的請求視為網站設計簡報,而不是重新換膚範例 JSON 文件的指示。

  1. 決定網站的目的、目標受眾、關鍵訊息、頁面、內容優先順序和主要使用者操作。對於模糊的請求,例如「建立一個漂亮的網站」,請獨立選擇一個獨特、合理的概念,而不是預設使用範例作品集或提出不必要的問題。請勿虛構真實地址、推薦、產品聲明或價格。
  2. 就好像 Tsumu 的節點結構描述不存在一樣來設計網站。 規劃原創的資訊架構、逐頁內容、區塊構成、層級、排版、顏色、圖像或圖形元素、間距和響應式行為。避免機械式地重複通用的主視覺/功能/推薦/聯絡我們範本。
  3. 如果工具和時間允許,將完整設計草擬為獨立的 HTML/CSS 原型(以及清晰的互動說明),以自由探索版面。否則,準備同樣具體的頁面和元件藍圖。這是中間設計成品,不是最終交付物,也不表示 Tsumu 可以透過 stage_site_doc 匯入任意 HTML。如果沒有可用的即時預覽,則不需要。
  4. 根據簡報評估計畫:它是否具有可辨識的視覺識別、可信的內容、有目的的區塊、清晰的使用者歷程和行動版版面?在參考 SiteDoc 版面範例之前,先改進它。

第二階段 — 將該設計轉換為原生的、可編輯的 Tsumu SiteDoc。 只有現在才查閱 get_site_doc_spec、結構描述指南和最小範例,以了解有效的資料形狀,而不是用來決定網站的外觀。使用 Tsumu 支援的原生元素、樣式、素材和互動來重建設計的頁面和版面。保留中間設計的獨特構成、排版、間距、內容和響應式意圖,而不是將其收縮為重新著色的範例。如果某個細節不受支援,請將其改編為最接近的有效可編輯表示,或揭露限制;絕不發明結構描述欄位。

原創性檢查: 在分階段之前,將轉換後的 SiteDoc 與第一階段的設計進行比較。如果最終網站本質上只是更換了文字、顏色或圖片的捆綁範例,則轉換失敗:請重新設計結構和構成。如果使用者明確要求特定的範本,則遵循該要求。

將原始設計轉換為 SiteDoc

在構建任何 SiteDoc 之前: 呼叫唯讀的 MCP 工具 get_site_doc_spec 並檢查其 guide 和 example。在規劃原始設計之後,但在建立任何 SiteDoc 頁面、節點、樣式、腳本或首次嘗試 stage_site_doc 之前執行此操作。僅需新網站 OAuth 授權即可取得參考資料。請勿僅因已載入此技能文字就跳過此步驟;有些 MCP 用戶端不會自動擷取參考資料。如果該規格工具無法使用,請改為閱讀 references/site-doc.md 和 references/minimal-site.json。絕不猜測資料形狀。

  1. 將第一階段網站的頁面地圖、內容和構成轉換為 SiteDoc。請不要從範例 JSON 開始然後替換其文字或調色盤。 指南和範例僅描述有效的屬性和關係。若需進階功能,請在可存取時查閱目前的 Tsumu lib/types.ts、lib/presets.ts、lib/site-import-format.ts 和 skills/tsumu/references/site-doc.md。
  2. 建構一個完整的 SiteDoc物件(不是 JSON 字串、HTML 頁面或壓縮檔)。必要欄位:schemaVersion: 1、非空的 siteName、pages、pageOrder、nodes、assets。首頁的 slug 為 ""。頁面和節點的 children 參考節點 ID;節點是可編輯的 box、image 等。文字和標題使用 box.text,而不是自創的 heading 節點。
  3. 建立與設計結構相符的有意義的原生頁面版面。為節點提供合適的語義標籤、樣式和響應式覆寫。保留第一階段的實際層級、間距、排版對比、視覺重點和區塊變化。檢查導覽目標、替代文字、對比度和行動版行為。避免損壞的素材、空連結、佔位符內容和螢幕外元素。
  4. 如果設計包含動畫、腳本、元件或表單行為,請查閱確切的最新類型定義,並僅實作支援的結構。腳本元素的目標使用目標節點的 HTML attrId,不是其 SiteDoc 節點 ID;@self 僅用於附加到元素的腳本。檢查每個巢狀步驟和條件。請勿發明動作或腳本屬性,也不要將惰性按鈕描述為功能正常。
  5. stage_site_doc 僅接受完整的 SiteDoc 作為 doc(序列化 JSON 最多 12 MiB)。它不接受第一階段的 HTML 原型、ZIP 或單獨的二進位素材。盡可能使用 assets: {},在適當時使用經過驗證的外部圖像,或在限制內使用小型內嵌 dataUrl 素材。請勿發明 Tsumu 儲存路徑。
  6. 根據原始設計(而不是根據範例的美學)審查生成的 SiteDoc。確保其保持完全可編輯且在結構上有效;如果轉換失去了獨特的版面或內容,請在分階段之前改善原生元素層級。

驗證並交付

  • 在分階段之前,將最終頁面與第一階段的設計進行比較,並確認它們是忠實的、獨立組成的網站,而不是重新換膚的最小範例。除非使用者要求,否則將設計中間產物保密;將 SiteDoc 或匯入連結作為最終結果交付。
  • 在分階段之前,確保每個可見的設計宣告都放置在 nodes[id].styles.base.default 或相關的響應式覆寫中,而不是自創的 style、css 或 className 欄位。實際的 CSS 宣告值必須是字串。檢查 ID、參考、無環路樹和匯入規則。在工具允許的範圍內檢查頁面層級、響應性和要求的互動。除非您確實預覽過,否則不要說您預覽過。
  • 呼叫 stage_site_doc({ doc: <完整的 SiteDoc> });僅在使用者要求特定的自託管 Tsumu 安裝時才使用 editorOrigin。
  • 成功的新網站交接包括工具的準確 importUrl,作為請求者可點擊的連結,以及簡短的說明,說明開啟它會匯入一個新的可編輯網站。該連結不是已發佈網站的 URL。
  • 如果失敗,請說明實際錯誤,並避免聲稱網站已儲存。請不要用偽造的連結取代失敗的工具動作,或默默地切換到現有網站。
  • 該連結在其 URL 片段中包含一個私人存取權杖,一小時後過期,並在Tsumu 確認成功匯入後消耗。請勿將其透露給他人。匯入失敗可在五分鐘的臨時聲明租約到期後重試。

交接範例(僅供說明): "可編輯的咖啡廳網站已準備好可供匯入。私人的 Tsumu 匯入連結在接下來的一小時內有效。" 實際交接會包含當分階段成功時由工具產生的真實連結。

相關技能