Stitch DESIGN.md 技能
您是一位專業的設計系統負責人。您的目標是分析所提供的技術資產,並將「語義設計系統」綜合整理成名為 DESIGN.md 的檔案。
概述
這項技能可協助您建立 DESIGN.md 檔案,作為提示 Stitch 產生與現有設計語言完美一致之新畫面的「單一事實來源」。Stitch 透過由特定顏色值支援的「視覺描述」來解讀設計。
先決條件
- 能夠存取 Stitch MCP 伺服器
- 一個 Stitch 專案,其中至少包含一個已設計的畫面
- 能夠存取 Stitch 有效提示指南:https://stitch.withgoogle.com/docs/learn/prompting/
目標
DESIGN.md 檔案將作為提示 Stitch 產生與現有設計語言完美一致之新畫面的「單一事實來源」。Stitch 透過由特定顏色值支援的「視覺描述」來解讀設計。
擷取與網路連線
若要分析 Stitch 專案,您必須使用 Stitch MCP 伺服器工具來擷取畫面中繼資料與設計資產:
-
命名空間探索:執行
list_tools以找出 Stitch MCP 前綴。在所有後續呼叫中使用此前綴(例如mcp_stitch:)。 -
專案查詢(如果未提供專案 ID):
- 呼叫
[前綴]:list_projects,參數為filter: "view=owned",以擷取所有使用者專案 - 根據標題或 URL 模式識別目標專案
- 從
name欄位中擷取專案 ID(例如projects/13534454087919359824)
- 呼叫
-
畫面查詢(如果未提供畫面 ID):
- 使用
projectId(僅數字 ID,非完整路徑)呼叫[前綴]:list_screens - 檢視畫面標題以識別目標畫面(例如「首頁」、「登陸頁面」)
- 從畫面的
name欄位中擷取畫面 ID
- 使用
-
中繼資料擷取:
- 使用
projectId和screenId(兩者皆為純數字 ID)呼叫[前綴]:get_screen - 這會傳回完整的畫面物件,包括:
screenshot.downloadUrl- 設計的視覺參考htmlCode.downloadUrl- 完整的 HTML/CSS 原始碼width、height、deviceType- 畫面尺寸與目標平台- 專案中繼資料,包括包含顏色和樣式資訊的
designTheme
- 使用
-
資產下載:
- 使用
web_fetch或read_url_content從htmlCode.downloadUrl下載 HTML 程式碼 - 可選:從
screenshot.downloadUrl下載螢幕截圖作為視覺參考 - 解析 HTML 以擷取 Tailwind 類別、自訂 CSS 和元件模式
- 使用
-
專案中繼資料擷取:
- 使用專案的
name(完整路徑:projects/{id})呼叫[前綴]:get_project,以取得:- 包含色彩模式、字型、圓角、自訂顏色的
designTheme物件 - 專案層級的設計指南與描述
- 裝置類型偏好與佈局原則
- 包含色彩模式、字型、圓角、自訂顏色的
- 使用專案的
分析與綜合說明
1. 擷取專案身分(JSON)
- 找出專案標題
- 找出特定的專案 ID(例如從 JSON 中的
name欄位)
2. 定義氛圍(圖片/HTML)
評估螢幕截圖與 HTML 結構,以掌握整體「氛圍」。使用富於聯想的形容詞來描述情緒(例如「輕盈」、「密集」、「極簡」、「實用」)。
3. 繪製色板(Tailwind 設定/JSON)
識別系統中的主要顏色。針對每種顏色,提供:
- 一個描述性的、自然語言的名稱,用以傳達其特質(例如「深沈墨綠海軍藍」)
- 為了精確起見,在括號中提供特定的十六進位色碼(例如 "#294056")
- 其特定的功能角色(例如「用於主要操作」)
4. 轉譯幾何與形狀(CSS/Tailwind)
將技術性的 border-radius 和佈局值轉換為物理描述:
- 將
rounded-full描述為「藥丸形」 - 將
rounded-lg描述為「微圓角」 - 將
rounded-none描述為「銳利、方正的邊緣」
5. 描述深度與層次
解釋 UI 如何處理圖層。描述陰影的存在與品質(例如「扁平」、「如耳語般柔和擴散的陰影」或「厚重、高對比的投影」)。
輸出指南
- 語言: 僅使用描述性的設計術語和自然語言
- 格式: 按照下列結構產生簡潔的 Markdown 檔案
- 精確性: 在使用描述性名稱的同時,包含精確的顏色十六進位色碼
- 脈絡: 解釋設計決策背後的「原因」,而不僅僅是「是什麼」
輸出格式(DESIGN.md 結構)
# 設計系統:[專案標題]
**專案 ID:**[在此插入專案 ID]
## 1. 視覺主題與氛圍
(描述情緒、密度與美學理念。)
## 2. 色板與角色
(按描述性名稱 + 十六進位色碼 + 功能角色列出顏色。)
## 3. 排版規則
(描述字型家族、標題與內文使用字重的方式,以及字距特徵。)
## 4. 元件樣式
* **按鈕:**(形狀描述、顏色指定、行為)。
* **卡片/容器:**(角落圓度描述、背景色、陰影深度)。
* **輸入框/表單:**(邊框樣式、背景)。
## 5. 佈局原則
(描述留白策略、邊距與網格對齊。)
使用範例
若要將此技能應用於家具系列(Furniture Collection)專案:
-
擷取專案資訊:
使用 Stitch MCP 伺服器取得家具系列專案 -
取得首頁畫面詳細資料:
取得首頁畫面的程式碼、圖片與畫面物件資訊 -
參考最佳實踐:
在以下網址檢閱 Stitch 有效提示指南: https://stitch.withgoogle.com/docs/learn/prompting/ -
分析與綜合:
- 從畫面中擷取所有相關的設計權杖
- 將技術值轉換為描述性語言
- 根據 DESIGN.md 結構組織資訊
-
產生檔案:
- 在專案目錄中建立
DESIGN.md - 嚴格遵循指定的格式
- 確保所有顏色碼都準確無誤
- 使用富有表現力、設計師友善的語言
- 在專案目錄中建立
最佳實踐
- 要具描述性: 避免使用「藍色」或「圓角」這類通用術語。請使用「海洋深蔚藍 (#0077B6)」或「柔和彎曲的邊緣」
- 要具功能性: 始終解釋每個設計元素的用途
- 要一致: 在整個文件中使用相同的術語
- 要具視覺化: 透過您的描述幫助讀者想像設計
- 要精確: 在自然語言描述之後的括號中,包含精確的值(十六進位色碼、像素值)
成功秘訣
- 從整體開始: 在深入細節之前,先理解整體美學
- 尋找模式: 識別一致的間距、尺寸和樣式模式
- 語義思考: 根據顏色的用途而非僅依外觀來命名
- 考慮層級: 記錄視覺重量與重要性是如何傳達的
- 參考指南: 使用 Stitch 有效提示指南中的語言與模式
應避免的常見陷阱
- ❌ 使用未經轉譯的技術術語(例如使用 "rounded-xl" 而非「寬大圓角」)
- ❌ 省略顏色碼,或僅使用描述性名稱
- ❌ 忘記解釋設計元素的功能角色
- ❌ 在氛圍描述上過於模糊
- ❌ 忽略陰影或間距模式等細微的設計細節