Communitygithub.com

styleref-figma

將指定的視覺風格或品牌外觀套用到 Figma 檔案中——將調色板寫入本機色彩變數,將字體規則設為文字樣式,並將完整規格作為生成上下文,使後續產生的新框架符合品牌形象。同時可將選取內容中已存在的風格捕捉為可重複使用的可攜式規格。

styleref-figma 是什麼?

這個技能讓開發者與設計師能夠在 Figma 中直接套用或捕捉品牌視覺風格,無需依賴已發布的設計系統或外掛程式。它透過 styleref.io 的公開 API 取得結構化的風格規格(包含色彩、字體、UI 屬性等),並將這些規格實際寫入 Figma 的區域變數、文字樣式與效果樣式中,確保所有後續生成的畫面都能維持品牌一致性。此外,使用者也能選取現有框架,讓技能自動讀取其外觀並輸出為可重複使用的 StyleRef 規格,便於在不同檔案或 AI 工具間共用。該技能支援 Figma 與多種 AI 代理平台,且強調不作虛假宣稱——例如不聲稱改善效果、不自動推斷明暗主題、並誠實標示哪些數值是測量所得、哪些是推測結果。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/StyleRef/styleref-figma-skill/tree/HEAD

在你喜歡的 AI 中提問

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

說明文件

StyleRef — 將品牌或視覺風格套用到 Figma 畫布

StyleRef 是一種結構化的風格規格——包含色彩、字體、氛圍、光線、造型語言、材質、構圖——發布於 styleref.io,並可作為純文字或 JSON 讀取。它是設計系統「尚未具備」的形式:一種可攜帶的外觀描述,在元件存在之前即可使用,並且可在 Figma 之外用於任何產生圖像的 AI 工具。

此技能的功能: 尋找風格,將其調色盤和字體規則作為真正的區域變數和樣式寫入檔案,並將完整規格保留為上下文,以便後續產生的任何內容都能維持品牌一致性。它也能讀取選取範圍,並將其中「已經」使用的風格寫入相同的結構化形式。

此技能不做的事: 不會發明使用者未提供的品牌規則、不會重新設定使用者未選取的圖層樣式、不會取代已發布的設計系統、也不會自行產生圖像。當已發布的、包含元件和變數的設計系統已經涵蓋所需的外觀時,請說明情況並將該系統作為標準來源。

何時使用

  • 使用者要求某樣東西符合品牌、保持一致或具有特定的美學風格。
  • 使用者提到一個風格名稱、一種藝術運動,或貼上一個 styleref.io/share/... 連結。
  • 使用者想要一組調色盤和字體規模作為起點,而且還沒有任何設計系統。
  • 使用者希望將現有框線的外觀記錄下來,以便重複使用——在此檔案、其他檔案或 AI 圖像工具中。
  • 使用者正在探索元件尚未捕捉到的品牌表現形式。

路線 A — 將風格套用到檔案

當使用者提到一個風格名稱或要求一個你需要來源的外觀時,執行此步驟。

  1. 解析風格。 如果使用者貼上了 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 個結果,附上其調色盤,讓他們選擇。當兩個候選項目讀起來感覺不同時,不要替他們決定。

  2. 取得結構化規格。

    https://styleref.io/api/v1/styles/{slug}?format=json

    你寫入畫布的每個值都來自這裡。如果你之後會產生框線或圖像,也一併取得文字形式:

    https://styleref.io/api/v1/styles/{slug}?format=default&compact=1

  3. 將色彩寫入區域變數。 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,這是一個要求,而非偏好:在指派文字與背景配對時,請根據該比率進行檢查,並說明你檢查了哪些配對。當調色盤中的某個配對無法滿足目標時,請說明情況並提出修正方案,而不是默默地傳遞有問題的配對。

  4. 將字體寫入文字樣式。 sections.typography.values.font_family 是一個「類別」(例如「展示/裝飾」、「幾何無襯線體」),而不是已授權的字體名稱。選擇一個檔案中已經存在的具體字體,或使用 Figma 的預設字體,並告知使用者你選擇了哪個字體,以及規格指定的是一個類別,而不是該特定字體。 然後將 font_weights、text_case、letter_spacing 和 typographic_hierarchy 套用到你建立的樣式中。

  5. 從 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 不存在時,請說明情況並從以下章節著手;不要發明風格從未指定的介面規則。

  6. 對應其餘承載畫布內容的章節。 只有這些能轉換為檔案物件:

    章節將其寫入為
    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 則「不」對應到檔案物件。將它們保留作為生成時期的上下文和供你自行判斷的依據。

  7. 保留規格作為生成上下文。 對於此後你產生的任何框線、佈局或圖像,請將 format=default 的文字作為約束區塊放在請求之前。逐字貼上——它的撰寫目的就是為了被強制執行,而改寫它會失去約束條件。

  8. 標註來源。 將風格的名稱、其 @handle 作者以及標準的 styleref.io/share/... URL 放在使用者能看到的地方——例如畫布上的備註或你的回覆中。API 會在每個回應中回傳該 URL。

路線 B — 捕捉畫布上已有的風格

當使用者想要將現有選取範圍的外觀記錄下來時,執行此步驟。這完全不需要網路請求。

  1. 要求選取範圍。 如果沒有選取任何東西,請要求使用者選取代表該外觀的框線。不要從整個頁面中猜測。

  2. 讀取實際存在的內容——填色及其大致比例、文字樣式及其粗細和大小寫、圓角半徑、筆畫粗細、陰影值、間距節奏、背景處理方式。

    如果選取範圍是一個介面,也要讀取介面圖層,因為那是單靠色彩調色盤無法承載的一半:設計堆疊了多少個表面層級、深度來自陰影、模糊還是單純的對比、邊框是存在還是隱含的、按鈕的形狀及其層級數量、圖示的風格和粗細、導覽模式,以及焦點環是否存在。這些會成為 ui-and-web 章節。請註明你尋找過但未找到的項目——一個沒有可見焦點狀態的介面是一個值得報告的發現,而不是一個可以跳過的空白欄位。

  3. 將其寫入 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

  4. 將你量測到的與你推斷的分開。 十六進制值和半徑是量測到的。「自信、編輯風格、克制」是推斷的——將其標記為你的解讀,並讓使用者更正。

  5. 提供下一步。 捕捉到的規格在此檔案之外也可以重複使用——例如在另一個 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 並...

…[因翻譯而截斷]

相關技能