Implémenter un Design
Aperçu
Cette compétence fournit un flux de travail structuré pour traduire des designs Figma en code prêt pour la production avec une précision pixel par pixel. Elle garantit une intégration cohérente avec le serveur Figma MCP, l'utilisation appropriée des jetons de design et une parité visuelle 1:1 avec les designs.
Limites de la compétence
- Utilisez cette compétence lorsque le livrable est du code dans le dépôt de l'utilisateur.
- Si l'utilisateur demande de créer/modifier/supprimer des nœuds dans Figma lui-même, passez à figma-use.
- Si l'utilisateur demande de construire ou de mettre à jour un écran pleine page dans Figma à partir de code ou d'une description, passez à figma-generate-design.
- Si l'utilisateur demande uniquement des correspondances Code Connect, passez à figma-code-connect-components.
- Si l'utilisateur demande de rédiger des règles d'agent réutilisables (
CLAUDE.md/AGENTS.md), passez à figma-create-design-system-rules.
Prérequis
- Le serveur Figma MCP doit être connecté et accessible
- L'utilisateur doit fournir une URL Figma au format :
https://figma.com/design/:fileKey/:fileName?node-id=1-2:fileKeyest la clé du fichier1-2est l'identifiant du nœud (le composant ou le cadre spécifique à implémenter)
- OU lors de l'utilisation de
figma-desktopMCP : l'utilisateur peut sélectionner un nœud directement dans l'application de bureau Figma (aucune URL requise) - Le projet doit avoir un système de design ou une bibliothèque de composants établi (recommandé)
Flux de travail requis
Suivez ces étapes dans l'ordre. Ne sautez pas d'étapes.
Étape 1 : Obtenir l'identifiant du nœud
Option A : Analyser à partir de l'URL Figma
Lorsque l'utilisateur fournit une URL Figma, extrayez la clé du fichier et l'identifiant du nœud à passer comme arguments aux outils MCP.
Format de l'URL : https://figma.com/design/:fileKey/:fileName?node-id=1-2
Extraire :
- Clé du fichier :
:fileKey(le segment après/design/) - Identifiant du nœud :
1-2(la valeur du paramètre de requêtenode-id)
Remarque : Lors de l'utilisation du MCP de bureau local (figma-desktop), fileKey n'est pas passé comme paramètre aux appels d'outils. Le serveur utilise automatiquement le fichier actuellement ouvert, donc seul nodeId est nécessaire.
Exemple :
- URL :
https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 - Clé du fichier :
kL9xQn2VwM8pYrTb4ZcHjF - Identifiant du nœud :
42-15
Option B : Utiliser la sélection actuelle de l'application de bureau Figma (figma-desktop MCP uniquement)
Lors de l'utilisation du MCP figma-desktop et que l'utilisateur n'a PAS fourni d'URL, les outils utilisent automatiquement le nœud actuellement sélectionné dans le fichier Figma ouvert dans l'application de bureau.
Remarque : La sollicitation basée sur la sélection ne fonctionne qu'avec le serveur MCP figma-desktop. Le serveur distant nécessite un lien vers un cadre ou un calque pour extraire le contexte. L'utilisateur doit avoir l'application de bureau Figma ouverte avec un nœud sélectionné.
Étape 2 : Récupérer le contexte de design
Exécutez get_design_context avec la clé du fichier et l'identifiant du nœud extraits.
get_design_context(fileKey=":fileKey", nodeId="1-2")
Cela fournit les données structurées incluant :
- Propriétés de mise en page (Auto Layout, contraintes, dimensionnement)
- Spécifications typographiques
- Valeurs de couleur et jetons de design
- Structure des composants et variantes
- Valeurs d'espacement et de remplissage
Si la réponse est trop volumineuse ou tronquée :
- Exécutez
get_metadata(fileKey=":fileKey", nodeId="1-2")pour obtenir la carte des nœuds de haut niveau - Identifiez les nœuds enfants spécifiques nécessaires à partir des métadonnées
- Récupérez les nœuds enfants individuels avec
get_design_context(fileKey=":fileKey", nodeId=":childNodeId")
Étape 3 : Capturer une référence visuelle
Exécutez get_screenshot avec la même clé de fichier et le même identifiant de nœud pour une référence visuelle.
get_screenshot(fileKey=":fileKey", nodeId="1-2")
Cette capture d'écran sert de source de vérité pour la validation visuelle. Gardez-la accessible tout au long de l'implémentation.
Étape 4 : Télécharger les ressources requises
Téléchargez toutes les ressources (images, icônes, SVG) renvoyées par le serveur Figma MCP.
IMPORTANT : Suivez ces règles concernant les ressources :
- Si le serveur Figma MCP renvoie une source
localhostpour une image ou un SVG, utilisez cette source directement - N'IMPORTEZ PAS et n'ajoutez PAS de nouveaux packages d'icônes - toutes les ressources doivent provenir de la charge utile Figma
- N'UTILISEZ PAS et ne créez PAS d'espaces réservés si une source
localhostest fournie - Les ressources sont servies via le point de terminaison de ressources intégré du serveur Figma MCP
Étape 5 : Traduire selon les conventions du projet
Traduisez la sortie Figma dans le framework, les styles et les conventions de ce projet.
Principes clés :
- Considérez la sortie Figma MCP (généralement React + Tailwind) comme une représentation du design et du comportement, et non comme un style de code final
- Remplacez les classes utilitaires Tailwind par les utilitaires ou les jetons de système de design préférés du projet
- Réutilisez les composants existants (boutons, champs de saisie, typographie, wrappers d'icônes) au lieu de dupliquer les fonctionnalités
- Utilisez le système de couleurs, l'échelle typographique et les jetons d'espacement du projet de manière cohérente
- Respectez les modèles de routage, de gestion d'état et de récupération de données existants
Étape 6 : Atteindre la parité visuelle 1:1
Efforcez-vous d'obtenir une parité visuelle pixel parfait avec le design Figma.
Directives :
- Donnez la priorité à la fidélité Figma pour correspondre exactement aux designs
- Évitez les valeurs codées en dur - utilisez les jetons de design de Figma lorsqu'ils sont disponibles
- En cas de conflit entre les jetons du système de design et les spécifications Figma, préférez les jetons du système de design mais ajustez l'espacement ou les tailles de manière minimale pour correspondre aux visuels
- Suivez les exigences WCAG pour l'accessibilité
- Ajoutez de la documentation pour les composants si nécessaire
Étape 7 : Valider par rapport à Figma
Avant de marquer comme terminé, validez l'interface utilisateur finale par rapport à la capture d'écran Figma.
Liste de vérification de validation :
- La mise en page correspond (espacement, alignement, dimensionnement)
- La typographie correspond (police, taille, graisse, hauteur de ligne)
- Les couleurs correspondent exactement
- Les états interactifs fonctionnent comme conçu (survol, actif, désactivé)
- Le comportement réactif suit les contraintes Figma
- Les ressources s'affichent correctement
- Les normes d'accessibilité sont respectées
Règles d'implémentation
Organisation des composants
- Placez les composants d'interface utilisateur dans le répertoire du système de design désigné du projet
- Suivez les conventions de nommage des composants du projet
- Évitez les styles en ligne sauf s'ils sont vraiment nécessaires pour des valeurs dynamiques
Intégration du système de design
- Utilisez TOUJOURS les composants du système de design du projet lorsque c'est possible
- Faites correspondre les jetons de design Figma aux jetons de design du projet
- Lorsqu'un composant correspondant existe, étendez-le plutôt que d'en créer un nouveau
- Documentez tout nouveau composant ajouté au système de design
Qualité du code
- Évitez les valeurs codées en dur - extrayez-les vers des constantes ou des jetons de design
- Gardez les composants composables et réutilisables
- Ajoutez des types TypeScript pour les props des composants
- Incluez des commentaires JSDoc pour les composants exportés
Exemples
Exemple 1 : Implémenter un composant Bouton
L'utilisateur dit : « Implémente ce composant bouton Figma : https://figma.com/design/kL9xQn2VwM8pYrTb4ZcHjF/DesignSystem?node-id=42-15 »
Actions :
- Analyser l'URL pour extraire fileKey=
kL9xQn2VwM8pYrTb4ZcHjFet nodeId=42-15 - Exécuter
get_design_context(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15") - Exécuter
get_screenshot(fileKey="kL9xQn2VwM8pYrTb4ZcHjF", nodeId="42-15")pour référence visuelle - Télécharger les icônes de bouton depuis le point de terminaison des ressources
- Vérifier si le projet a un composant bouton existant
- Si oui, l'étendre avec une nouvelle variante ; si non, créer un nouveau composant en utilisant les conventions du projet
- Faire correspondre les couleurs Figma aux jetons de design du projet (par exemple,
primary-500,primary-hover) - Valider par rapport à la capture d'écran pour le remplissage, le rayon de bordure, la typographie
Résultat : Composant bouton correspondant au design Figma, intégré au système de design du projet.
Exemple 2 : Construire une mise en page de tableau de bord
L'utilisateur dit : « Construis ce tableau de bord : https://figma.com/design/pR8mNv5KqXzGwY2JtCfL4D/Dashboard?node-id=10-5 »
Actions :
- Analyser l'URL pour extraire fileKey=
pR8mNv5KqXzGwY2JtCfL4Det nodeId=10-5 - Exécuter
get_metadata(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")pour comprendre la structure de la page - Identifier les sections principales à partir des métadonnées (en-tête, barre latérale, zone de contenu, cartes) et leurs identifiants de nœuds enfants
- Exécuter
get_design_context(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId=":childNodeId")pour chaque section majeure - Exécuter
get_screenshot(fileKey="pR8mNv5KqXzGwY2JtCfL4D", nodeId="10-5")pour la page entière - Télécharger toutes les ressources (logos, icônes, graphiques)
- Construire la mise en page en utilisant les primitives de mise en page du projet
- Implémenter chaque section en utilisant les composants existants lorsque c'est possible
- Valider le comportement réactif par rapport aux contraintes Figma
Résultat : Tableau de bord complet correspondant au design Figma avec une mise en page réactive.
Bonnes pratiques
Commencez toujours par le contexte
N'implémentez jamais sur la base d'hypothèses. Récupérez toujours get_design_context et get_screenshot en premier.
Validation incrémentale
Validez fréquemment pendant l'implémentation, pas seulement à la fin. Cela permet de détecter les problèmes rapidement.
Documentez les écarts
Si vous devez vous écarter du design Figma (par exemple, pour des raisons d'accessibilité ou de contraintes techniques), documentez pourquoi dans les commentaires du code.
Réutilisation plutôt que recréation
Vérifiez toujours l'existence de composants existants avant d'en créer de nouveaux. La cohérence dans la base de code est plus importante que la réplication exacte de Figma.
Le système de design d'abord
En cas de doute, préférez les modèles du système de design du projet à la traduction littérale de Figma.
Problèmes courants et solutions
Problème : La sortie Figma est tronquée
Cause : Le design est trop complexe ou a trop de calques imbriqués pour tenir dans une seule réponse.
Solution : Utilisez get_metadata pour obtenir la structure du nœud, puis récupérez les nœuds spécifiques individuellement avec get_design_context.
Problème : Le design ne correspond pas après l'implémentation
Cause : Des divergences visuelles entre le code implémenté et le design Figma original. Solution : Comparez côte à côte avec la capture d'écran de l'étape 3. Vérifiez les valeurs d'espacement, de couleurs et de typographie dans les données de contexte de design.
Problème : Les ressources ne se chargent pas
Cause : Le point de terminaison de ressources du serveur Figma MCP n'est pas accessible ou les URL sont modifiées.
Solution : Vérifiez que le point de terminaison de ressources du serveur Figma MCP est accessible. Le serveur sert les ressources à des URL localhost. Utilisez-les directement sans modification.
Problème : Les valeurs des jetons de design diffèrent de Figma
Cause : Les jetons du système de design du projet ont des valeurs différentes de celles spécifiées dans le design Figma. Solution : Lorsque les jetons du projet diffèrent des valeurs Figma, préférez les jetons du projet pour la cohérence, mais ajustez l'espacement/le dimensionnement pour maintenir la fidélité visuelle.
Comprendre l'implémentation du design
Le flux de travail d'implémentation Figma établit un processus fiable pour traduire les designs en code :
Pour les designers : Confiance que les implémentations correspondront à leurs designs avec une précision pixel parfaite. Pour les développeurs : Une approche structurée qui élimine les conjectures et réduit les allers-retours de révisions. Pour les équipes : Des implémentations cohérentes et de haute qualité qui maintiennent l'intégrité du système de design.
En suivant ce flux de travail, vous assurez que chaque design Figma est implémenté avec le même niveau de soin et d'attention aux détails.