UI-Klon: Referenz vermessen, neu aufbauen, Übereinstimmung nachweisen
Jeder Auftrag folgt einem Kreislauf: Referenz erfassen → vermessen (wo möglich exakte Werte auslesen, wo nicht in Pixeln messen) → Spezifikation schreiben → im Stack des Benutzers bauen → unsere Aufnahme auf die gleiche Weise erstellen → vergleichen → korrigieren, bis die Spezifikation bestanden ist. Das Ergebnis ist Code im Projekt des Benutzers plus Belege (Zahlen, Diff-Bilder, Side-by-Side-Blätter), niemals „sieht ungefähr richtig aus". Methoden angepasst von NiazMorshed2007/reanimate und rossark0/rossark-motion-skill (beide MIT); jedes Skript hier ist unser Eigenes.
<skill> = der Ordner dieses Skills. Die Arbeit erfolgt in ./ui-clone/<name>/ im Projekt: ref/, ours/, figma/, compare-N/, diff-N/, spec.md. Fügen Sie ui-clone/ zur .gitignore hinzu, es sei denn, der Benutzer möchte die Belege festhalten.
Einrichtung (einmal pro Maschine)
- Python (numpy + Pillow):
~/.ui-clone/venv/bin/python(erstellen mitpython3 -m venv ~/.ui-clone/venv && ~/.ui-clone/venv/bin/pip install numpy pillow, falls nicht vorhanden). Skripte mit-Iausführen. - Browser-Erfassung (Playwright + Chromium, ~250 MB, nur für URL-/Dev-Server-Eingaben): Runner in
~/.ui-clone/runner(npm i [email protected] && npx [email protected] install chromiumdort). Führen Sie die.mjs-Skripte aus mitnode <skill>/scripts/<script>.mjs(sie laden Playwright aus~/.ui-clone/runneroderUICLONE_RUNNER; falls Playwrights eigenes Chromium nicht installiert ist, verwenden sie jedes Chromium im Playwright-Cache oderUICLONE_CHROMIUM). - ffmpeg/ffprobe im PATH. Nur Figma:
FIGMA_TOKEN=...in der Umgebung, inkeys.envdes Projekts oder in~/.ui-clone/keys.env(nur-Lese Personal Access Token). Tokens niemals ausgeben oder committen. Fragen Sie, bevor Sie etwas installieren, das nicht vorhanden ist.
0. Umfang (oben in der spec.md, vor jeder Erfassung)
- Ziel: genau das, was geklont werden soll (URL + Selektor, Datei + Zeitbereich + Zuschnitt, Figma-Knoten) und nichts weiter.
- Treue (in der ersten Antwort angeben; sie bestimmt, was überprüft wird):
Stufe wann muss übereinstimmen darf abweichen bewegungstreu (Standard für fremde Arbeiten) „lass unsere sich anfühlen/bewegen wie ihre" Struktur und Proportionen, Reihenfolge, Timing ±0,08 s, Easing-Familie, Überschwingen, relative Bewegung zur Größe, Staffelung Kopie, Farben, Schriften, Bilder, Marke pixeltreu eigenes Design des Benutzers (Figma → Code), eigene Website, Kundenarbeit mit Rechten oder private Übung alles oben + Schriften, Größen, Abstände, Farben, Radien, Schatten, Assets; Screenshot-Abweichung ≤ 2% (≤ 0,5% im Ruhezustand), keine gemessenen Verschiebungen nichts, was sie nicht zu ändern baten gemischt „Klon X und füge Y hinzu" der geklonte Teil mit einer der obigen Stufen die Ergänzungen (getrennt gehalten, gezeigt, geprüft, dass sie den Klon nicht beeinträchtigen) - Rechte: Pixeltreue Kopien von UIs, Logos, Illustrationen, Schriften und Texten anderer Unternehmen gehören diesen; verwenden Sie sie nur zum Lernen oder mit Genehmigung und veröffentlichen Sie sie niemals als eigene Arbeit des Benutzers. Wenn die Referenz ein Produkt eines Dritten ist und der Benutzer es ausliefern möchte, standardmäßig auf bewegungstreu mit eigenem Design umschalten und begründen.
- Ziel: wohin der Code geht und in welchem Stack. Lesen Sie
package.json, vorhandene Komponenten, das Styling-System (Tailwind-Konfiguration, CSS-Variablen, Design-Tokens) und die bereits verwendete Animationsbibliothek; passen Sie sich an, anstatt eine neue Bibliothek hinzuzufügen.
1. Eingabemethode wählen (die präziseste verfügbare; angeben, welche verwendet wird)
| Eingabe | Erfassung | Ergebnis |
|---|---|---|
| Live-URL | inspect_web.mjs + capture_web.mjs | exakte CSS-Werte, Schriften, deklarierte Dauern/Verzögerungen/Easings, Keyframes; bildgenaue Aufnahme mit virtueller Uhr |
| Lokaler Dev-Server (unsere) | gleiche Skripte auf http://localhost:… | die „unsere"-Seite jedes Vergleichs, genau wie die Referenz erfasst |
| Video / GIF / Bildschirmaufnahme (Web oder App) | ref_frames.py | jedes Bild mit Quell-FPS + Timing/Pose-Blätter; aus Pixeln gemessene Werte |
| Figma | figma_fetch.py (Token) oder exportierte PNG-Bilder | exakte Größen, Abstände, Auto-Layout, Typografie, Farben, Effekte, Prototyp-Übergänge + ein Referenz-PNG |
| Mobile App | Bildschirmaufnahme (Referenz); für unsere: xcrun simctl io booted recordVideo ours.mp4 (iOS Simulator) oder adb shell screenrecord (Android) | als Video; unsere auf die gleiche Weise erfasst |
| Kombinieren Sie sie: URL-Werte + eine Aufnahme für schwer auslösbare Interaktionen (eingeloggte Abläufe, Drags); Figma-Werte + der Dev-Server zum Prüfen „stimmt mein Build mit dem Design überein"; Video-Referenz + Dev-Server-Erfassung für unsere. Seiten mit Login-Wall: nach einer Bildschirmaufnahme fragen oder dass der Benutzer sich einloggt; niemals deren Passwörter verarbeiten. |
2. Referenz erfassen und vermessen
URL:
inspect_web.mjs --url URL --selector "<section>" --out ui-clone/<name>/ref [--state hover --target "<btn>"]→inspect.md: pro Element Box + berechnete Stile, deklarierte Übergänge, laufende Animationen mit Keyframes, @keyframes, Schriften, erkannte Bibliotheken (GSAP, Framer Motion, Lottie, three.js, Lenis...), Canvases (2d/WebGL), Hover/Fokus-Diff. Deklarierte Werte schlagen gemessene: diese kopieren.capture_web.mjs --url URL --selector "<section>" --trigger load|hover|click|scroll|none --duration 2 --fps 30 --out ui-clone/<name>/ref→ frames/, video.mp4, frames.json, animations.json. Standard--mode seek(virtuelle Uhr: JS-Timer und requestAnimationFrame auf Playwrights Uhr, CSS/Web-Animationen pausiert und bildweise weitergeschaltet: identische Erfassungen).--mode realtimefür Seiten, die die virtuelle Uhr zerstört (Videoelemente, manche WebGL/Canvas-Bibliotheken), und dies angeben.--stillgibt einen einzelnen Endzustands-Screenshot für Pixelarbeit;--dpr 2für retina-scharfe Vergleiche (--dpr 3für kleine Elemente: ein 12 px Hover-Wachstum hat zu wenige Pixel, um ein Easing bei 1x zu fitten);--pad 12fügt einen Rand um--selectorhinzu, damit Hover/Skaliereffekte, die über die Ruhebox hinauswachsen, im Bild bleiben;--viewport 390x844für Handys. Der Seek-Modus ist über mehrere Läufe hinweg bildidentisch verifiziert.--mode realtimemacht echte Screenshots so schnell wie die Maschine erlaubt (~19/s auf einem typischen Laptop) und resampelt; es gibt die erreichte Rate aus: das Timing ist nur so genau wie diese. Video / GIF / Aufnahme:ref_frames.py REF.mp4 --out ui-clone/<name>/ref [--start --end --crop x:y:w:h]. Figma:figma_fetch.py --url "<figma link with node-id>" --out ui-clone/<name>/figma --scale 2→ design.md/json + frame.png. Dann Bewegung vermessen (jede Eingabe mit Bildern):- Schnitte und Abschnitte:
motion_compare.py <ref> <ref> --out <ref>/self --no-align. - Farben:
track_motion.py <ref>/frames --sample X,Y --at T. - Jedes bewegte Element:
track_motion.py <ref>/frames --name el --colors HEX,HEX --tol 35 --region x,y,w,h(bei belebten Referenzen immer eine Region). - Jede Bewegung:
fit_easing.py <ref>/track_el.json --prop cx|cy|w|h|aspect|presence --from A --to B→ Timing, Easing, Überschwingen und einfügebereite CSS-/WAAPI-/Framer-Motion-/GSAP-/Remotion-Zeilen. Fehler ≤ 0,03 = gute Übereinstimmung; „kein einzelnes Easing passt" = das Fenster aufteilen oder es ist eine Keyframe-Kette. Wenn der Fehler des Zweitplatzierten innerhalb von ~0,003 des Besten liegt, als Gleichstand behandeln (z.B. easeOutQuad 0,58 s vs easeOutCubic 0,80 s passen zu denselben Bildern): dies angeben und deklarierte Werte ausinspect.md, dem Quellcode oder den Blättern bevorzugen, um die Entscheidung zu treffen. Das Tracking sieht ein Element nur durch seine Farbe, daher erscheint ein Element, das während der Bewegung einblendet, als würde es spät starten: bei Web-Eingaben stattdessen die deklarierten Werte verwenden. Jedes Blatt (sheets/poses.png,sheets/timing_NN.png) selbst lesen: Zahlen sagen das, Blätter sagen was.
3. Spezifikation schreiben (ui-clone/<name>/spec.md; jede Zeile wird zu einer Prüfung)
- Struktur & statischer Stil (pixeltreu): Element → Box, Schrift (Familie/Größe/Gewicht/Zeilenabstand/Buchstabenabstand),
Farben, Radius, Schatten, Abstände; Quelle (
inspect.json/design.json/ gemessen). - Zeitachse (Bewegung):
| # | Element | Eigenschaft | von → nach | Start ms | Dauer ms | Easing | Staffelung / Wiederholung | Auslöser | Quelle |. - Notieren, was sich nicht bewegt. Ein „?" bedeutet, dass die Referenz noch nicht gelesen wurde. Die Spezifikation vor einem großen Build zeigen.
4. Bauen
Im Stack des Benutzers und im Designsystem. Deklarierte Werte exakt kopieren (pixeltreu) oder relative Proportionen
(bewegungstreu). Easings aus inspect.json oder aus der Zeile von fit_easing.py für deren Bibliothek; Federn, wenn die
Referenz überschwingt und zur Ruhe kommt; Staffelungen als Basis + Index × Schritt. prefers-reduced-motion respektieren (Endzustand
anzeigen). Ergänzungen in separaten Komponenten halten. Unserer Komponente eine Route/Seite geben, die sie im Referenz-Viewport
mit demselben Auslöser rendert, damit sie identisch erfasst werden kann. WebGL-Effekte: den Shader aus dem nachbauen, was die
Referenz zeigt (oder aus deren lesbarem Quellcode, wenn der Benutzer ihn verwenden darf); feste Zeitschritte aus der Zeit, gesäter Zufall.
5. Überprüfen, korrigieren, wiederholen (2-5 Runden; jeden Rundenordner behalten)
- Unsere mit dem gleichen Befehl wie die Referenz erfassen (nur
--url/Eingabe und--outändern), oderref_frames.py OURS.mp4 --out ui-clone/<name>/ours --like <ref>/frames.jsonfür Video-Eingaben. - Pixel:
screenshot_diff.py <ref>/still.png <ours>/still.png --out ui-clone/<name>/diff-N [--strict] [--max 0.02] [--mask x,y,w,h](pixeltreu: immer--strict: Pixel-Schwellwert 0,03, Maximum 0,5 %, und jede Region, deren Farbe um mehr als 3 RGB-Stufen abweicht, gilt als Fehler; der Standard ist nachsichtig und lässt kleine Padding- und Farbänderungen durch) → Abweichung %, schlechteste Regionen, ganze-Bild- oder elementweise Verschiebungen („etwas in Region … verschoben um +0 px x, +6 px y"), Farbdrift,side_by_side.png. Zuerst Verschiebungen korrigieren (sie lassen alles falsch aussehen), dann Größen, dann Farben. Pixeltreu FAIL bei jeder gemessenen Verschiebung; bewegungstreu verwendet--allow-shiftund ein lockereres--max. - Bewegung:
motion_compare.py <ref> <ours> --out ui-clone/<name>/compare-N(Schnitte, Bewegungen, Offset; BESTANDEN ±0,08 s;activity.png,sheets/compare_NN.png) und, pro Spezifikationszeile,fit_easing.py REF_TRACK --prop P --from A --to B --vs OUR_TRACK. - Die Blätter jede Runde lesen. Die kleinste Sache ändern, auf die die Belege hinweisen; neu erfassen; neu vergleichen.
- Nach 5 Runden jede noch nicht bestandene Zeile mit ihrer Zahl und dem Grund melden (Schriftlizenz, ein approximierter WebGL-Effekt, eine nach Gefühl eingestellte Feder). Niemals einen Schwellwert stillschweigend lockern.
| Symptom | Übliche Ursache | Lösung |
|---|---|---|
| ganzes Bild um N Pixel verschoben | anderer Scroll/Offset/Zuschnitt oder fehlender Wrapper-Rand | Viewport, dpr, Zuschnitt angleichen; den äußeren Abstand korrigieren |
| ein Element verschoben | unterschiedlicher Rand/Padding/Zeilenabstand/Lücke | dessen Box mit inspect.json / design.json vergleichen |
| Text überall leicht falsch | Fallback-Schrift, andere Stärke oder Buchstabenabstand | dieselbe Schrift laden (oder die lizenzierte Entsprechung des Benutzers), Größe/Stärke/Laufweite anpassen |
| Farben überall leicht falsch | Farbraum, Opazitäts-Stapelung, Verlaufsstopps | berechnete Farben/Verläufe kopieren; Opazität der Eltern prüfen |
| Bewegung um einen Offset verschoben | Auslöser-Latenz oder fehlende Verzögerung | die erste Verzögerung korrigieren |
| unsere zu schnell / zu schwungvoll | stärkeres Easing (Expo vs Cubic) | den gefitteten Bezier oder das deklarierte Easing verwenden |
| Referenz überschwingt, unsere nicht | Feder/Back vs Bezier | Feder/Back auf das gemessene Überschwingen und Einpendeln abgestimmt |
| Scroll-Animation startet zu früh/spät | Auslöser-Schwellwert/-Offset | die Scroll-Position anpassen, bei der die Bewegung beginnt |
| eine zusätzliche Bewegung bei uns | ein versehentlicher Übergang (z.B. transition: all) | Übergänge auf die Eigenschaften beschränken, die animieren sollen |
6. Bericht (muss für sich allein stehen)
Treuestufe und was geklont / hinzugefügt wurde; geänderte Dateien und wie die Bewegung ausgelöst wird; die Tabellen der letzten Runde
(Pixel-Abweichung und -Verschiebungen; Schnitte/Bewegungs-Timing; elementweises Easing), Pfade zu side_by_side.png, activity.png und
Vergleichsblättern; jede verbleibende Abweichung mit Zahl und Grund; welche Prüfungen gemessen (von einem Skript erstellt) vs. überflogen wurden (ein Blatt angesehen).
Grenzen
- Die virtuelle Uhr-Erfassung kann
<video>-Wiedergabe oder manche GPU/Physik-Bibliotheken nicht steuern:--mode realtimeverwenden und mit ±1-2 Bildern Rauschen rechnen; dies angeben. - CORS-Stylesheets und -Schriften können @keyframes/@font-face-Regeln vor der Inspektion verbergen; berechnete Stile und laufende Animationen werden dennoch gelesen.
- Bei Videos wird 3D als Kamera-/Objektbewegung abgeglichen, nicht als Modelle oder Materialien; belebte Realfilm-Aufnahmen liefern Rhythmus, nicht exakte Elementwerte.
- Mobil: Werte stammen aus Aufnahmen (keine Quelle); Simulator-Erfassungen unserer Seite werden auf die gleiche Weise verglichen.