Was macht Frontend-Style-Extraktor?
Ziel
Erstellen eines evidenzbasierten, framework-neutralen Portable Design System Bundle v1.0.0 aus einem Quell-Frontend. Das Ergebnis ist ein Übergabevertrag für den frontend-style-adapter, KEIN kopierter Quellcode und KEIN pixelgenauer Klon.
Lies references/CONTRACT.md vor dem Erstellen des Bundles. Lies references/INSPECTION_CHECKLIST.md während der Inspektion. Erfinde keine Stilwerte oder stelle abgeleitete Muster als beobachtete Fakten dar.
Eingaben
- Quelle: Repository-Root / Arbeitsbereich, ausgewählte Verzeichnisse oder eine zugängliche gerenderte Website.
- Optional: bestimmte Seiten/Komponenten, Themes, Breakpoints, Designgenauigkeit, Ausgabepfad.
- Standardwerte: Quelle = aktuelles Repository; Umfang = repräsentatives gemeinsames UI + im Repository auffindbare Routen/Seiten; Ausgabe =
design-system/portable/im Quell-Repository (sofern vom Benutzer kein anderer Ort gewünscht). - Eine öffentliche URL ohne zugängliches Quell-CSS oder berechnete Stile ist eine reine visuelle Quelle. Markiere exakte Pixel/Farb-/Abstandsmessungen als abgeleitet, sofern nicht über Tools messbar. Falls die Umgebung die Website nicht öffnen kann, erkläre die Einschränkung, anstatt eine Analyse zu erfinden.
Arbeitsablauf
- Orientieren ohne die Quelle zu verändern. Überprüfe Git-Status, Projektstruktur, Paketmanifest, Framework und Styling-Stack, Routen-/Seitenstruktur, globale Stile, Theme-Provider, Komponentenbibliotheken und Design-Tokens. Respektiere
AGENTS.mdund Repository-Anweisungen. Lese niemals.env, Geheimnisse oder irrelevante Daten. - Führe optionale heuristische Inventarisierung durch (nur Stdlib; kein autoritärer CSS-Parser):
python3 <skill-root>/scripts/style_inventory.py <source-root> --out <temporary-path>/style-inventory.jsonVerwende wenn möglich einen temporären Pfad außerhalb des Repositorys. Lies die Zusammenfassung; überprüfe wichtige Behauptungen direkt im Code/gerenderten UI. - Untersuche repräsentatives UI: globales Shell, Navigation, Überschriften/Text, Buttons, Felder/Formulare, Karten, Tabellen, Modals, Alarme, Lade-/Leer-/Fehlerzustände; inspiziere Desktop und Mobil, Hover/Fokus/Deaktiviert, Hell/Dunkel falls unterstützt. Untersuche sowohl übliche als auch ungewöhnliche Routen. Dokumentiere untersuchte vs. übersprungene Oberflächen.
- Löse die Regelhierarchie auf: explizite Tokens/Konfiguration → gemeinsame Komponenten → wiederholte Seitenmuster → einmalige Ausnahmen. Verwechsele nicht das Layout einer einzelnen Seite mit einer globalen Regel. Behalte semantische Tokens und Aliase (z. B.
var(--brand-primary)) bei, wenn sie sinnvoll sind; gebe tatsächliche aufgelöste Werte nur an, wenn sie verifiziert wurden. - Dokumentiere die Herkunft: jeder Token und jede strukturierte Regel benötigt
origin,confidenceund konkreteevidence. Bevorzuge Dateipfad + Zeile/Symbol, computed-style-Beobachtung oder Screenshot-/Viewport-Referenz. Jede nicht unterstützte Inferenz muss als solche gekennzeichnet sein. Gib alle Einschränkungen, nicht untersuchten Seiten, Abhängigkeits-/Asset-Lizenzunsicherheiten an. - Erstelle das Bundle am gewählten Ausgabepfad. Erforderliche Dateien:
manifest.json,tokens.json,rules.json,README.md,typography.md,layout-rules.md,component-rules.md,interaction-rules.md,responsive-rules.md. Optionalassets.mdfür Symbol-/Bild-/Schriftart-Hinweise. Siehereferences/CONTRACT.mdundassets/example-bundle/für die Form; ersetze ALLE Beispielinhalte durch quellspezifische Beobachtungen. Verwende portable Sprache (Komponentenverträge und Designabsicht) anstelle von frameworkspezifischer Implementierung als einziger Beschreibung. - Validieren:
python3 <skill-root>/scripts/validate_bundle.py <bundle-path>. Behebe alle Fehler. Überprüfe unbekannte/niedrige Vertrauenspunkte manuell. Behaupte nicht, dass die visuelle Wiedergabetreue getestet wurde, wenn kein Browser-/Screenshot-Vergleich durchgeführt wurde. - Bericht: Quelle und untersuchte Oberflächen, Framework/Styling-Methode, Ausgabepfad, Token-/Regelanzahl, Abdeckung/Unsicherheiten, Validierergebnis und Übergabeverwendung: Rufe
frontend-style-adaptermit dem Designsystem-Pfad auf.
Harte Einschränkungen
- Extrahiere Designsprache, nicht Geschäftslogik, Kopien, proprietäre Assets oder Implementierungsinterna.
- Verändere nicht die App-Quelle, installiere keine Pakete, schreibe keine Konfiguration um oder committe automatisch. Das Erstellen des angeforderten Bundles ist erlaubt.
- Kopiere keine Logos, Schriftart-Binärdateien, lizenzierte Bilder/Symbole in das Bundle, es sei denn, der Benutzer autorisiert dies ausdrücklich und die Rechte sind klar; beschreibe stattdessen ihr Erscheinungsbild, ursprüngliche Referenzen und Lizenzhinweise.
- Übertrage keine
.env, Anmeldeinformationen, Benutzerdaten, Live-API-Antworten oder Geheimnisse. - Behalte separate Dunkel-/Hell-Themes und responsive Regeln bei, falls vorhanden; glätte sie nicht zu einem einzigen Stil.
- Exakte Implementierungsdetails gehören in
evidence/Anmerkungen; Anforderungen sollten framework-übergreifend portabel bleiben. - Bevorzuge Klarheit gegenüber Umfang: hochwertige dokumentierte Muster sind besser als hunderte nicht unterstützter Tokens.
- Wenn kein ausführbares UI/Browser verfügbar ist, melde
visualVerification: "not_performed"im Manifest.
Erledigt, wenn
Bundle validiert; jeder exportierte Fakt nachvollziehbar; globale Regeln von Ausnahmen getrennt; Barrierefreiheits-/Responsive-Zustände adressiert; und der Bericht bekannte Lücken angibt.