Communitygithub.com

code-to-figma

Reconstruisez les écrans d'une application web en cours d'exécution sous forme de calques Figma natifs et modifiables (Auto Layout, composants, instances) et comparez-les avec des captures d'écran du navigateur — ce n'est ni une importation de capture d'écran ni un calque Code.

Qu'est-ce que code-to-figma ?

Cette compétence permet de transformer l'interface utilisateur d'une application web en cours d'exécution en éléments Figma natifs et entièrement modifiables. Elle extrait l'arborescence DOM du navigateur, puis reconstruit chaque écran sous forme de conteneurs Auto Layout, de composants et d'instances, avec une comparaison visuelle automatique via des captures d'écran de référence. Idéale pour les équipes de design et de développement qui souhaitent synchroniser le rendu réel de l'application avec un fichier Figma sans passer par des importations de captures ou des calques Code. La compétence prend en charge React (y compris Next.js App Router) et Vue 3 pour la détection des limites de composants ; les autres frameworks utilisent une détection de nœuds répétés. Elle gère également les bibliothèques de couleurs et de polices, et fournit un rapport détaillé sur la structure, les écarts et les limites connues. Attention : les applications natives et les écrans entièrement basés sur Canvas/WebGL ne sont pas pris en charge.

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

Demander à votre IA préférée

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

Documentation

Code to Figma

Exécutez le projet, extrayez le DOM en une arborescence de mise en page dans le navigateur, puis reconstruisez-la dans Figma sous forme de Auto Layout et de composants modifiables.

Pour les interfaces web front-end. Les limites des composants disposent d'adaptateurs pour Vue 3 et React (React 18 et 19 testés, y compris les composants serveur Next.js App Router ; React 16 et 17 ont la même structure de fibres mais ne sont pas testés). Les autres frameworks bénéficient uniquement de la détection de nœuds répétés. Les applications natives et les écrans entièrement dessinés dans Canvas/WebGL ne sont pas pris en charge ; utilisez plutôt le fichier de conception ou les maquettes.

FichierContenu
web-capture.mdLe processus complet ; lisez-le avant de commencer
screen-structure.mdRègles de structure que la sortie doit respecter
scale-guard.mdSeuils et conditions d'arrêt pour le budget d'appels MCP et la mémoire du fichier ; lisez-le avant de commencer
troubleshooting.mdTableau de recherche des pièges ; consultez-le lorsque les résultats sont erronés
examples/Modèles de configuration de capture pour quatre types de projet : maquette intégrée, fixture Playwright, Nuxt dev, interception de l'API backend
evals/trials.jsonCas de régression et références ; réexécutez-les tous après avoir modifié les outils

Étapes

  1. Confirmer les entrées : le projet et comment l'exécuter, quels écrans, la zone d'affichage et le type de hauteur de chaque écran, le fichier Figma cible et le système de conception à lier. L'utilisateur décide du sujet et du périmètre ; ne les choisissez pas vous-même. Une fois que vous avez le lien Figma, exécutez create_session plus un use_figma en lecture seule pour confirmer que le compte MCP avec lequel vous êtes connecté peut lire et écrire le fichier (s'il ne peut pas ouvrir le fichier, utilisez whoami pour expliquer de quel compte il s'agit et avec qui partager le fichier). Estimez ensuite le nombre d'appels nécessaires pour ce travail selon scale-guard.md "Budget d'appels MCP" ; si le budget est insuffisant, dites-le d'abord
  2. Démarrer le projet, écrire la configuration, capturer : exécutez al-capture.cjs, en suivant web-capture.md
  3. Construire d'abord un écran représentatif par appareil, le comparer avec la capture d'écran du navigateur, et ne faire le lot que lorsqu'il correspond
  4. Comparer chaque écran après le lot : exécutez al-diff.py ; faites également une capture d'écran et vérifiez la section Composants
  5. Auditer : exécutez audit-screens.js

Terminé lorsque : chaque écran a une reconstruction, la largeur du cadre racine de chaque écran est égale à la zone d'affichage, et l'écran représentatif de chaque appareil possède un calque de capture d'écran de référence ; issues est vide, ou chaque entrée est signalée avec sa cause ; la section Composants a été vérifiée dans une capture d'écran.

Règles strictes pour l'écriture dans Figma

La mémoire d'un fichier Figma peut dépasser la limite instantanément, même lorsque l'utilisation statique est faible, et un fichier qui explose ne peut pas toujours être récupéré (scale-guard.md "Incident"). Suivez ces règles sur chaque projet :

  1. Avant d'écrire dans un fichier existant, demandez à l'utilisateur de sauvegarder une version, y compris avant de supprimer ou de reconstruire des écrans que vous avez construits précédemment. Ne commencez pas tant que l'utilisateur n'a pas répondu que c'est sauvegardé. Lorsque la page cible ne contient rien d'autre que ce que vous avez construit vous-même (nouveau fichier, page vierge), vous pouvez ignorer cette étape ; mentionnez-le dans le rapport
  2. Envoyez un écran à la fois : téléchargez les images et le SVG de données de cet écran, construisez-le, confirmez que les cadres temporaires ALDATA- et ALIMG- sont supprimés, puis passez au suivant. Ne téléchargez pas tout le lot d'abord
  3. Si l'utilisateur signale un avertissement rouge ou un mode de récupération, arrêtez immédiatement. N'exécutez même pas un use_figma en lecture seule tant que l'utilisateur n'a pas confirmé que le fichier est correct
  4. Arrêtez lorsque la limite d'appels est atteinte : si un outil Figma renvoie "limite d'appels d'outil MCP Figma atteinte", ne réessayez pas et ne changez pas d'outil pour contourner le problème. Listez les écrans terminés et les ID de nœuds des cadres temporaires encore sur le canevas

Limites connues

  • Les limites des composants disposent d'adaptateurs pour Vue 3 et React ; les deux nécessitent le mode développement (les versions de production n'ont pas de noms de composants, et stats.json émettra un avertissement). Svelte, Angular et autres frameworks bénéficient uniquement de la détection de nœuds répétés ; pour en prendre en charge un, ajoutez une entrée à ADAPTERS dans al-extract.js
  • Règles de nommage des composants React : un nœud DOM est considéré comme une limite uniquement s'il est le seul nœud racine du composant, et le nom est tiré du composant le plus externe. Les composants qui ne font que passer des enfants (Provider, Tooltip, ErrorBoundary), les composants de style styled-components/emotion, et les composants internes du routeur et du framework ne comptent pas. Les noms des composants serveur Next.js nécessitent une version de développement React 19 (Next 15 et ultérieur) ; avec React 18, seuls les composants client sont capturés
  • React : le projet de démonstration Vite + Radix + Tailwind 4 a une référence de reconstruction Figma (quatre écrans, 0,02 à 0,12 % de différence par rapport au navigateur). Le projet Next.js App Router est vérifié uniquement par la capture et l'empaquetage
  • Les icônes qui utilisent un SVG comme mask-image et n'ont pas d'enfants (par exemple, frappe-ui, classes lucide-* d'UnoCSS) sont converties en vecteurs et colorées avec la couleur d'arrière-plan. Les autres utilisations de mask-image (dégradés fondus, masques bitmap) et clip-path n'ont pas d'équivalent ; les bords fondus et les découpes angulaires deviennent des formes pleines
  • Couleurs : rgb() est pris en charge, ainsi que les formats que Chrome peut renvoyer, tels que oklch(), color(srgb …), lab() et hsl() ; ces derniers sont convertis en sRGB via un canvas, et chaque canal peut être décalé de 1 (arrondi 8 bits)
  • L'API Plugin ne peut pas modifier la largeur d'un cadre à l'intérieur d'une instance. Un enfant unique qui s'étire pour remplir son cadre parent est modifié en Fill, les enfants qui s'étirent pour remplir le parent sont ajustés via le padding, et les cadres Auto Layout qui sont en Hug dans les données sont modifiés en Hug ; dans tous les autres cas, la taille suit le composant principal, et log.boxes les liste
  • Les petits éléments avec un z-index imbriqué peuvent se retrouver cachés ; l'arborescence des calques ne peut pas déplacer un seul enfant hors de son parent
  • Les polices système (ui-sans-serif) sont remplacées par Inter ; les largeurs de caractères diffèrent légèrement
  • font-variant-numeric: tabular-nums (chiffres tabulaires) ne peut pas être activé dans Figma : openTypeFeatures de l'API Plugin est en lecture seule. Les dates, heures et montants apparaissent plus étroits que dans le navigateur, et le texte qui les suit se décale de 5 à 8 pixels ; log.drift les liste
  • La rotation et les triangles CSS ne sont gérés que pour les éléments sans enfants (marques de coche, triangles d'onglet, petits carrés), qui sont convertis en vecteurs ; les conteneurs pivotés avec des enfants sont disposés par leur boîte englobante, et leur contenu n'est pas pivoté

Rapport

  • Structure : ratio de conteneurs Auto Layout, nombre de composants/variants ; quelles zones sont absolues (superpositions, contenu en cours de défilement)
  • Résultats de comparaison : dérive du texte, les écrans avec le ratio de différence le plus élevé, et les points connus qui ne peuvent pas être reproduits. Lisez le ratio de différence en contexte : les dégradés ou les mask-image bitmap augmentent le ratio, expliquez donc la cause ; lorsque stats.json avertit que des icônes sont vides, autorisez la source de l'icône et recapturez d'abord. Lorsqu'un écran entier n'a presque pas de couleur, vérifiez d'abord si le stat renvoyé par __alBuild a détecté des couleurs (troubleshooting.md)
  • Les captures d'écran de référence ne vont que sur les écrans représentatifs ; les autres restent dans le dossier de sortie local
  • Avec une bibliothèque liée, rédigez cette partie selon la section "Rapport" de figma-library-binding ; sans bibliothèque, les couleurs et les tailles de police sont des valeurs codées en dur
  • Les écrans sont reproduits à partir de données fictives ; quelles zones ont été remplies avec des captures d'écran en direct, et quelle copie a été modifiée dans les maquettes
  • Quelle police a été substituée lorsque Figma ne possède pas la police du produit
  • Échelle : une ligne au format scale-guard.md

Individual skills in this repo

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

figma-library-binding

Bind Figma screens to a design system library — tokens only on exact value matches, swap icons and components for library versions, and list unmatched values for designers instead of snapping to the nearest token. Use when the user asks to "bind tokens", "use library components" or "find unbound colors". 把 Figma 畫面綁到專案的 design system library:顏色、圓角、邊框、間距、字級完全相同才綁 token,圖示和元件換成 library 版本,沒有對應的值列給設計決定,不取最近值。Use when 使用者要「綁 library」「綁 token」「換成 design system 元件」「檢查沒綁 variable 的顏色」,或 code-to-figma、figma-state-board 的畫面要綁 design system。

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