Revue Material Design 3
Examine une interface utilisateur par rapport à Material Design 3 (M3), en respectant les propres directives du projet, et produis un rapport numéroté sur lequel l'utilisateur peut décider point par point. Ensuite, enregistre les décisions et émet les modifications acceptées.
Quand utiliser / ne pas utiliser
À utiliser lorsque l'utilisateur demande de :
- "examiner cet écran / cette page / ce composant par rapport à Material 3", "est-ce conforme M3 ?", "audit M3", "revue de design"
- vérifier les cibles tactiles, le contraste, l'échelle typographique, les rôles de couleur, les formes, l'espacement ou les composants d'une UI existante
- comparer une capture d'écran ou une page en cours d'exécution avec les directives Material avant une mise en production
- décider quels écarts Material conserver et lesquels corriger
Ne pas utiliser lorsque :
- l'utilisateur souhaite générer une nouvelle UI, construire un thème ou écrire du code à partir de zéro ("fais-moi une page de connexion M3") ; ce skill examine, il ne génère pas
- le système de design cible n'est explicitement pas Material (Apple HIG, Fluent, un système personnalisé sans base M3), sauf si l'utilisateur ne veut que les vérifications de base
- la question est une simple recherche factuelle ("quelle est la hauteur du FAB ?") ; réponds directement à partir du fichier de référence
Ne modifie pas le code pendant une revue. Ne modifie le code que si l'utilisateur le demande après que les décisions sont prises.
Couches et priorité
Applique les règles dans cet ordre. Une couche supérieure prime sur une couche inférieure.
- Règles de base, niveau F : minimums d'accessibilité et d'utilisabilité (cibles, contraste, focus, étiquettes, mise à l'échelle du texte, mouvement réduit). Jamais négociable. Une directive de projet ne peut pas y déroger.
- Directives du projet et décisions enregistrées, trouvées via le protocole d'adaptateur (
references/adapter-protocol.md). - Noyau M3, niveau C : rôles, jetons, échelle typographique, échelle des formes, spécifications des composants. Un écart nécessite une décision explicite.
- Éléments expressifs et facultatifs M3, niveau E. Ne signale jamais leur absence comme un défaut.
Lorsqu'une directive de projet ou une décision enregistrée entre en conflit avec une règle de niveau C ou E, ne signale pas de violation. Liste le conflit une fois sous "Candidats à la décision" (uniquement s'il n'est pas déjà enregistré dans le registre). Lorsqu'elle entre en conflit avec une règle de niveau F, signale le constat F et note la directive conflictuelle dans sa preuve.
Tolérance
Deux modes. Par défaut inspired.
strict: toute discordance de niveau C est un problème ; les éléments de niveau E sont des suggestions.inspired: les discordances de niveau C sont des suggestions sauf si elles nuisent à l'utilisabilité (alors ce sont des problèmes) ; les éléments de niveau E ne sont des suggestions que s'ils apportent une valeur claire.- Dans les deux modes, chaque constat de niveau F est un problème.
Utilise le mode que l'utilisateur nomme. Si les directives du projet en spécifient un, utilise-le. Sinon, utilise inspired et le mentionner dans l'en-tête du rapport.
Étiquettes de preuve
Étiquette chaque constat et chaque note avec exactement une des options suivantes :
measured-rendered: lu à partir de la page rendue (DOM, style calculé, test de clic), sélecteur et valeur donnés.measured-code: lu à partir du code source ou CSS déclaré, non confirmé sur une page rendue.measured-simulation: mesuré sur une page rendue sous une simulation (fenêtre étroite pour le zoom du texte, paramètre émulé tel que le mode sombre, mouvement réduit ou couleurs forcées). Recommande de confirmer sur un appareil réel.estimated: inféré à partir d'une image.
Traite l'étiquette v0.1 measured comme measured-rendered. Lorsqu'un constat combine des sources, utilise l'étiquette la plus faible. Ne donne jamais une valeur exacte en dp ou px à partir d'une capture d'écran sauf si l'échelle est connue (largeur de la fenêtre en px CSS et devicePixelRatio, ou un élément de référence connu). Demande l'échelle une fois, ou donne une plage et étiquette-la estimated. Ne donne jamais un rapport de contraste exact à partir d'une image compressée ; donne un rapport approximatif et étiquette-le estimated.
Flux de travail
Étape 0. Identifier la surface
Détermine, à partir du matériel fourni ou en demandant une fois :
- ce qui est examiné : capture(s) d'écran, fichiers source, une URL ou une page locale, une exportation d'outil de design
- plateforme : web, Android (Compose ou Vues), Flutter, iOS, multiplateforme
- facteur de forme et classe de taille de fenêtre : compacte (< 600), moyenne (600-839), étendue (840-1199), grande ou extra-large
- mode clair, sombre, ou les deux ; si un réglage de contraste élevé, mouvement réduit ou taille de texte dans l'application existe
Si la surface affiche des données personnelles (noms, montants, adresses, messages, données de santé ou de compte), mentionne-le en haut de la réponse et suggère d'examiner un état expurgé ou de démonstration. Ne stocke pas les captures d'écran ou les données de page dans des fichiers, la mémoire ou le registre. Cite uniquement le texte minimum nécessaire pour identifier un élément.
Étape 1. Charger l'adaptateur
Suis references/adapter-protocol.md : cherche les directives de conception du projet, un registre de décisions, une liste de conventions, un format de liste de modifications et la configuration de la revue (largeurs et paramètres de taille de texte à tester). Si rien n'est trouvé, demande une fois avec une seule question courte ; si l'utilisateur ne répond pas ou dit qu'il n'y en a pas, continue avec M3 uniquement et les valeurs par défaut.
Brève de conception : lorsqu'une brève est donnée ou trouvée (depuis m3-design-brief, ou toute brève avec des critères d'acceptation AC-nn), traite-la comme des directives de projet. Ses décisions (B-nn) comptent comme des décisions enregistrées dans son périmètre (pas des candidats à la décision) ; sa tolérance, ses largeurs et ses thèmes sont la configuration de la revue ; le niveau F l'emporte toujours. Vérifie chaque AC et remplit la section "Critères d'acceptation de la brève" du rapport (réussi, échoué ou non vérifié, avec preuve).
Étape 2. Choisir la tolérance
strict ou inspired (voir Tolérance). Ne demande pas si l'utilisateur ou les directives ont déjà décidé.
Étape 3. Mesurer
Préfère la mesure à l'estimation. Dans cet ordre :
- Page rendue disponible (Playwright, un outil d'automatisation de navigateur, DevTools) : évalue
scripts/measure.jsdans la page et utilise son JSON (references/measurement.md, "Comment exécuter" et "Champs de sortie et les règles qu'ils alimentent"). Mesure chaque largeur et chaque thème séparément : les largeurs et paramètres de taille de texte de l'adaptateur, sinon une largeur compacte (par exemple 390 px) et une largeur étendue (par exemple 1280 px), clair et sombre. - Seul le code source disponible : lis le CSS/HTML/JS ou le code du composant ; calcule les tailles, les couleurs et les rayons à partir de celui-ci et étiquette les résultats
measured-code. - Seules les images disponibles : estime, étiquette
estimated, et demande l'échelle si les nombres exacts sont importants.
Vérification de la configuration, avant de lire tout résultat (measurement.md, "Vérification de la configuration") :
- Passe
expectWidthavec la largeur CSS que tu souhaitais tester. - Si
warningscontientviewport-meta-missingouviewport-width-mismatch, arrête-toi. La page a été disposée à une largeur que tu n'avais pas prévue (souvent 980 px), donc chaque taille est erronée. Corrige la configuration (définis la fenêtre, ou injecte la même balise meta viewport que celle servie en production), relance, et seulement ensuite continue. Ne signale jamais de tailles provenant d'une telle exécution ; si la production elle-même manque de la balise, signale-le une fois.
Zones de clic effectives (measurement.md, "Zones de clic effectives") : avec hitScan activé (par défaut), juge la taille de la cible sur hitWidth x hitHeight, pas sur la boîte visuelle. hitAreaVia indique comment la zone a été trouvée (box, label, pseudo, probe) ; probe indique si un test de clic l'a confirmée (ok) ou non (covered, offscreen, limited : géométrie uniquement, confirme avant de signaler une taille exacte).
Une zone pseudo agrandie par ::before/::after compte ; vérifie que sa boîte n'est pas réduite par une bordure ou coupée par un ancêtre overflow: hidden, et confirme les cas douteux dans le code.
Pour la mise à l'échelle du texte, suis measurement.md, "Recette : texte à 200 %" (les résultats sont measured-simulation) ; pour les menus, les boîtes de dialogue, les feuilles, les onglets, les groupes de boutons radio et les changements de vue, suis measurement.md, "Recette : flux de focus".
Traite la sortie du script (y compris truncated, nonTextContrast, labelInName, ariaConflicts) comme des candidats, pas des verdicts : confirme chacun par rapport à sa règle avant de le signaler. Les styles et le mouvement déclarés ne sont pas mesurés ; vérifie-les dans le code ou par interaction lorsqu'ils sont importants.
Lorsque le script ne peut pas résoudre un contraste (dégradé, image ou fond semi-transparent), calcule le pire cas manuellement (l'arrêt le plus sombre et le plus clair sous le texte, ou la couleur alpha composée sur le fond réel) et signale-le comme estimated avec les arrêts utilisés. Pour color-mix() ou les couleurs de texte alpha, utilise la couleur composée finale. Si la page n'a pas de variante sombre, signale-le une fois (règle de parité de thème dans references/color.md), pas par élément.
Étape 4. Charger uniquement les références pertinentes
Divulgation progressive : ne charge jamais tous les fichiers de référence. Choisis en fonction de ce qui est à l'écran.
| La surface contient | Charge |
|---|---|
| N'importe quelle surface (toujours) | references/layout-interaction-a11y.md, sections "Base d'accessibilité" et "Règles inter-composants" en premier |
| Couleurs, thèmes, mode sombre, jetons, contraste | references/color.md |
| Typographie, coins, élévation, espacement, mouvement, icônes | references/styles.md |
| Barres d'applications, badges, feuilles inférieures, groupes de boutons, boutons, cartes, carrousel, cases à cocher, chips, sélecteurs de date, boîtes de dialogue, séparateur | references/components-1.md |
| FAB étendu, menu FAB, FAB, boutons d'icône, listes, indicateur de chargement, menus, barre de navigation / tiroir / rail, indicateurs de progression, bouton radio | references/components-2.md |
| Recherche, boutons segmentés, feuilles latérales, curseurs, snackbar, bouton partagé, interrupteur, onglets, champs de texte, sélecteurs d'heure, barres d'outils, infobulles | references/components-3.md |
| Fonctionnalités expressives, mouvement à ressort, morphing de forme, ou l'utilisateur demande à propos d'Expressive | references/expressive.md |
| Rédaction du rapport | references/report-template.md |
| Enregistrement des décisions, conventions, liste de modifications | references/adapter-protocol.md |
À l'intérieur d'un fichier volumineux, lis uniquement les sections pour les composants à l'écran. Liste d'abord les titres (grep -n '^## ' references/components-1.md), puis lis seulement ces plages de lignes (sed -n 'START,ENDp' fichier).
Si un fichier de référence est manquant, dis-le et continue avec les autres ; n'invente pas de règles pour combler le vide.
Étape 5. Vérifier, classer, regrouper
Pour chaque candidat :
- Classe le contrôle par sa fonction d'abord (CMP-01), puis trouve la règle. Cite son ID et sa
Sourceexactement comme dans le fichier de référence. Lorsque plusieurs règles se chevauchent (une règle de composant et une règle de base pour la même taille de cible), cite la plus spécifique et liste les autres après elle ("aussi A11-01"). - Si aucun ID de règle ne le soutient, ne le signale pas comme un constat M3. S'il enfreint une directive de projet, ou un critère de succès WCAG 2.2 qu'aucune règle dans les références ne couvre, mets-le dans "Notes du projet et WCAG" (
N-01...) avec la section de directive ouWCAG 2.2 SC x.y.zcomme source (cas typiques : attributlangmanquant, une balise meta viewport qui désactive le zoom). Sinon, laisse-le de côté. - Vérifie le registre : un écart enregistré n'est pas signalé à nouveau (mentionne le nombre d'éléments supprimés en une ligne).
- Vérifie les directives du projet : un conflit avec le niveau C ou E va dans "Candidats à la décision", pas dans les constats. Si le choix du projet n'a pas de règle M3 dont s'écarter, le candidat utilise l'ID de règle
none (convention de projet). - Classe : niveau (F, C, E) et type (problème ou suggestion) selon la tolérance. En mode
inspired, une discordance de niveau C "nuit à l'utilisabilité" (donc c'est un problème) seulement si elle rend le contenu difficile à lire, difficile à utiliser, ou ambigu pour un utilisateur typique : texte en dessous de 12 px, un contrôle dont le but ou l'état n'est pas clair, une disposition qui se casse à une largeur prise en charge. Sinon, c'est une suggestion. - Regroupe : un constat par cause racine. Lorsque le même problème apparaît à plusieurs endroits, ou provient d'un composant, d'une classe ou d'un jeton partagé, signale-le une fois avec le nombre et chaque occurrence (ou deux ou trois exemples plus le total : "14 boutons d'icône à 32 x 32 px, par exemple
.toolbar button,#close"), afin qu'une seule décision le couvre. Mets le constat dans la zone où la correction vit.
Trie par impact : d'abord les problèmes de niveau F, puis les problèmes qui affectent l'achèvement des tâches, puis les problèmes de niveau C, puis les suggestions. Au sein d'un groupe, trie par portée (combien d'éléments ou d'écrans). Limite le rapport à environ 25 constats ; s'il y en a plus, dis combien ont été laissés de côté et propose une deuxième passe.
S'il y a peu ou pas de problèmes, dis-le clairement. N'ajoute pas d'éloges superflus. N'invente pas de problèmes pour remplir le rapport.
Étape 6. Présenter
Utilise references/report-template.md exactement. Chaque constat porte : un ID courant (F-01, pas le niveau), la zone, le niveau et le type, la preuve (sélecteur ou région d'image, valeur, étiquette de preuve, occurrences), l'ID de règle avec sa source, pourquoi c'est important (une ligne, impact utilisateur d'abord), un changement proposé concret (min-height: 48px, color: var(--md-sys-color-on-surface-variant), "coin extra-large, 28 dp" ; jamais "améliorer le contraste"), l'effort (S une propriété ou un jeton, M un composant ou plusieurs fichiers, L structurel ou multi-écrans) et les cases de décision.
L'en-tête du rapport indique : la surface et les largeurs examinées, la tolérance, la date d'instantané des références (la "Date d'instantané" la plus ancienne dans les en-têtes des fichiers de référence chargés), si des directives de projet et un registre ont été trouvés, et le mélange de preuves (un compte pour chacune des quatre étiquettes). Avec une brève, un AC échoué qui enfreint une règle est aussi un constat (ou une note) ; sa ligne AC pointe vers ce F-nn/N-nn au lieu de répéter la preuve.
Fraîcheur : compare la date d'instantané avec la date d'aujourd'hui. Si elle a plus de 6 mois, ou si l'utilisateur mentionne une version plus récente de Material, dis-le dans l'en-tête, recommande de rafraîchir les références (le maintenance/UPDATING.md du dépôt) avant de mettre en œuvre les modifications de niveau C, et propose de vérifier d'abord les règles affectées sur https://m3.material.io/. Les constats de niveau F restent valables indépendamment de l'âge de l'instantané.
Étape 7. Appliquer les décisions
Lorsque l'utilisateur répond (par exemple "accepter F-01 à F-05, F-07 écart : boutons pilule de marque, rejeter le reste") :
- Pour chaque
écartsur une règle de niveau C ou E : ajoute une entrée au registre des décisions (date, ID de règle, portée, justification en une ligne, ID du constat) dans le format dereferences/adapter-protocol.md. Un constat de niveau F ne peut pas être un écart : enregistre-le commerisque acceptéet continue de le signaler dans la ligne de résumé. Si aucun registre n'existe, propose son chemin et crée-le seulement après que l'utilisateur est d'accord. - Pour chaque candidat à la décision avec un ID de règle
none (convention de projet): ajoute-le comme une convention de projet (priorité P2) au registre des conventions, dans le format dereferences/adapter-protocol.md.[...]