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
- 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.mdet les instructions du dépôt. Ne lisez jamais.env, les secrets ou les données non pertinentes. - 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.jsonUtilisez 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. - É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.
- 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. - Enregistrez la provenance : chaque jeton et chaque règle structurée nécessite
origin,confidence, etevidenceconcret. 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. - 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.mdoptionnel pour les considérations d'icônes/images/polices. Voirreferences/CONTRACT.mdetassets/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. - 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. - 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-adapteravec 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.