Loi Fondamentale
RÉCUPÉREZ LES DIRECTIVES EN DIRECT AVANT D'EXAMINER TOUT FICHIER. N'appliquez jamais de règles mémorisées ou supposées — récupérez toujours les règles fraîches depuis l'URL source. Si WebFetch échoue, signalez l'échec et ne procédez pas avec des règles devinées.
Revue des Directives d'Interface Web
Audite le code UI par rapport aux Directives d'Interface Web de Vercel. Produit des résultats structurés
fichier:ligne.
Quand Utiliser Cette Compétence
Chargez cette compétence lorsque l'utilisateur demande :
- « Examine mon interface »
- « Vérifie l'accessibilité »
- « Audite le design »
- « Revise l'expérience utilisateur »
- « Vérifie mon site/composant par rapport aux directives »
- Lancer une vérification de conformité design avant une PR
Comment Ça Fonctionne
- Récupérer les directives — obtenir les dernières règles depuis l'URL source via WebFetch
- Lire les fichiers — lire les fichiers spécifiés (ou demander à l'utilisateur quels fichiers/motif examiner)
- Appliquer les règles — vérifier tous les fichiers par rapport à chaque règle des directives récupérées
- Produire les résultats — signaler les violations au format
fichier:ligne: [règle violée]
Source des Directives
Récupérez les directives fraîches avant chaque session de revue :
https://raw.githubusercontent.com/vercel-labs/web-interface-guidelines/main/command.md
Utilisez WebFetch pour obtenir les dernières règles. Le contenu récupéré contient toutes les règles et les instructions de format de sortie. Ne mettez pas en cache et ne mémorisez pas les règles entre les sessions — récupérez toujours des règles fraîches.
Utilisation
Lorsque l'utilisateur fournit des fichiers ou un motif de chemin :
- Récupérer les directives depuis l'URL source
- Lire les fichiers spécifiés
- Appliquer toutes les règles des directives récupérées
- Produire les résultats en utilisant le format spécifié dans les directives
Lorsqu'aucun fichier n'est spécifié :
Demandez à l'utilisateur : « Quels fichiers ou répertoires dois-je examiner ? (par ex. src/app/features/dashboard/ ou *.component.html) »
Format de sortie
Suivez exactement le format spécifié dans les directives récupérées. Structure par défaut :
fichier:ligne — [Nom de la règle]: [Description de la violation]
Exemple :
dashboard.component.html:34 — État Vide : Aucun état vide défini pour la condition de données nulles
dashboard.component.html:67 — Gestion du Focus : L'élément interactif manque d'indicateur de focus visible
order-list.component.ts:89 — État de Chargement : L'opération asynchrone n'a pas de retour de chargement
Gestion des Échecs
Si WebFetch échoue à récupérer l'URL des directives :
- Signaler : « Impossible de récupérer les Directives d'Interface Web depuis l'URL source. Échec de récupération : [erreur] »
- Ne PAS procéder avec des règles devinées ou mémorisées
- Suggérer : « Réessayez, ou vérifiez l'accès réseau à raw.githubusercontent.com »
N'inventez jamais de résultats de règle si la récupération échoue.
Comment Cela S'intègre à la Pile de Revue
Cette compétence est le troisième niveau de revue UI — exécutez les trois pour une couverture complète :
| Niveau | Outil | Ce qu'il détecte |
|---|---|---|
| Niveau 1 — Tokens de design | /lint-design-system | Couleurs codées en dur, espacements bruts, typographie inline, violations de taille de zone tactile |
| Niveau 2 — Accessibilité WCAG | accessibility-auditor agent | Rapports de contraste, labels ARIA, navigation clavier, HTML sémantique |
| Niveau 3 — Motifs d'interface web | web-design-guidelines (cette compétence) | États de chargement, états vides, gestion des erreurs, motifs d'interaction, gestion du focus |
Compétences Associées
frontend-design— exécuter AVANT cette compétence pour établir la direction esthétique et le score DFIIdesign-system— application de la conformité des tokens (Angular + Flutter)angular-ui-patterns— doctrine spécifique Angular pour les états de chargement/erreur/videaccessibility-audit— auditeur de conformité WCAG 2.1 AA