Spécification de morph UI (étape 06 du cours, niveau L3)
Écris la liste d'états, pas l'ambiance. Le prompt le plus mis en favoris de la semaine de lancement d'Opus 5.5 n'était pas une phrase courte : la boucle de morph UI de @twoclipping et le film MakerMap de @verbove utilisaient tous deux une spécification XML avec des entrées à demander, une direction, une liste d'états temps par temps, des règles de construction et des pièges. L'idée derrière : une seule forme qui ne coupe jamais. Un élément unique change de taille, de rayon et de couleur d'état en état (bouton, loader, player, graphique, palette de commandes), un curseur provoque chaque changement avec un clic réel, et la dernière image est égale à la première pour que le film boucle.
Arguments de la requête (peuvent être vides), affichés une fois :
Crédit : la disposition en six sections suit le modèle public de @twoclipping (https://x.com/twoclipping/status/2103273003555402193 ; le XML est dans le message principal, pas dans une réponse de fil comme le cours l'indique) et la spécification MakerMap de @verbove (https://x.com/verbove/status/2103483957266268381). Le modèle dans cette compétence est écrit dans les propres mots de motion-studio : assets/spec-template.xml.
1. Demander les entrées
Demander en un tour de AskUserQuestion (les sous-agents ne peuvent pas demander ; c'est toi qui le fais) :
| Entrée | Défaut | Règle |
|---|---|---|
| Produit + URL | requis | capturer l'UI réelle et copier avec /motion-studio:product-reel étape 3 quand il y a une URL |
| 8 à 12 états dans l'ordre de l'histoire | logo, CTA, champ email, loader, check, carte, graphique, palette de commandes | un par temps fort |
| Données réelles par état | demander | étiquettes, nombres, noms du produit ; pas de valeurs génériques |
| Couleurs de la marque, polices, un accent | de la capture ou de studio.json | un accent |
| Piste sonore | synthétiser minimal à 120 BPM | une piste fournie doit permettre cette utilisation et commencer sur un temps fort |
| Formats | 9x16, 1x1, 16x9 | même timeline, recadrée |
| Boucle | oui | le dernier état morph (se transforme) en le premier |
2. Remplir la spécification
Copier le modèle dans le projet sous docs/spec.xml et remplir chaque [...] avec les réponses.
Conserver les six sections : <inputs>, <direction>, <structure>, <build>, <gotchas>,
<start>. Le sous-agent motion-director (motion-studio:motion-director) peut la rédiger à partir de ton brief ; il écrit uniquement sous docs/.
3. Placer les états sur la grille de temps
-
Projet : initialiser avec
--loopsi nécessaire (node "${CLAUDE_PLUGIN_ROOT}/skills/studio-init/scripts/init.mjs" <dir> --title "<Produit> morph" --loop --duration <S> --install; dans une installation sans plugin, utilisernode "${CLAUDE_SKILL_DIR}/../studio-init/scripts/init.mjs" ...avec les mêmes options, ou invoquer la compétencestudio-init). -
Grille :
node tools/score.mjs --style minimal --bpm 120 --dur <S>, ou mesurer la piste fournie avecnode tools/beats.mjs audio/<track>. -
Liste d'états avec les temps exacts, vérifications de boucle et avertissements :
node "${CLAUDE_SKILL_DIR}/scripts/statelist.mjs" --states "logo,CTA button,email field,loader,check,card,chart,palette" --out docs/statelist.mdOption Utilisation --states "a,b:2,c"ou--file list.txtétats dans l'ordre ; :2maintient un état pendant deux mesures--beats audio/beats.jsongrille mesurée (par défaut quand le fichier existe) ; --beats nonel'ignore--bpm N,--beats-per-bar Nremplacer la grille --no-loopun film qui se termine au lieu de boucler --jsonune ligne JSON avec le début, la fin et le timing du contenu de chaque état Il avertit lorsque la durée de la boucle diffère de
durationdansstudio.json, lorsque le premier état n'est pas à 0 s (un pickup dans la piste), ou lorsqu'un état dure moins de 1 s. Corriger la durée ou couper la piste avant de continuer. -
Remplir les colonnes d'action du curseur, de données et de son de
docs/statelist.md, et copier le tableau dansdocs/shotlist.md.
4. La validation
Montrer la liste d'états sur la grille de temps et attendre l'accord de l'utilisateur avant d'écrire du code de film
(la section <start> le dit, et le cours aussi). Une liste refusée est réécrite, pas contournée par le code.
Enregistrer la décision sur la ligne Status: de docs/shotlist.md.
5. Construire à partir de l'exemple vérifié
Copier assets/morph-loop.film.js dans film/film.js et l'adapter : c'est une
boucle fonctionnelle de 16 s, 8 états à 120 BPM qui s'affiche dans tous les formats. Remplacer STATES (tailles en
unités de 1080 px, jeton de remplissage), COPY et les peintres content par la liste approuvée et les
vraies données ; conserver les mécanismes :
| Mécanisme | API | Règle |
|---|---|---|
| temps des états | grid.bar(i) | jamais de secondes tapées en dur |
| taille du conteneur, rayon, canaux de couleur, zoom de la caméra | loopTrack(t, keys, dur, spring) | clés dans [0, duration] ; le changement de bordure une fois, en tant que clé sur le premier temps fort (cet exemple) ou à t = duration |
| entrée et sortie du contenu | swapAlpha(t, start, nextStart) | entre après le début du morph, sort avant le suivant |
| curseur | loopTrack sur x et y, cursor(g, x, y, { pressed }) | clique sur l'élément actuel sur le temps fort |
| onglets et surbrillance de liste | indicator(t, stops, { width }) | bords avec différents ressorts |
| sons | cues de grid.bar et grid.beat | clic sur les pressions, swoosh sous les morphs |
| grain et autre bruit indexé par image | grain(g, W, H, c.frame % LOOP_FRAMES, ...) avec LOOP_FRAMES = Math.round(dur * fps) | la critique compare hash(0) avec hash(duration, { wrap: false }) ; le bruit initialisé par l'index d'image brut fait que la fin diffère de l'image 0 et échoue à la vérification de boucle |
Chaque motif avec son raisonnement : references/morph-recipes.md.
Définir studio.json "loop": true et duration sur la durée de la boucle, puis npm run lint.
6. Critique et livraison
Exécuter la boucle de critique de /motion-studio:motion-reel (au moins 3 tours, tous les axes >= 8, aucun P0 ouvert ; chaque tour
construit le rendu mixé et les deux passes de preuve d'abord, voir son manuel de pipeline).
Pour les boucles de morph, vérifier aussi out/review/<fmt>/loop.png (passe live uniquement ; la passe video/ n'a pas de panneau de boucle) et la métrique de "couture de boucle"
(hash(0) égal à hash(duration, { wrap: false }), ratio de continuité <= 1.5 ; le panneau |end - first| doit être noir,
ce que le grain indexé par image brise à moins que son index ne boucle), les étiquettes pendant chaque échange dans strip.png, et la
position du curseur à chaque temps fort dans contact.png. Un saut de couture est un P0. Ensuite npm run build.
Règles pour les films de morph
- Un seul conteneur, jamais de coupure. Les états diffèrent uniquement par la taille, le rayon, le remplissage et le contenu.
- Un curseur provoque chaque changement ; aucun état ne change tout seul.
- Quelque chose bouge sur chaque temps : une pression, une frappe, un compteur, un tracé de ligne, une étape de surbrillance.
- Uniquement des données réelles du produit. Des ressorts avec au plus une légère suggestion de dépassement ; aucun sur la typographie.
- Interdit : easing rebondissant, lueurs, dégradés sur le chrome de l'UI, explosions de particules, temps morts.
- Jamais de
will-change(ni d'astuce de pixellisation) sur quoi que ce soit que la caméra redimensionne.
Suivant : /motion-studio:springs pour ajuster la sensation ; /motion-studio:ship-formats pour le recadrage et la livraison par format.