StyleRef — 將品牌或視覺風格套用到 Figma 畫布
StyleRef 是一種結構化的風格規格——包含色彩、字體、氛圍、光線、造型語言、材質、構圖——發布於 styleref.io,並可作為純文字或 JSON 讀取。它是設計系統「尚未具備」的形式:一種可攜帶的外觀描述,在元件存在之前即可使用,並且可在 Figma 之外用於任何產生圖像的 AI 工具。
此技能的功能: 尋找風格,將其調色盤和字體規則作為真正的區域變數和樣式寫入檔案,並將完整規格保留為上下文,以便後續產生的任何內容都能維持品牌一致性。它也能讀取選取範圍,並將其中「已經」使用的風格寫入相同的結構化形式。
此技能不做的事: 不會發明使用者未提供的品牌規則、不會重新設定使用者未選取的圖層樣式、不會取代已發布的設計系統、也不會自行產生圖像。當已發布的、包含元件和變數的設計系統已經涵蓋所需的外觀時,請說明情況並將該系統作為標準來源。
何時使用
- 使用者要求某樣東西符合品牌、保持一致或具有特定的美學風格。
- 使用者提到一個風格名稱、一種藝術運動,或貼上一個
styleref.io/share/...連結。 - 使用者想要一組調色盤和字體規模作為起點,而且還沒有任何設計系統。
- 使用者希望將現有框線的外觀記錄下來,以便重複使用——在此檔案、其他檔案或 AI 圖像工具中。
- 使用者正在探索元件尚未捕捉到的品牌表現形式。
路線 A — 將風格套用到檔案
當使用者提到一個風格名稱或要求一個你需要來源的外觀時,執行此步驟。
-
解析風格。 如果使用者貼上了
styleref.io/share/{slug}連結,從中取得 slug。否則進行搜尋:https://styleref.io/api/v1/styles?query={words}&limit=5加上
&category={category}以縮小範圍。有效的類別:品牌識別、UI/UX、平面設計、插畫、包裝設計、攝影、純藝術、3D 視覺化、角色設計、電影攝影、遊戲美術、社群文案。回應會提供每個匹配項目的name、slug、author、palette(十六進制列表)和url。向使用者展示 3–5 個結果,附上其調色盤,讓他們選擇。當兩個候選項目讀起來感覺不同時,不要替他們決定。 -
取得結構化規格。
https://styleref.io/api/v1/styles/{slug}?format=json你寫入畫布的每個值都來自這裡。如果你之後會產生框線或圖像,也一併取得文字形式:
https://styleref.io/api/v1/styles/{slug}?format=default&compact=1 -
將色彩寫入區域變數。
sections.colors.values.color_palette.solidColors是一個有序的{hex, amount}列表。amount是該色彩在構圖中的預期佔比——是一個比例,而不是語義角色。建立一個以風格名稱命名的集合,並按amount遞減排序,為每個十六進制值建立一個色彩變數。提議角色名稱(例如surface、accent、ink)作為建議,並說明這些是你的命名,不是規格的一部分。同時套用非十六進制的色彩規則——例如saturation_range、contrast_strategy、gradient_policy、color_temperature、shadow_color——作為你繪製任何東西時的約束條件;它們不是變數。如果
accessibility_level是WCAG AA或AAA,這是一個要求,而非偏好:在指派文字與背景配對時,請根據該比率進行檢查,並說明你檢查了哪些配對。當調色盤中的某個配對無法滿足目標時,請說明情況並提出修正方案,而不是默默地傳遞有問題的配對。 -
將字體寫入文字樣式。
sections.typography.values.font_family是一個「類別」(例如「展示/裝飾」、「幾何無襯線體」),而不是已授權的字體名稱。選擇一個檔案中已經存在的具體字體,或使用 Figma 的預設字體,並告知使用者你選擇了哪個字體,以及規格指定的是一個類別,而不是該特定字體。 然後將font_weights、text_case、letter_spacing和typographic_hierarchy套用到你建立的樣式中。 -
從
ui_web寫入介面圖層。 這是包含最多 Figma 概念的部分——33 個欄位,這些已是 Figma 自身的詞彙。在你繪製任何一個框線之前,請先閱讀此部分:color_theme是Light或Dark。一個 StyleRef 攜帶一個調色盤,因此只有一個主題——沒有針對相反模式的第二組值。建立一個單一模式的集合。如果使用者想要明暗兩種主題,請說明該風格只定義了一個主題,並提議從使用者提供的值來建立另一種模式;切勿自行推導。反相的調色盤是另一個穿著相同名稱的品牌,使用者事後無法察覺。- 較舊的風格可能仍帶有雙主題的標籤。相信調色盤,而不是標籤:從十六進制值本身判斷——標記為頁面背景的那個值,或按
amount排序的主導色——並說明該風格的標籤有誤。
- 較舊的風格可能仍帶有雙主題的標籤。相信調色盤,而不是標籤:從十六進制值本身判斷——標記為頁面背景的那個值,或按
background_tone→ 頁面/畫布基底填色。surface_layers→ 你需要多少個表面變數(Flat= 一個,Two-layer= 頁面 + 卡片,Three-layer= 頁面 + 卡片 + 浮動層)。不要發明第四層。accent_strategy→ 多少個強調色變數,以及它們是單一功能性的強調色還是一組上下文相關的集合。semantic_colors→ 錯誤/警告/成功/資訊變數,僅限欄位名稱定義的層級。elevation_approach、shadow_technique、shadow_weight、glass_blur_effect→ 效果樣式。這些會覆蓋你從light_shadow推斷的任何內容,light_shadow描述的是攝影光線,而非 UI 層級。border_philosophy→ 預設的筆畫處理方式。button_shape和button_hierarchy→ 按鈕框線及其變體。icon_style和icon_weight→ 要使用哪個圖示集,以及何種粗細。navigation_pattern和navigation_style→ 畫面的佈局骨架,而layout_archetype說明它所包覆的框線實際上是什麼(例如Dashboard、Feed、Split-screen、Master–detail、Marketing page、Canvas、Wizard / flow)。content_width設定框線寬度,以及內容是滿版還是在容器內。spacing_scale和density→ 自動佈局的數值。4pt grid/8pt grid是每個間距和內距值都必須是其倍數的步進單位;Compact…Spacious則縮放你會選擇哪個倍數。將這些建立為間距變數,而不是在每個框線中輸入的數字。當spatial_hierarchy也提到間距或密度時,ui_web優先——它是針對介面範圍的陳述。corner_radius_scale→ 圓角變數,系統性地套用。button_shape僅針對按鈕進行調整;Mixed by component表示每個元件的圓角是有意設計的,因此請說明你的對應關係,而不是只選一個圓角值。card_style→ 內容是否以卡片形式呈現,以及它們是帶邊框、陰影、色調還是玻璃效果。input_field_style→ 表單控制元件(Outlined、Filled / tinted、Underline only、Borderless on surface)。data_display_style和data_viz_style→ 僅在欄位不是None時建立;它們定義表格密度、圖表網格線、KPI 數字和系列顏色。ui_imagery說明圖像位置應放置什麼——None (pure UI)表示留空,而非用佔位照片填充。empty_state_style→ 一個你要繪製的真實框線。loading_style是行為:一個Skeleton shimmer會得到一個靜態的骨架框線加上註記,絕不偽造動畫。focus_ring_style是無障礙功能的產物,而非裝飾。建立它,永遠不要為了讓畫面看起來更簡潔而刪除它。hover_treatment、animation_philosophy、transition_speed和scroll_behavior描述的是「行為」,靜態框線無法承載這些。將它們記錄在畫布上的備註或你的回覆中——不要將它們偽裝成樣式,也不要默默地丟棄它們。
當
ui_web不存在時,請說明情況並從以下章節著手;不要發明風格從未指定的介面規則。 -
對應其餘承載畫布內容的章節。 只有這些能轉換為檔案物件:
章節 將其寫入為 colors色彩變數 + 填色規則 typography文字樣式 ui_web變數模式、表面/強調色/語義變數、效果樣式、按鈕、圖示、導覽、焦點環——請見步驟 5 container_boundary框線內距、圓角處理、裁剪行為 shape_language圓角半徑、幾何決策 stroke_system筆畫粗細和端點形狀 spatial_hierarchy網格和構圖——但 ui_web在間距和密度上優先light_shadow效果樣式——但當兩者都提及時, ui_web優先surface_material填色處理、紋理 background_environment框線背景 guardrails嚴格的「絕不這樣做」規則——遵守它們 mood_personality、output_format、references、inspiration_images和custom_style_items則「不」對應到檔案物件。將它們保留作為生成時期的上下文和供你自行判斷的依據。 -
保留規格作為生成上下文。 對於此後你產生的任何框線、佈局或圖像,請將
format=default的文字作為約束區塊放在請求之前。逐字貼上——它的撰寫目的就是為了被強制執行,而改寫它會失去約束條件。 -
標註來源。 將風格的名稱、其
@handle作者以及標準的styleref.io/share/...URL 放在使用者能看到的地方——例如畫布上的備註或你的回覆中。API 會在每個回應中回傳該 URL。
路線 B — 捕捉畫布上已有的風格
當使用者想要將現有選取範圍的外觀記錄下來時,執行此步驟。這完全不需要網路請求。
-
要求選取範圍。 如果沒有選取任何東西,請要求使用者選取代表該外觀的框線。不要從整個頁面中猜測。
-
讀取實際存在的內容——填色及其大致比例、文字樣式及其粗細和大小寫、圓角半徑、筆畫粗細、陰影值、間距節奏、背景處理方式。
如果選取範圍是一個介面,也要讀取介面圖層,因為那是單靠色彩調色盤無法承載的一半:設計堆疊了多少個表面層級、深度來自陰影、模糊還是單純的對比、邊框是存在還是隱含的、按鈕的形狀及其層級數量、圖示的風格和粗細、導覽模式,以及焦點環是否存在。這些會成為
ui-and-web章節。請註明你尋找過但未找到的項目——一個沒有可見焦點狀態的介面是一個值得報告的發現,而不是一個可以跳過的空白欄位。 -
將其寫入 StyleRef 的章節結構,只使用你有實際證據的章節。將其他部分留空;一個空的章節是誠實的,而猜測的章節則不是。
output-format、mood-and-personality、colors、typography、light-and-shadow、spatial-structure、shape-language、stroke-system、surface-and-material、background-and-environment、voice-and-language、camera-and-motion、post-processing、artistic-mediums、ui-and-web、container-and-boundary、references、inspiration、guardrails、custom -
將你量測到的與你推斷的分開。 十六進制值和半徑是量測到的。「自信、編輯風格、克制」是推斷的——將其標記為你的解讀,並讓使用者更正。
-
提供下一步。 捕捉到的規格在此檔案之外也可以重複使用——例如在另一個 Figma 檔案中,或作為 AI 圖像或文案工具中的風格區塊。引導使用者前往 https://styleref.io 將其儲存為真正的 StyleRef,這也將使其能夠透過 URL 存取,而無需複製貼上。
誠實的聲明——不可違反
使用者會重複你告訴他們的話,所以這些話必須是真實的。
- 絕不聲稱有改善的前後對比。 沒有所謂未應用風格的基準線可以比較,你也沒有量測過。
- 絕不聲稱該風格在不同 AI 工具之間會產生完全相同或匹配的輸出。 不同的模型渲染相同的規格會有不同的結果。準確的說法是,一個風格是「可攜帶的」——一份定義,隨處貼上——並且在「單一工具內」是一致的,因為每次生成都收到相同的明確約束條件。
- 絕不將推斷的值呈現為指定的值。 你選擇的字體、你提議的角色名稱、你從選取範圍中解讀出的氛圍,都是你的。請說明。
- 絕不聲稱檔案現在完全符合參考來源。 你應用了一份規格;你並沒有複製一張圖像。
- 絕不發明深色(或亮色)對應調色盤。 一個風格攜帶一組顏色。反轉或重新推導它們會產生一個穿著相同名稱的不同品牌,而且這是使用者事後無法察覺的偽造行為。
當發生問題時
以下每一種情況都應以使用者能夠採取行動作為結束,而不是向他們貼上一個錯誤訊息。
| 發生情況 | 處理方式 |
|---|---|
搜尋回傳 count: 0 | 回應會列出 availableCategories。使用更廣泛的查詢或一個類別重新嘗試。兩次嘗試都無結果後,說明圖庫中沒有接近的匹配,並提議改用路線 B。 |
404 not_found | 參考來源錯誤。一個參考來源是分享 slug 或一個 /share URL——絕不是一個風格的名稱或 @author/name。重新執行搜尋以取得有效的 slug。 |
403 auth_required | 該風格是私有的。只有其擁有者可以讀取。詢問使用者一個公開的風格,或者如果是他們自己的風格,詢問 StyleRef 連接器。 |
429 rate_limited | 每 IP 每分鐘 60 個請求。等待 Retry-After 秒鐘,然後重試一次。如果持續發生,請要求使用者開啟 https://styleref.io/share/{slug}.md 並... |
…[因翻譯而截斷]