Communitygithub.com

figma-library-binding

Binde Figma-Bildschirme an eine Designsystem-Bibliothek – Tokens nur bei exakter Wertübereinstimmung, tausche Icons und Komponenten gegen Bibliotheksversionen aus und liste nicht gefundene Werte für Designer auf, anstatt sie an den nächstgelegenen Token anzupassen. Verwende dies, wenn der Benutzer darum bittet, „Tokens zu binden“, „Bibliothekskomponenten zu verwenden“ oder „nicht gebundene Farben zu finden“.

Was ist figma-library-binding?

Diese Fertigkeit für Figma automatisiert die Bindung von Produktbildschirmen an ein Projekt-Designsystem. Sie stellt sicher, dass keine lokalen Layer verwendet werden, indem sie Farben, Radien, Striche, Abstände und Typgrößen nur bei exakten Übereinstimmungen (einschließlich Deckkraft) an Tokens bindet. Icons und Komponenten werden durch ihre Bibliotheksäquivalente ersetzt, vorausgesetzt, sie stimmen Namen und Erscheinungsbild exakt überein. Für Werte ohne passenden Token wird kein nächstgelegener Wert angenommen, sondern sie werden für die Designer-Entscheidung aufgelistet. Die Fertigkeit unterstützt sowohl die automatische Bindung während der Bildschirmkonstruktion (via `al-capture.cjs` und `al-pack.py` mit einem Preset) als auch die nachträgliche Bindung bestehender Bildschirme (via `scripts/al-bind.js`). Sie funktioniert mit Figma-Designtoken-Bibliotheken und verwendet die Funktionen `use_figma`, `get_libraries` und `search_design_system`, wobei sie einen detaillierten Report über gebundene vs. ungebundene Werte, ausgetauschte Icons/Komponenten und etwaige Konflikte erstellt. Das Skill verhindert eine automatische Annäherung an Werte, da sonst Code und Design nicht mehr übereinstimmen würden, und ermöglicht es Designern, Lücken im System zu schließen.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Binden an eine Designsystem-Bibliothek

Produktbildschirme müssen das Designsystem des Projekts verwenden, nicht nur lokale Layer.

Ein Preset auswählen

Jedes Designsystem hat ein Preset im Verzeichnis presets/. Frage den Benutzer, welches Preset das Projekt verwendet, oder prüfe die Abhängigkeiten des Projekts (z. B. wenn das Projekt von einem Designtoken-Paket abhängt, verwende das passende Preset). Das Format ist in presets/README.md beschrieben. Wenn kein Preset existiert, suche einmalig wie unter „Wie automatisches Binden funktioniert“ unten beschrieben, und speichere das Ergebnis als neues Preset. Wenn das Projekt keine Bibliothek hat, schreibe „Keine“ und erwähne dies im Bericht.

Bevor du beginnst, verwende get_libraries, um zu bestätigen, dass sich jede Bibliothek in libraries_added_to_file befindet. Falls welche fehlen, bitte den Benutzer, sie in Figma unter Assets › Bibliotheken hinzuzufügen; fahre erst fort, wenn sie hinzugefügt sind.

Bindungsregeln

Es ist besser, etwas ungebunden zu lassen, als den Bildschirm zu verändern. Das Werkzeug führt nur die unten aufgeführten Aktionen aus; alles andere bleibt lokal und wird gemeldet.

TypRegelNicht tun
FarbeNur bei exakter Übereinstimmung binden, einschließlich Deckkraft. Halbtransparente Farben benötigen einen Token mit dieser Transparenz, da Figma beim Binden die Deckkraft auf 1 zurücksetztNicht an die nächstgelegene Farbe annähern
Radius, Strich, Abstand, SchriftgrößeNur binden, wenn der Wert exakt gleich ist3px nicht auf 2px oder 4px ändern
Alias-TokenEin Token, der auf einen anderen Token verweist (semantischer Token über einem primitiven), zählt mit dem Wert am Ende der Kette. Wenn ein Wert beide hat, gewinnt der Token mit eigenem Wert; der Alias wird nur für Werte verwendet, die sonst kein Token hatNicht zwischen zwei semantischen Token mit demselben Wert raten; melden
TextstilNur binden, wenn Schriftart, Größe und Zeilenhöhe alle gleich sindWenn die Schriftart abweicht, nur die Größe binden
IconNur ersetzen, wenn die Bibliothek eine Komponente mit demselben Namen hat; alte Namen nur für Zuordnungen akzeptieren, die denselben Zweck bestätigenKein Icon mit ähnlicher Bedeutung aber anderem Aussehen verwenden
KomponenteNur ersetzen, wenn die Bibliothekskomponente gleich aussieht wie die Produktkomponente; die Größe des Produkts beibehaltenWenn sie anders aussieht, lokale Komponente behalten und Produktbildschirm nicht ändern

Warum nicht auf den nächstgelegenen Wert annähern: Ein passender Wert bedeutet nicht unbedingt eine passende Bedeutung, und es führt dazu, dass das Zustandsboard nicht mit dem Code übereinstimmt. Ein Wert ohne passenden Token ist eine Lücke im Designsystem; liste ihn zur Designer-Entscheidung auf, anstatt das Werkzeug wählen zu lassen.

Wie automatisches Binden funktioniert

Mit einem Preset setze preset in der al-capture.cjs-Konfiguration und übergib den Preset-Namen als viertes Argument an al-pack.py; Bildschirme werden automatisch gebunden, wenn sie erstellt werden. Nur ohne Preset befolge den untenstehenden Prozess und speichere das Ergebnis als presets/<name>.json: libs ist die Bindungskonfiguration, und extract ist das Sprite-Mapping, das während der Extraktion verwendet wird.

  1. Liste nach dem Extrahieren des Layoutbaums jedes lib (Icon-Name) im JSON auf
  2. Suche für jeden Namen im Icon-System mit search_design_system: system:cross wird zu icon / system / cross. Akzeptiere nur exakte Namensübereinstimmungen
  3. Verwende search_design_system, um das Komponenten-Set zu finden, platziere einige Instanzen, mache Screenshots davon, vergleiche ihr Aussehen mit dem Produkt und lege buttons.rules fest
  4. Setze opts.libs zusammen. Erstelle zunächst 3–4 Karten und überprüfe log.drift und die Screenshots; führe Batch-Verarbeitung nur durch, wenn sie richtig aussehen
const libs = {
  tokens: ['My DS - Foundation'],        // Variablen aus diesen Bibliotheken lesen
  icons: { 'system:cross': '<componentKey>' },
  buttons: {
    set: '<componentSetKey>',
    rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // Schlüssel ist die Hintergrundfarbe des Buttons
  },
  words: { value: 'Price' },             // Texteigenschaften umbenennen, um den Begriffen des Teams zu entsprechen
};

Die Ausgabe von al-capture.cjs enthält unmappedIcons, die Icons dieser Verwendung auflistet, die das Preset noch nicht zugeordnet hat. Suche sie mit search_design_system und füge exakte Namensübereinstimmungen zum Preset hinzu; beim nächsten Mal werden sie automatisch gebunden, sodass das Preset mit der Zeit vollständiger wird.

Das von __alBuild zurückgegebene stat enthält die Bindungsergebnisse: boundColors, boundLayout, libIcons, dsButtons, unboundColors, localIcons.

Binden vorhandener Bildschirme

al-bind.js kann eigenständig verwendet werden. Es bindet nur Tokens und tauscht keine Icons oder Komponenten aus. Füge das gesamte Skript in use_figma ein (oder lade es mit eval), und rufe dann Folgendes auf:

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

Es gibt boundColors, boundLayout und unboundColors (Farben ohne Token) zurück. skippedText zählt Text, dessen Schriftart nicht geladen werden konnte, sodass seine Größe ungebunden blieb.

Wenn Bildschirme mit __alBuild erstellt werden, wird die Tokentabelle in _registry zwischengespeichert, sodass spätere Bildschirme nicht jede Variable erneut importieren müssen. Sie wird neu aufgebaut, wenn das Preset andere Token-Bibliotheken auflistet. Nachdem die Bibliothek neue oder geänderte Token veröffentlicht hat, übergib refreshTokens: true an den nächsten __alBuild-Aufruf.

Komponenten

  • Mit Auto Layout zentrieren: nicht mit Abstand oder Textfeldbreite, damit eine Textänderung ihn nicht verschiebt
  • Container sind keine Komponenten: eine wiederholte Struktur, die bereits Komponenten enthält, ist nur ein Container
  • Zustände sind Varianten: Ausgewählt und deaktiviert müssen über Eigenschaften umschaltbar sein, nicht durch Überschreiben von Instanzfarben
  • Kleine Komponenten in Eigenschaften aufteilen: zwei Varianteneigenschaften, Type und State; mache den Text zu einer Komponenteneigenschaft
  • Hauptkomponenten müssen vollständig sein: mache keine Elemente, die durch den Viewport abgeschnitten sind, zu Komponenten

Bericht

Liste immer auf:

  • Bindungsrate: Farben, Layout-Werte
  • Anzahl der Icons und Komponenten, die gegen Bibliotheksversionen ausgetauscht wurden
  • Farben ohne Token (die obersten), zur Entscheidung für das Design
  • Icons und Komponenten, die lokal behalten wurden, und warum

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。

Verwandte Skills