Communitygithub.com

figma-library-binding

Lier les écrans Figma à une bibliothèque de système de design : utiliser des tokens uniquement lorsque les valeurs correspondent exactement, remplacer les icônes et composants par les versions de la bibliothèque, et lister les valeurs non trouvées pour que les designers décident, plutôt que de choisir la valeur la plus proche.

Qu'est-ce que figma-library-binding ?

Cette compétence automatise la liaison (binding) des écrans Figma à une bibliothèque de système de design existante, garantissant une cohérence visuelle et technique avec le code. Contrairement à une approche par arrondi ou valeur la plus proche, ce skill applique des règles strictes : une couleur, rayon, épaisseur de trait, espacement ou taille de police n'est liée que si la valeur est identique, y compris l'opacité. Les icônes et composants sont échangés contre les versions de la bibliothèque uniquement si le nom correspond exactement ou s'il existe un mapping validé. Les valeurs sans token correspondant sont rapportées comme des écarts à combler par l'équipe design, plutôt que d'être modifiées automatiquement. La compétence prend en charge à la fois une configuration automatique via un preset et la liaison ponctuelle d'écrans existants avec un script. Elle fournit un rapport détaillé incluant le ratio de liaison, les icônes échangées, et les éléments non liés, facilitant la collaboration entre développeurs et designers pour maintenir un système de design robuste.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Liaison à une bibliothèque de système de design

Les écrans produits doivent utiliser le système de design du projet, pas seulement des calques locaux.

Choisir un preset

Chaque système de design a un preset, dans presets/. Demandez à l'utilisateur lequel le projet utilise, ou vérifiez les dépendances du projet (par exemple, si le projet dépend d'un package de jetons de design, utilisez le preset correspondant). Voir presets/README.md pour le format. S'il n'y a pas de preset, recherchez-le une fois en suivant « Comment fonctionne la liaison automatique » ci-dessous, puis enregistrez le résultat comme nouveau preset. Si le projet n'a pas de bibliothèque, écrivez « Aucun » et mentionnez-le dans le rapport.

Avant de commencer, utilisez get_libraries pour confirmer que chaque bibliothèque est dans libraries_added_to_file. Pour celles qui manquent, demandez à l'utilisateur de les ajouter dans Figma sous Ressources › Bibliothèques ; ne continuez pas tant qu'elles ne sont pas ajoutées.

Règles de liaison

Mieux vaut laisser quelque chose non lié que de modifier l'écran. L'outil ne fait que ce qui est indiqué ci-dessous ; tout le reste reste local et est signalé.

TypeRègleNe pas faire
CouleurLier uniquement en cas de correspondance exacte, y compris l'opacité. Les couleurs semi-transparentes nécessitent un token avec cette transparence, car Figma réinitialise l'opacité à 1 lors de la liaisonNe pas arrondir à la couleur la plus proche
Rayon, trait, espacement, taille de policeLier uniquement lorsque la valeur est exactement égaleNe pas transformer 3px en 2px ou 4px
Jetons d'aliasUn jeton qui pointe vers un autre jeton (jeton sémantique sur un primitif) compte avec la valeur au bout de la chaîne. Lorsqu'une valeur a les deux, le jeton avec sa propre valeur l'emporte ; l'alias n'est utilisé que pour les valeurs que rien d'autre n'aNe pas choisir entre deux jetons sémantiques de même valeur en devinant ; signalez-le
Style de texteLier uniquement lorsque la police, la taille et la hauteur de ligne sont toutes égalesSi la police diffère, ne lier que la taille
IcôneÉchanger uniquement lorsque la bibliothèque a un composant avec le même nom ; accepter les anciens noms uniquement pour les mappings confirmés comme ayant le même objectifNe pas utiliser une icône avec une signification similaire mais un aspect différent
ComposantÉchanger uniquement lorsque le composant de la bibliothèque ressemble au produit ; conserver la taille du produitS'il a un aspect différent, garder le composant local et ne pas modifier l'écran produit

Pourquoi ne pas arrondir à la valeur la plus proche : une valeur correspondante ne signifie pas une signification correspondante, et cela fait que le tableau d'état diffère du code. Une valeur sans jeton correspondant est un écart dans le système de design ; listez-la pour que le design décide, plutôt que de laisser l'outil choisir.

Comment fonctionne la liaison automatique

Avec un preset, définissez preset dans la configuration al-capture.cjs et passez le nom du preset comme quatrième argument à al-pack.py ; les écrans sont liés automatiquement lorsqu'ils sont construits. Uniquement sans preset, suivez le processus ci-dessous, puis enregistrez le résultat comme presets/<nom>.json : libs est la configuration de liaison, et extract est le mapping de sprites utilisé lors de l'extraction.

  1. Après avoir extrait l'arbre de mise en page, listez chaque lib (nom d'icône) dans le JSON
  2. Pour chaque nom, recherchez le système d'icônes avec search_design_system : system:cross correspond à icon / system / cross. N'acceptez que les correspondances exactes de nom
  3. Utilisez search_design_system pour trouver le jeu de composants, placez quelques instances, prenez des captures d'écran, comparez leur aspect avec le produit, et décidez buttons.rules
  4. Assemblez opts.libs. Construisez d'abord 3–4 cartes et vérifiez log.drift et les captures d'écran ; ne traitez par lots que si elles semblent correctes
const libs = {
  tokens: ['My DS - Foundation'],        // lire les variables de ces bibliothèques
  icons: { 'system:cross': '<componentKey>' },
  buttons: {
    set: '<componentSetKey>',
    rules: { FFE13A: { Type: 'primary', Size: 'medium', Compact: 'false', Status: 'default' } }, // la clé est la couleur d'arrière-plan du bouton
  },
  words: { value: 'Price' },             // renommer les propriétés de texte pour correspondre aux termes de l'équipe
};

La sortie de al-capture.cjs inclut unmappedIcons, listant les icônes utilisées cette fois que le preset ne mappe pas encore. Recherchez-les avec search_design_system et ajoutez les correspondances exactes de nom au preset ; la prochaine fois, elles seront liées automatiquement, donc le preset devient plus complet à l'usage.

Le stat renvoyé par __alBuild contient les résultats de liaison : boundColors, boundLayout, libIcons, dsButtons, unboundColors, localIcons.

Lier des écrans existants

al-bind.js peut être utilisé seul. Il lie uniquement les jetons et n'échange pas les icônes ou composants. Collez l'intégralité du script dans use_figma (ou chargez-le avec eval), puis appelez :

return await __alBind(['<id du cadre>'], { tokens: ['<nom de la bibliothèque>'] });

Il renvoie boundColors, boundLayout, et unboundColors (couleurs sans jeton). skippedText compte le texte dont la police n'a pas pu être chargée, donc sa taille est restée non liée.

Lorsque les écrans sont construits avec __alBuild, la table des jetons est mise en cache dans _registry afin que les écrans suivants n'importent pas à nouveau chaque variable. Elle est reconstruite lorsque le preset liste différentes bibliothèques de jetons. Après que la bibliothèque publie de nouveaux jetons ou des jetons modifiés, passez refreshTokens: true au prochain appel __alBuild.

Composants

  • Centrer avec Auto Layout : pas avec le rembourrage ou la largeur de la zone de texte, pour que changer le texte ne le déplace pas
  • Les conteneurs ne sont pas des composants : une structure répétée qui contient déjà des composants n'est qu'un conteneur
  • Les états sont des variantes : sélectionné et désactivé doivent pouvoir être commutés via des propriétés, pas en remplaçant les couleurs de l'instance
  • Diviser les petits composants en propriétés : deux propriétés de variante, Type et State ; faire du texte une propriété de composant
  • Les composants principaux doivent être complets : ne pas faire d'éléments coupés par la zone d'affichage des composants

Rapport

Listez toujours :

  • Ratio de liaison : couleurs, valeurs de mise en page
  • Nombre d'icônes et de composants échangés contre les versions de la bibliothèque
  • Couleurs sans jeton (les premières), pour que le design décide
  • Icônes et composants conservés localement, et pourquoi

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。

Skills associés