Was macht reanimate?
Baue das, worauf der Benutzer zeigt, so nach, dass es sich so bewegt wie die Referenz, beweise es mit einem Frame-für-Frame-Vergleich und wiederhole dies, bis der Vergleich bestanden ist. Das Ergebnis ist Code im Projekt des Benutzers plus Nachweise (Zahlen und Side-by-Side-Vergleiche), niemals „es sieht ungefähr richtig aus".
Was „fertig“ bedeutet
Wähle den Genauigkeitsgrad aus den Worten des Benutzers und gib ihn in der ersten Nachricht an; er bestimmt, was du überprüfst.
| Level | Wann | Muss übereinstimmen | Darf abweichen |
|---|---|---|---|
| bewegungstreu (Standard) | „Diese Animation klonen", „Unsere soll sich wie ihre anfühlen", „Gleicher Held wie bei X, aber unsere Kopie" | Auslöser, Sequenz und Reihenfolge, Staffelung, Timing jedes Schritts (±80 ms), Easing-Familie, Richtung und Distanz der Bewegung relativ zur Elementgröße, Layout-Proportionen | Kopie, Farben, Schriftarten, Bilder, Markendetails |
| pixeltreu | „Genau übereinstimmen", „Pixelgenau", „Details sollen übereinstimmen", „1:1" | Alles oben plus Schriftarten, Größen, Farben, Abstände, Radien, Schatten, Assets; mittlere Frame-Abweichung ≤ 2 % | Nichts, was der Benutzer nicht geändert haben wollte |
| gemischt | „X klonen und Y hinzufügen", „Wie ihre, aber mit unseren Preistabellen" | Die geklonten Teile auf einem der obigen Level | Die Ergänzungen, die du beschreibst und zeigst, aber nur darauf überprüfst, dass sie die geklonte Bewegung nicht beeinträchtigen |
Der Benutzer kann das Ziel auf einen Abschnitt, ein Widget, eine Seite oder einen Zeitbereich eines Videos eingrenzen („die ersten 3 Sekunden", „0:12 bis 0:15"). Klone genau das; beziehe den Rest der Seite nicht mit ein.
Workflow
Alles unten lebt in .reanimate/<name>/ innerhalb des Benutzerprojekts (füge es zu .gitignore hinzu, es sei denn, der Benutzer möchte die Nachweise committed haben). Behalte die Artefakte jeder Runde; sie sind der Beweis.
0. Umfang
Schreibe drei Zeilen an den Anfang von .reanimate/<name>/spec.md vor jeder Aufnahme:
- Ziel: Was zu klonen ist, so genau, wie der Benutzer es gesagt hat (URL + Selektor / Zeitbereich / „der Schalter im GIF").
- Zielort: Wohin der Code geht und in welchem Stack (lies
package.json, vorhandene Komponenten und die bereits verwendete Animationsbibliothek; passe dich an, anstatt eine neue einzuführen). - Genauigkeit: bewegungstreu, pixeltreu oder gemischt, plus die Liste der Ergänzungen für gemischt.
Leite ab, was du aus der Anfrage und dem Repository ableiten kannst. Frage nur nach, wenn zwei Lesarten zu unterschiedlicher Arbeit führen (z. B. „der Held" auf einer Seite mit zwei Kandidatenabschnitten). Wenn eine Referenz eine Seite mit Login-Wall oder ein YouTube-/Loom-Link ist, den du hier nicht herunterladen kannst, bitte den Benutzer um eine Bildschirmaufnahme und fahre in der Zwischenzeit mit allem anderen fort.
1. Einrichtung
<skill> unten ist das Verzeichnis, in dem diese SKILL.md lebt. Skripte benötigen Bun; der erste Lauf lädt Playwrights Chromium und ein statisches ffmpeg herunter (ca. 250 MB).
bash <skill>/scripts/setup.sh # installiert playwright, ffmpeg, pixelmatch einmal; gibt "bereit" aus
Alle Skripte werden mit bun <skill>/scripts/<name>.ts --help ausgeführt. Sie sind deterministisch und teilen eine Regel: Nimm die Referenz und den Klon mit dem gleichen Viewport, Selektorzuschnitt, Auslöser, Dauer und fps auf, sonst misst der Vergleich deine Einrichtung statt deiner Arbeit.
2. Referenz aufnehmen
Lies references/capture.md für das Rezept für deinen Quelltyp. Kurzgefasst:
- Website:
capture.ts --url … --out ref --selector <section> --trigger load|scroll|hover|click|none --duration … --track "<bewegte Elemente>". Du erhältstvideo.webm,frames/,inspect.json(deklarierte Animationen, Keyframes, berechnete Stile, Schriftarten, erkannte Bibliotheken) undtrack.json(pro Animationsframe Position, Größe, Opazität, Transform jedes verfolgten Elements). Bei CSS/WAAPI-Bewegung enthältinspect.jsonoft die genauen Dauern, Verzögerungen und Easings: verwende sie, das ist besser als Schätzen. - Video oder GIF:
frames.ts --in file --out ref/frames --fps 10..30 --start … --end … --crop …. Untersuche zuerst mit--probe, dann betrachte ein paar Frames, um den Zuschnitt des Widgets zu finden, das du klonst. - Canvas, WebGL, WebGPU, 3D (
inspect.json › canvaseszeigt eines, oder die Seite verwendet three.js, Pixi, Babylon, Spline…): füge--clock virtual --gl --assetszur Aufnahme hinzu und liesgl/summary.md(gl.ts summary <out>). Du erhältst die Shaderquellen, jede konstante Uniform, den Szenengraphen, die Renderdurchgänge, die Texturen und Modelle und jede animierte Uniform oder Objekteigenschaft als Kanal ingl-track.json. Die virtuelle Uhr macht jeden Frame exakt und jede Aufnahme identisch, einschließlich zufälliger Partikel. Liesreferences/webgl.md. - Lottie / Rive / Prototyp-Export: die Datei ist die Spezifikation; lies sie, leite sie nicht von Pixeln ab.
Erstelle dann beschriftete Blätter und sieh sie dir an: sheet.ts filmstrip --frames ref/frames --out ref/sheets. Lies jedes Blatt mit dem Bildbetrachter. Das ist die Frame-für-Frame-Inspektion, die der Benutzer verlangt hat; überspringe sie nicht oder mustere nur das erste Blatt.
3. Die Bewegungsspezifikation schreiben
Fülle spec.md mit der Vorlage in references/analysis.md. Eine Zeile pro Element pro Eigenschaft: Auslöser, Startzeit, Dauer, Verzögerung oder Staffelung, von → nach, Easing, Notizen. Hole die Zahlen in dieser Reihenfolge: Animationen und Keyframes aus inspect.json → easing.ts auf track.json oder auf gl-track.json --channel für Canvas → Frames lesen (erster Frame, an dem es sich ändert, letzter Frame, an dem es sich ändert, Überschwingen oder nicht). Notiere auch die statischen Fakten, von denen die Bewegung abhängt: Elementgrößen und -positionen, Z-Reihenfolge, Überlaufbeschneidung, Transform-Ursprünge und für pixeltreue Arbeit Schriftarten, Farben, Abstände und Assets.
Die Spezifikation ist der Vertrag zwischen Referenz und Klon. Jede Zeile wird zu einer Prüfung in Schritt 5. Wenn eine Zeile ein „?" enthält, hast du das Lesen der Frames noch nicht abgeschlossen.
4. Bauen
Implementiere im Stack des Benutzers gemäß references/implementation.md (Easing-Tabellen, Staffelungsmathematik, Scroll- und Hover-Auslöser, reduzierte Bewegung). Halte die DOM-Struktur nah an der Rollenstruktur der Referenz, sodass die verfolgten Selektoren Äquivalente haben. Füge bei gemischter Arbeit Ergänzungen in klar getrennte Komponenten oder Blöcke ein und erwähne sie in spec.md unter „Ergänzungen".
Gib dem Klon eine Möglichkeit, auf die gleiche Weise wie die Referenz aufgenommen zu werden: eine Route oder eine statische Seite, die die Komponente im Referenz-Viewport mit dem gleichen Auslöser rendert. Ein Entwicklungsserver ist in Ordnung (capture.ts --url http://localhost:5173/…); eine eigenständige HTML-Datei funktioniert auch.
5. Überprüfen, korrigieren, wiederholen
Nimm den Klon mit dem exakt gleichen Befehl wie für die Referenz auf, ändere nur --url und --out clone-N, dann:
bun <skill>/scripts/compare.ts --ref ref/frames --clone clone-N/frames --out compare-N
bun <skill>/scripts/sheet.ts compare --ref ref/frames --clone clone-N/frames --diff compare-N/diff --out compare-N/sheets --every 2
bun <skill>/scripts/easing.ts --track clone-N/track.json --selector "<el>" --prop <translateY|opacity|…> --compare-track ref/track.json
Für Canvas-Arbeit führe auch gl.ts compare --ref ref --clone clone-N aus, das Canvas-Einstellungen, Zeichenstruktur und jeden animierten Kanal überprüft.
Lies references/verify.md, um zu erfahren, wie der Bericht zu lesen ist, die Bestehenskriterien für jeden Genauigkeitsgrad und welche Korrekturen jede Art von Fehler normalerweise benötigt. Sieh dir die Vergleichsblätter selbst an, jede Runde; die Zahlen sagen dir, dass etwas nicht stimmt, die Blätter sagen dir, was.
Wiederhole die Schleife, bis jede Spezifikationszeile bestanden ist. Jede Runde: Ändere das kleinste Ding, auf das die Beweise hinweisen, nimm erneut auf, vergleiche erneut. Erwarte 2 bis 5 Runden. Wenn nach 5 Runden eine Zeile immer noch fehlschlägt, stoppe und melde sie mit ihren Zahlen und dem Grund (fehlende Schriftart, ein Shader oder Modell, das der Benutzer möglicherweise nicht kopieren darf, eine physikalische Feder, die du angenähert hast), senke nicht stillschweigend die Schwelle oder lasse die Zeile weg.
6. Bericht
Die endgültige Nachricht muss für sich allein stehen:
- Genauigkeitsgrad und was geklont wurde, was hinzugefügt wurde.
- Wo der Code ist (Dateien) und wie die Bewegung ausgelöst wird.
- Eine kurze Tabelle der letzten Vergleichsrunde: Timing-Fehler, mittlere Abweichung, Easing-Übereinstimmung pro Schlüsselelement, bestanden/fehlgeschlagen.
- Pfade zu den endgültigen Vergleichsblättern, eingebettet als Bilder, wenn die Umgebung sie anzeigt.
- Verbleibende Abweichungen, jede mit einer Zahl und einem Grund.
Fallstricke, die Runden verschwenden
- Unterschiedlicher Viewport oder Zuschnitt zwischen Referenz und Klon: Korrigiere die Aufnahme, bevor du Code anfasst.
- Nur nach dem ersten und letzten Frame urteilen: Das Easing lebt in den mittleren Frames; lies die Blätter.
- Schriftarten: Eine andere Fallback-Schriftart ändert jeden Frame-Pixel. Lade bei pixeltreuer Arbeit die gleiche Schriftart (aus
inspect.jsonfonts), bevor du die Abweichung beurteilst; ignoriere bei bewegungstreuer Arbeit Textpixel und lies die Timing-Spalten. - Referenz auf einer geladenen Seite aufgezeichnet vs. Klon kalt aufgenommen: Verwende
--wait-beforeoder--trigger nonemit einem--pre-js, das die Animation neu startet, sodass beide aus dem Ruhezustand starten. - Scrollgesteuerte Bewegung: Sie ist eine Funktion der Bildlaufposition, nicht der Zeit. Nimm beide mit den gleichen
--scroll-stepsund--scroll-msauf und vergleiche pro Bildlaufposition (dasscrollYder Spur), nicht pro Sekunde. - JS-Bibliotheken (GSAP, Framer Motion Federn):
--playback-rateverlangsamt sie nicht. Verwendetrack.jsonundeasing.ts(es meldet Überschwingen und „federartig") und passe Federparameter durch Überschwingen und Einschwingzeit an. - Videos von fremden Bildschirmen haben einen Cursor, eine Browserchrom und Kompressionsrauschen: Schneide sie aus und erhöhe
--pixel-thresholdleicht (0.15), anstatt Rauschen nachzujagen. - Canvas und WebGL, aufgenommen mit der echten Uhr: Frames fallen in Software-GL aus und zufällige Inhalte unterscheiden sich bei jedem Laden, also misst der Vergleich die Maschine. Nimm beide Seiten mit
--clock virtualund dem gleichen--seedauf. - Einen Shader aus Screenshots nachbauen: Der Trace hat bereits seine Quelle und jede Konstante. Lies
gl/shaders/und die festen Uniforms, bevor du GLSL schreibst.