UI-Morph-Spezifikation (Kursschritt 06, Level L3)
Schreibe die Zustandsliste, nicht die Stimmung. Das am meisten mit Lesezeichen versehene Prompt der Opus 5.5-Startwoche war kein Einzeiler: @twoclipping's UI-Morph-Schleife und @verbove's MakerMap-Film verwendeten beide eine XML-Spezifikation mit Eingaben, Richtung, einer beat-genauen Zustandsliste, Aufbauregeln und Fallstricken. Die Idee dahinter: eine Form, die niemals geschnitten wird. Ein einzelnes Element ändert Größe, Radius und Farbe von Zustand zu Zustand (Button, Ladebalken, Player, Diagramm, Befehlspalette), ein Cursor verursacht jede Änderung mit einem echten Klick, und der letzte Frame entspricht dem ersten, sodass die Schleife läuft.
Anforderungsargumente (können leer sein), einmal angezeigt:
Quellenangabe: Das sechsteilige Layout folgt @twoclipping's öffentlicher Vorlage (https://x.com/twoclipping/status/2103273003555402193; das XML befindet sich im Hauptbeitrag, nicht in einem Thread-Antwort wie der Kurs sagt) und @verbove's MakerMap-Spezifikation (https://x.com/verbove/status/2103483957266268381). Die Vorlage in diesem Skill ist in motion-studios eigenen Worten geschrieben: assets/spec-template.xml.
1. Fordere die Eingaben an
Frage in einer einzigen AskUserQuestion-Runde (Unter-Agenten können nicht fragen; du tust es):
| Eingabe | Standard | Regel |
|---|---|---|
| Produkt + URL | erforderlich | Erfasse die echte UI und kopiere sie mit /motion-studio:product-reel Stufe 3, wenn eine URL vorhanden ist |
| 8 bis 12 Zustände in Reihenfolge der Geschichte | Logo, CTA, E-Mail-Feld, Ladebalken, Haken, Karte, Diagramm, Befehlspalette | einer pro Downbeat |
| Echte Daten pro Zustand | Fragen | Beschriftungen, Zahlen, Namen aus dem Produkt; keine Platzhalter |
| Markenfarben, Schriftarten, eine Akzentfarbe | aus Capture oder studio.json | eine Akzentfarbe |
| Track | Synthetisiere minimal bei 120 BPM | Ein bereitgestellter Track muss diese Nutzung erlauben und auf einem Downbeat beginnen |
| Formate | 9x16, 1x1, 16x9 | Gleicher Zeitplan, neu gerahmt |
| Schleife | ja | Der letzte Zustand morphiert zurück in den ersten |
2. Fülle die Spezifikation aus
Kopiere die Vorlage in das Projekt als docs/spec.xml und fülle jedes [...] mit den Antworten aus.
Behalte alle sechs Abschnitte bei: <inputs>, <direction>, <structure>, <build>, <gotchas>,
<start>. Der motion-director-Unter-Agent (motion-studio:motion-director) kann sie aus deiner Besprechung entwerfen;
er schreibt nur unter docs/.
3. Platziere die Zustände auf dem Beat-Gitter
-
Projekt: Struktur mit
--loopfalls nötig (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <verz> --title "<Produkt> morph" --loop --duration <S> --install; in einer Nur-Skills-Installation verwendenode "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ...mit denselben Flags oder rufe dasstudio-init-Skill auf). -
Gitter:
node tools/score.mjs --style minimal --bpm 120 --duration <S>, oder messe den bereitgestellten Track mitnode tools/beats.mjs audio/<track>. -
Zustandsliste mit genauen Downbeat-Zeiten, Schleifenprüfungen und Warnungen:
node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "Logo,CTA-Button,E-Mail-Feld,Ladebalken,Haken,Karte,Diagramm,Palette" --out docs/statelist.mdFlag Verwendung --states "a,b:2,c"oder--file liste.txtZustände in Reihenfolge; :2hält einen Zustand für zwei Takte--beats audio/beats.jsonGemessenes Gitter (Standard, wenn die Datei existiert); --beats noneignoriert es--bpm N,--beats-per-bar NÜberschreibe das Gitter --no-loopEin Film, der endet statt zu loopen --jsonEine JSON-Zeile mit Start, Ende und Content-Timing jedes Zustands Es warnt, wenn die Schleifenlänge von der
durationinstudio.jsonabweicht, wenn der erste Zustand nicht bei 0 s liegt (ein Auftakt im Track), oder wenn ein Zustand unter 1 s gehalten wird. Korrigiere die Dauer oder passe den Track an, bevor du fortfährst. -
Fülle die Spalten Cursor-Aktion, Daten und Sound von
docs/statelist.mdaus und kopiere die Tabelle indocs/shotlist.md.
4. Die Schleuse
Zeige die Zustandsliste auf dem Beat-Gitter an und warte auf das OK des Benutzers, bevor du Filmcode schreibst (der
<start>-Abschnitt sagt das, und der Kurs tut es auch). Eine abgelehnte Liste wird umgeschrieben, nicht umprogrammiert.
Halte die Entscheidung in der Zeile Status: von docs/shotlist.md fest.
5. Baue aus dem verifizierten Beispiel
Kopiere assets/morph-loop.film.js nach film/film.js und passe es an: Es ist eine
funktionierende 16-Sekunden-, 8-Zustands-Schleife bei 120 BPM, die in jedem Format rendert. Ersetze STATES (Größen in
1080 px Einheiten, Füllungs-Token), COPY und die content-Maler mit der genehmigten Liste und den echten
Daten; behalte die Mechaniken bei:
| Mechanik | API | Regel |
|---|---|---|
| Zustandszeiten | grid.bar(i) | Niemals eingegebene Sekunden |
| Containergröße, Radius, Farbkanäle, Kamera-Zoom | loopTrack(t, keys, dauer, spring) | Schlüssel in [0, dauer]; die Naht ändert sich einmal, als Schlüssel beim ersten Downbeat (dieses Beispiel) oder bei t = dauer |
| Content ein- und ausblenden | swapAlpha(t, start, nächsterStart) | ein, nachdem der Morph beginnt, aus vor dem nächsten |
| Cursor | loopTrack auf x und y, cursor(g, x, y, { gedrückt }) | Klickt das aktuelle Element auf dem Downbeat |
| Tabs und Listen-Highlights | indicator(t, stops, { breite }) | Ränder auf unterschiedlichen Federn |
| Sounds | cues von grid.bar und grid.beat | Klick bei Drücken, Wischgeräusch unter Morphs |
| Körnung und andere frame-indizierte Störungen | grain(g, B, H, c.frame % LOOP_FRAMES, ...) mit LOOP_FRAMES = Math.round(dauer * fps) | Die Kritik vergleicht hash(0) mit hash(dauer, { wrap: false }); Störungen, die durch den rohen Frame-Index gesät werden, lassen das Ende sich von Frame 0 unterscheiden und bestehen die Schleifenprüfung nicht |
Jedes Muster mit seiner Begründung: references/morph-recipes.md.
Setze in studio.json "loop": true und "duration" auf die Schleifenlänge, dann npm run lint.
6. Kritik und Auslieferung
Führe die Kritikschleife von /motion-studio:motion-reel aus (mindestens 3 Runden, alle Achsen >= 8, keine offenen P0; jede Runde
baut den gemischten Render und beide Nachweise laufen zuerst, siehe sein Pipeline-Runbook).
Überprüfe für Morph-Schleifen auch out/review/<fmt>/loop.png (nur Live-Durchlauf; der video/-Durchlauf hat kein Schleifen-Panel) und die Metrik "Schleifennaht"
(hash(0) gleich hash(dauer, { wrap: false }), Kontinuitätsverhältnis <= 1.5; das |ende - anfang|-Panel muss schwarz sein,
was frame-indizierte Körnung zerstört, es sei denn, ihr Index wickelt sich), Beschriftungen während jedes Wechsels in strip.png, und die
Cursorposition bei jedem Downbeat in contact.png. Ein Nahtsprung ist ein P0. Dann npm run build.
Regeln für Morph-Filme
- Ein Container, niemals geschnitten. Zustände unterscheiden sich nur durch Größe, Radius, Füllung und Inhalt.
- Ein Cursor verursacht jede Änderung; kein Zustand ändert sich von selbst.
- Irgendetwas bewegt sich bei jedem Beat: ein Drücken, Tippen, ein Zähler, eine Linienzeichnung, ein Highlight-Schritt.
- Nur echte Produktdaten. Federn mit höchstens einer Andeutung von Überschwingen; keine bei Schriftarten.
- Verboten: hüpfende Easing-Funktionen, Leuchteffekte, Verläufe auf UI-Chrome, Partikelausbrüche, tote Beats.
- Niemals
will-change(oder einen Rasterisierungstrick) auf etwas verwenden, das die Kamera skaliert.
Als nächstes: /motion-studio:springs um das Gefühl zu optimieren; /motion-studio:ship-formats für die formatbezogene
Neurahmung und Auslieferung.