Communitygithub.com

extracteur-de-style-frontend

Compétence de conception. Extrayez et documentez un système de design frontend portable à partir d'une application web existante ou d'un site web accessible. Utilisez-la lorsqu'on vous demande d'analyser les styles d'interface utilisateur, les jetons de design, la typographie, les mises en page, les composants, les interactions, la réactivité, ou de générer des règles de style réutilisables pour d'autres projets. Ne reconcevez pas, ne modifiez pas et ne migrez pas l'application source.

Qu'est-ce que extracteur-de-style-frontend ?

Cette compétence permet d'analyser une application frontend existante et d'en extraire un système de design portable, neutre en termes de framework, basé sur des preuves concrètes. Elle est idéale lorsqu'un développeur souhaite comprendre les styles d'une application existante, documenter ses jetons de design, ses composants, ses règles de mise en page et d'interaction, ou créer un point de départ pour un nouveau projet de design system. La compétence fonctionne sur n'importe quel dépôt de code frontend ou site web accessible. Elle inspecte soigneusement le code source, exécute un inventaire heuristique facultatif, échantillonne les interfaces utilisateur représentatives, enregistre la provenance de chaque règle de style (avec preuves et niveau de confiance), et génère un ensemble structuré de fichiers (manifeste, jetons, règles, documentation) prêts à être utilisés par la compétence `frontend-style-adapter`. Elle ne modifie jamais le code source, n'installe pas de paquets et ne transfère pas de données sensibles. La sortie se concentre sur l'intention de conception et les contrats de composants, et non sur une copie exacte du code source ou une reproduction pixel parfaite.

Compatible avec~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/MaduroLabs/styleport/tree/HEAD/skills/frontend-style-extractor

Demander à votre IA préférée

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

Documentation

Extracteur de Style Frontend

Objectif

Produire un Bundle de Système de Design Portable v1.0.0 basé sur des preuves, neutre en termes de framework, à partir d'un frontend source. La sortie est un contrat de transfert pour frontend-style-adapter, PAS du code source copié et PAS un clone pixel-parfait.

Lisez references/CONTRACT.md avant d'écrire le bundle. Lisez references/INSPECTION_CHECKLIST.md lors de l'inspection. N'inventez pas de valeurs de style et ne présentez pas de motifs inférés comme des faits observés.

Entrées

  • Source : racine du dépôt / espace de travail, répertoires sélectionnés, ou site web rendu accessible.
  • Optionnel : pages/composants spécifiques, thèmes, points de rupture, fidélité de conception, chemin de sortie.
  • Valeurs par défaut : source = dépôt courant ; scope = UI partagée représentative + routes/pages trouvables dans le dépôt ; sortie = design-system/portable/ dans le dépôt source (sauf si l'utilisateur demande un autre emplacement).
  • Une URL publique sans CSS source accessible ni styles calculés est une source visuelle uniquement. Marquez les mesures exactes de pixels/couleurs/espacements comme inférées sauf si elles sont mesurables via des outils. Si l'environnement ne peut pas ouvrir le site web, expliquez la limitation au lieu d'inventer une analyse.

Flux de travail

  1. Orientez-vous sans modifier la source. Vérifiez l'état git, la structure du projet, le manifeste du paquet, le framework et la pile de style, la structure des routes/pages, les styles globaux, les fournisseurs de thèmes, les bibliothèques de composants et les jetons de design. Respectez AGENTS.md et les instructions du dépôt. Ne lisez jamais .env, les secrets ou les données non pertinentes.
  2. Exécutez l'inventaire heuristique optionnel (stdlib uniquement ; pas un analyseur CSS faisant autorité) : python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.json Utilisez un chemin temporaire en dehors du dépôt si possible. Lisez le résumé ; vérifiez les affirmations importantes directement dans le code/l'interface rendue.
  3. Échantillonnez l'interface utilisateur représentative : coque globale, navigation, titres/texte, boutons, champs/formulaires, cartes, tableaux, modales, alertes, états de chargement/vide/erreur ; inspectez en mode bureau et mobile, survol/focus/désactivé, clair/sombre s'il est pris en charge. Échantillonnez à la fois les routes courantes et inhabituelles. Enregistrez les surfaces inspectées et ignorées.
  4. Résolvez la hiérarchie des règles : jetons/configuration explicites → composants partagés → motifs de page répétés → exceptions uniques. Ne confondez pas la mise en page d'une seule page avec une règle globale. Préservez les jetons sémantiques et les alias (par exemple var(--brand-primary)) lorsqu'ils sont significatifs ; indiquez les valeurs résolues réelles uniquement si elles sont vérifiées.
  5. Enregistrez la provenance : chaque jeton et chaque règle structurée nécessite origin, confidence, et evidence concret. Préférez le chemin d'accès au fichier + ligne/symbole, l'observation de style calculé, ou la référence de capture d'écran/viewport. Toute inférence non prise en charge doit être étiquetée comme telle. Indiquez les limitations, les pages non inspectées, les incertitudes de licence des dépendances/actifs.
  6. Rédigez le bundle au chemin de sortie choisi. Fichiers requis : manifest.json, tokens.json, rules.json, README.md, typography.md, layout-rules.md, component-rules.md, interaction-rules.md, responsive-rules.md. assets.md optionnel pour les considérations d'icônes/images/polices. Voir references/CONTRACT.md et assets/example-bundle/ pour la forme ; remplacez TOUT le contenu d'exemple par des observations spécifiques à la source. Utilisez un langage portable (contrats de composants et intention de conception) plutôt qu'une implémentation spécifique au framework comme seule description.
  7. Validez : python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Corrigez toutes les erreurs. Inspectez manuellement les éléments inconnus/à faible confiance. Ne prétendez pas que la fidélité visuelle a été testée si aucune comparaison de navigateur/capture d'écran n'a été effectuée.
  8. Rapportez : source et surfaces inspectées, méthode de framework/style, chemin de sortie, nombre de jetons/règles, couverture/incertitudes, résultat du validateur, et utilisation de transfert : invoquez frontend-style-adapter avec le chemin du système de design.

Contraintes strictes

  • Extrayez le langage de conception, pas la logique métier, la copie, les actifs propriétaires ou les internes d'implémentation.
  • Ne modifiez pas le code source de l'application, n'installez pas de paquets, ne réécrivez pas la configuration et ne validez pas automatiquement. La création du bundle demandé est autorisée.
  • Ne copiez pas les logos, fichiers binaires de polices, images/icônes sous licence dans le bundle, sauf si l'utilisateur autorise explicitement et que les droits sont clairs ; décrivez plutôt leur apparence, les références originales et les réserves de licence.
  • Ne transférez pas .env, identifiants, données utilisateur, réponses API en direct ou secrets.
  • Préservez les thèmes séparés clair/sombre et les règles réactives s'ils existent ; ne les aplatissez pas en un seul style.
  • Les détails d'implémentation exacts appartiennent aux notes evidence ; les exigences doivent rester portables entre frameworks.
  • Préférez la clarté au volume : des motifs documentés de grande valeur valent mieux que des centaines de jetons non pris en charge.
  • Si aucune interface utilisateur exécutable/navigateur n'est disponible, signalez visualVerification: "not_performed" dans le manifeste.

Terminé lorsque

Le bundle est validé ; chaque fait exporté est traçable ; les règles globales sont séparées des exceptions ; les états d'accessibilité/réactivité sont traités ; et le rapport indique les lacunes connues.

Skills associés