Communitygithub.com

Figma 設計系統庫綁定

將 Figma 畫面綁定到專案的設計系統庫:僅在數值完全匹配時綁定 token,將圖示和元件替換為庫版本,並列出未匹配的值供設計師決定,而非自動捕捉最接近的 token。當使用者要求「綁定 token」、「使用庫元件」或「找出未綁定的顏色」時使用。

Figma 設計系統庫綁定 是什麼?

此技能用於將 Figma 畫面綁定到專案的設計系統庫,確保產品畫面使用統一的設計語言,而非僅依賴圖層本機設定。它嚴格遵循精確匹配規則:顏色(包含透明度)、圓角、描邊、間距和字級尺寸等屬性,僅在與 token 值完全相等時才進行綁定,絕不自動捕捉最接近的值。圖示和元件則會根據名稱或外觀匹配,替換為庫中的對應版本。 該工具支援 Claude Code、Cursor 等 AI 代理平台,透過預設配置(presets)實現自動化綁定流程。若無預設,它會引導使用者手動查找並建立新的預設。綁定結果會提供詳細報告,包括綁定比率、已替換的圖示與元件數量,以及未綁定的顏色清單,供設計團隊審查決定。 此技能特別適合用於「綁定至庫」、「使用庫元件」、「檢查未綁定的變數顏色」或「將 code-to-figma 與 figma-state-board 的畫面綁定到設計系統」等場景。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/byby325/code-to-figma-ui-states/tree/HEAD/skills/figma-library-binding

在你喜歡的 AI 中提問

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

說明文件

綁定至設計系統庫

產品畫面必須使用專案的設計系統,而非僅依賴圖層本機設定。

選擇預設配置

每個設計系統都有一個預設配置,位於 presets/ 中。詢問使用者專案使用哪個系統,或檢查專案的依賴項(例如,如果專案依賴於設計 token 套件,則使用匹配的預設)。有關格式,請參閱 presets/README.md。如果沒有預設,請按照下方「自動綁定運作方式」一次性查找,然後將結果儲存為新的預設。如果專案沒有庫,請寫入「無」並在報告中說明。

開始之前,請使用 get_libraries 確認每個庫都已存在於 libraries_added_to_file 中。對於任何缺失的庫,請使用者在 Figma 中的「Assets › Libraries」下新增它們;在新增完成之前不要繼續。

綁定規則

與其改變畫面,不如保留未綁定的狀態。此工具僅執行以下操作;其餘部分保持本機狀態並在報告中列出。

類型規則不要做
顏色僅在完全匹配時綁定,包括透明度。半透明顏色需要一個具有該透明度的 token,因為 Figma 在綁定時會將不透明度重置為 1不要捕捉到最接近的顏色
圓角、描邊、間距、字級尺寸僅在數值完全相等時綁定不要將 3px 改為 2px 或 4px
別名 token指向另一個 token(原始 token 之上的語意 token)的 token,以其鏈結末端的最終值為準。當一個值同時擁有兩者時,擁有自身值的 token 優先;僅在其他值都沒有時才使用別名不要透過猜測在兩個具有相同值的語意 token 之間選擇;請報告此情況
文字樣式僅在字體、字級和行高全部相等時綁定如果字體不同,僅綁定字級
圖示僅在庫中存在相同名稱的元件時才進行替換;僅接受已確認具有相同用途的舊名稱映射不要使用意義相似但外觀不同的圖示
元件僅在庫元件外觀與產品相同時才進行替換;保留產品的大小如果外觀不同,保留本機元件且不更改產品畫面

為什麼不捕捉最接近的值:匹配的值並不代表匹配的意義,而且會導致狀態面板與程式碼不一致。沒有匹配 token 的值是設計系統中的一個缺口;將其列出供設計決定,而不是讓工具自行選擇。

自動綁定運作方式

如果已有預設,請在 al-capture.cjs 配置中設定 preset,並將預設名稱作為第四個引數傳遞給 al-pack.py;畫面在構建時會自動綁定。僅在沒有預設的情況下,請按照以下流程操作,然後將結果儲存為 presets/<name>.json:libs 是綁定配置,extract 是在提取過程中使用的精靈映射。

  1. 提取佈局樹後,列出 JSON 中的每個 lib(圖示名稱)
  2. 對於每個名稱,使用 search_design_system 搜尋圖示系統:system:cross 映射到 icon / system / cross。僅接受完全匹配的名稱
  3. 使用 search_design_system 尋找元件集,放置幾個實例,截取螢幕截圖,將其外觀與產品進行比較,然後決定 buttons.rules
  4. 組裝 opts.libs。先建立 3-4 張卡片並檢查 log.drift 和螢幕截圖;僅在外觀正確時才批次處理
const libs = {
  tokens: ['My DS - Foundation'],        // 從這些庫讀取變數
  icons: { 'system:cross': '<componentKey>' },
  buttons: {
    set: '<componentSetKey>',
    rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // key 是按鈕背景顏色
  },
  words: { value: 'Price' },             // 重新命名文字屬性以匹配團隊的術語
};

al-capture.cjs 的輸出包含 unmappedIcons,列出了本次使用但預設尚未映射的圖示。使用 search_design_system 查找它們,並將完全匹配的名稱新增到預設中;下次它們會自動綁定,因此預設會隨著使用而變得更完整。

__alBuild 返回的 stat 具有綁定結果:boundColors、boundLayout、libIcons、dsButtons、unboundColors、localIcons。

綁定現有畫面

al-bind.js 可以單獨使用。它僅綁定 token,不會替換圖示或元件。將整個腳本貼到 use_figma 中(或使用 eval 載入),然後呼叫:

return await __alBind(['<frame id>'], { tokens: ['<library name>'] });

它會返回 boundColors、boundLayout 和 unboundColors(沒有 token 的顏色)。skippedText 統計了無法載入字體的文字數量,因此其字級保持未綁定狀態。

當使用 __alBuild 構建畫面時,token 表會快取在 _registry 中,因此後續畫面無需再次匯入每個變數。當預設列出了不同的 token 庫時,它會重新建立。在庫發布新的或更改的 token 後,請將 refreshTokens: true 傳遞給下一個 __alBuild 呼叫。

元件

  • 使用自動佈局居中:不要使用內邊距或文字框寬度,以免更改文字時位移
  • 容器不是元件:一個已經包含元件的重複結構只是一個容器
  • 狀態是變體:選中和禁用必須透過屬性切換,而不是透過覆蓋實例顏色
  • 將小型元件拆分為屬性:兩個變體屬性 Type 和 State;將文字設為元件屬性
  • 主元件必須完整:不要將被視口裁切的元素製作成元件

報告

始終列出:

  • 綁定比率:顏色、佈局數值
  • 替換為庫版本的圖示和元件數量
  • 沒有 token 的顏色(前幾個),供設計決定
  • 保留在本機的圖示和元件及其原因

Individual skills in this repo

This repo contains 2 individual skills — each has its own dedicated page.

code-to-figma

Rebuild screens from a running web app as native, editable Figma layers (Auto Layout, components, instances) and diff them against browser screenshots — not a screenshot import or a Code layer. Use when the user asks to "turn this page into Figma", "code to Figma", "push this screen to Figma" or "rebuild the UI in Figma". 把 Web 專案實際跑出來的畫面重建成 Figma 原生圖層:造狀態、抽 DOM 版面樹,建 Auto Layout 和 component/instance,再跟瀏覽器截圖比對。單一畫面或一批畫面都能用,不需要做情境稿。Use when 使用者要「code to figma」「把這頁轉成 Figma」「從程式重建畫面」「push 畫面到 Figma」,或 figma-state-board 走路線 B。產出是可編輯圖層,不是 Code layer 或截圖。

figma-state-board

Inventory every UI state of a feature from its code and lay them out on one Figma canvas (a state board) — real screens for states the prototype already handles, plus a gap check of missing error, empty and loading states, split into spec-required and suggested. Use when the user asks for a "state board", "all states of this feature in Figma", "which error screens are missing", or to update an existing board. 從任何產品專案的程式碼盤點一個功能的所有狀態,在 Figma 產出或更新「情境稿」:原型(通常是 mock data 做的)已經有的狀態畫真實畫面,原型缺的狀態全列進「缺漏檢查」,再分「規格有寫」(規格要求、原型漏做)和「建議補」(規格和原型都沒提的錯誤、空狀態、載入等)。Use when 使用者要「做情境稿」「把所有狀態/狀況畫到 Figma」「state board」「檢查缺了哪些 error 畫面」,或要依新規則增修既有情境稿。只要狀態清單用 state-discovery,只要把畫面轉進 Figma 用 code-to-figma。

相關技能