Communitygithub.com

système-de-design

À utiliser lors du démarrage d'un système de design, d'un guide de style ou d'un ensemble de tokens, de l'ajout ou de la modification d'un composant ou token, de la standardisation d'écrans qui ont divergé, ou de l'audit d'un guide pour des couleurs isolées, des pièces uniques, des états manquants ou des écrans qui ne correspondent pas.

Qu'est-ce que système-de-design ?

Ce skill guide un agent IA à travers la création, la modification ou l'audit d'un système de design. Il insiste sur une approche en couches : fondations d'abord (couleurs, typographie, espacement, etc.), puis règles d'interaction, et enfin composants un par un, avec une validation à chaque étape. Le skill s'applique à tout outil de design (Figma, code HTML, etc.) via des adaptateurs dans le dossier `references/adapters/`. Il fournit des checklists et matrices d'états, des règles fermes (toute couleur = token, matrice d'états pour chaque élément interactif, un seul jeu d'icônes) et des valeurs par défaut qui peuvent être surchargées par un guide existant. L'audit se termine par un rapport classé par sévérité, sans modification de fichier sans approbation.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/diego3g/design-skills/tree/HEAD/skills/design-system

Demander à votre IA préférée

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

Documentation

Système de design

Présentation

Un système de design est l'endroit où une décision est prise une fois puis réutilisée partout. Chaque couleur est un token, chaque élément interactif montre tous ses états, et chaque changement atteint tous les écrans qui utilisent l'élément. Construisez-le en couches, fondations d'abord, et arrêtez-vous pour validation à chaque couche. Un audit rapporte et ne corrige jamais tout seul.

Quand l'utiliser

  • "Démarrer un guide de style / système de design / tokens pour …"
  • Ajouter un composant, une variante ou un token, ou en modifier un existant.
  • "Rendre ces écrans cohérents", "standardiser", "auditer le guide", ou des valeurs hexadécimales isolées et des pièces uniques dans les écrans.

Quand NE PAS l'utiliser

  • Une question sur une valeur ("quelle est notre couleur primaire?") : répondez-y.
  • Une petite modification que la personne a décrite exactement (une valeur, un libellé, une taille), même sur un élément partagé : changez-la une fois là où elle est définie et dites quels écrans cela affecte. Pas de matrice d'états, pas d'arrêt.

Avant de commencer

  1. Lisez DESIGN.md à la racine du projet s'il existe : c'est le briefing de design du projet.
  2. Trouvez ce qui existe : les tokens, le guide, les composants, les écrans et le code. Un guide existant prévaut sur l'apparence. Suivez ses règles même si elles diffèrent des valeurs par défaut ci-dessous, et mentionnez la différence une fois.
  3. Choisissez l'adaptateur de votre outil dans references/adapters/ (paper.md, figma.md, html.md). Si aucun adaptateur ne correspond à votre outil, effectuez les mêmes actions dans votre outil et dites lesquelles vous avez adaptées manuellement. Sans outil de design du tout, construisez en HTML (html.md). Si vous n'avez qu'une image, dites que les valeurs lues sont des estimations.
  4. Décidez du mode : créer, ajouter ou modifier, ou auditer.

Étapes · créer

  1. Brouillon des fondations :

    • rôles de couleurs (rôles de tokens);
    • échelle typographique;
    • espacement;
    • rayon;
    • ombres (deux au maximum);
    • largeurs de mise en page;
    • durées d'animation;
    • une courte section "comment nous écrivons".

    Nommez les tokens par rôle (text-muted, border-hover, danger-bg), jamais seulement par valeur (gray-500).

  2. Règles d'interaction, une fois : pour les éléments avec bordure, sans bordure et l'action primaire, écrivez à quoi ressemblent le survol, l'enfoncement, le focus (clavier uniquement), désactivé, chargement et sélectionné. Les composants suivent ces règles plutôt que d'en inventer chacun.

  3. Arrêtez-vous et montrez à la personne les fondations et les règles d'interaction. Ne construisez pas encore les composants.

  4. Composants un par un, dans l'ordre dont les premiers écrans ont besoin. Chacun reçoit une section du guide avec l'anatomie du composant : une légende avec la règle et le pourquoi, des exemples, et une matrice d'états des variantes × états. Ajoutez chacun à l'index des composants.

Étapes · ajouter ou modifier un élément

  1. Vérifiez si un composant existant plus une variante le couvre. Préférez la réutilisation à une pièce unique.
  2. Dessinez-le avec l'anatomie, y compris la matrice d'états complète. Une nouvelle couleur, taille ou icône devient un token ou une entrée dans le jeu d'icônes maintenant, pas plus tard.
  3. Listez chaque écran et emplacement de code qui utilise l'élément.
  4. Arrêtez-vous et montrez à la personne le changement et cette liste.
  5. Sur approbation, propagez :
    • mettez à jour chaque écran de la liste;
    • mettez à jour le code, le cas échéant;
    • mettez à jour l'index des composants;
    • rapportez ce qui a changé et où.

Étapes · auditer

  1. Exécutez la liste de vérification d'audit sur le guide, les écrans et le code s'il y en a.
  2. Rédigez le rapport : constats classés par sévérité, chacun avec où il se trouve, pourquoi il est important et la correction proposée.
  3. Arrêtez-vous et montrez à la personne le rapport. Ne modifiez aucun fichier jusqu'à ce qu'elle indique quelles corrections appliquer. Sauvegarder les originaux ne rend pas leur modification acceptable.

Règles

Fermes (tout projet) :

RèglePourquoi
Chaque couleur est un token ; pas de valeurs hexadécimales isolées dans les écrans ou le codeLes valeurs isolées dérivent en quasi-doublons que personne ne peut changer d'un coup
Un seul jeu d'icônesLes jeux mélangés ressemblent à des produits mélangés
Design et code changent ensemble, design en premierSinon le guide cesse d'être la vérité en une semaine
Chaque élément interactif a une matrice d'étatsLes états dessinés au coup par coup sur les écrans ne s'accordent jamais
Un changement sur un élément partagé est listé avec les écrans qu'il affecte avant d'être propagéSinon un "petit" changement redessine silencieusement vingt écrans

Valeurs par défaut (un guide existant les surcharge) :

Valeur par défautPourquoi
Au survol, les éléments avec bordure ne foncent que la bordureUn arrière-plan changeant sur les cartes et champs semble lourd
Le survol est plus subtil que le sélectionnéQuand le survol ressemble au sélectionné, les gens pensent que deux choses sont choisies
La sélection ne change jamais le poids de la policeUn changement de poids déplace la largeur du texte
Les espaces réservés sont plus clairs que le texte atténuéSinon un espace réservé se lit comme du texte saisi
Les éléments dans des listes empilées et des menus ont un petit écart, jamais collésLes surbrillances collées fusionnent en un seul bloc
L'anneau de focus n'apparaît qu'avec le clavierUn anneau après un clic souris ressemble à un bug
Le chargement conserve la taille exacte de l'élémentDécalage de mise en page
Les ombres uniquement sur les éléments flottants (menus, popovers, dialogues, toasts), à deux intensitésDes ombres partout aplatissent la hiérarchie qu'elles étaient censées créer
Au maximum une action primaire par écranDeux primaires signifie que l'écran n'a pas décidé

Fait quand

  • Créer : fondations et règles d'interaction approuvées ; chaque composant a son anatomie, sa matrice d'états et une ligne dans l'index.
  • Modifier : chaque écran et emplacement de code listé mis à jour, et l'index mis à jour.
  • Auditer : un rapport classé remis et aucun fichier modifié.

Erreurs courantes

PenséeRéalité
"Je vais construire tout le guide d'un coup : tokens et dix composants"Dix composants sur des fondations non approuvées signifient dix reprises. Fondations, arrêt, puis composants.
"L'audit a trouvé des problèmes, je vais juste les corriger"La personne peut être en désaccord avec la moitié des corrections. Rapportez, arrêtez, corrigez seulement ce qu'elle choisit.
"J'ai gardé les originaux dans un dossier de sauvegarde, donc corriger est sûr"Une sauvegarde ne rend pas la personne d'accord avec les corrections. Rapportez d'abord.
"Les boutons ont survol et désactivé, c'est assez"Une matrice d'états a chaque état × chaque variante : normal, survol, enfoncé, focus, désactivé, chargement, sélectionné.
"--teal-600 est un token"C'est une valeur. Les composants ont besoin de rôles (--color-primary) pour que la valeur puisse changer en un endroit.
"Cet écran a besoin d'une carte légèrement différente"Faites-en une variante de la carte, ou utilisez la carte. Une pièce unique est le début de la divergence.

Skills associés