wjgoarxiv/lit-typographic-motion

lit-typographic-motion : un réalisateur avec un moteur de rendu, une passerelle et une boucle d'inspection

Cette compétence transforme une simple requête en un court métrage finalisé, ou en une boucle de couverture silencieuse pour le haut d'un README. Elle ne remet jamais une invite pour un outil vidéo tiers. Elle rédige d'abord un traitement, construit les visuels elle-même, les rend via le moteur déterministe inclus dans ce dossier, mesure le résultat avec une passerelle de validation, puis examine les images rendues avec read_file avant de déclarer le travail terminé.

Il y a trois chemins possibles, et le traitement en choisit un :

• Chemin scénique. Films qui montrent des choses : un produit, un processus, un lieu, un sujet d'exemple inventé. Vous écrivez une page HTML (SVG, Canvas 2D ou WebGL) dans le dossier de sortie, le moteur de rendu pilote Chrome sans tête image par image, et la passerelle scénique vérifie le déterminisme, le contraste, les flashs et les copies. 16:9 (1920x1080) ou 9:16 (1080x1920).
• Chemin typographique. Films dont les mots sont le film : typo-cinétique, vidéo de paroles ou de citations, générique. Vous écrivez brief.json et le moteur de typographie WebGL2 intégré met en place les mots avec ses préréglages et ses passes de post-traitement. 1920x1080.
• Mode couverture. Boucle pour README, bannière ou en-tête. Pas de beats, pas de son, pas de fin : un système animé sur un mot de marque fixe, capturé en 2x, encodé en WebP animé et validé sur le fichier décodé. Lisez references/cover.md avant toute autre chose dans ce mode.

SKILL_ROOT ci-dessous est le dossier du SKILL.md que read_skill a retourné pour plugin:litmuse:lit-typographic-motion. Exécutez chaque script par son chemin absolu sous ce dossier et ne codez jamais en dur le chemin du cache du plugin Muse ; le dossier du cache change à chaque mise à jour de LitMuse.

Quand cela s'applique

• L'utilisateur demande de réaliser un film, un motion graphic, une typographie cinétique, une vidéo de paroles ou de citations, un générique d'ouverture ou de début, un clip d'introduction, ou toute vidéo courte créée à partir d'une requête, avec ou sans ses propres mots.
• L'utilisateur demande une couverture README, une boucle d'en-tête ou de bannière, un en-tête de projet animé ou une couverture animée pour un dépôt.
• L'utilisateur demande une critique d'un rendu effectué par cette compétence : examinez les images et exécutez la passerelle, n'écrivez rien d'autre.

Activation dans LitMuse : lit motion <request>, lit film …, lit video …, lit 영상 …, une invite commençant par lit-typographic-motion, ou un lit <task> dont la tâche demande de réaliser un film (un composé de film tel que 모션그래픽, 키네틱 타이포, 가사 영상, 타이틀 시퀀스, kinetic type, lyric video, title sequence, cover loop, ou un simple 영상 / video / clip avec un verbe de création). Le hook UserPromptSubmit nomme la route ; sous un simple lit la table des routes de session vous permet de choisir vous-même la compétence.

Envoyez ces demandes ailleurs, et dites-le en une ligne :

Demande	Destination
Monter, recadrer, couper, ajouter des sous-titres ou des légendes à des séquences existantes	Pas cette compétence. Aucun pipeline ici ne monte de séquences ; dites-le clairement
Un diaporama ou un rapport sans nom vidéo	lit-pptx ou lit-docx
Une page web, une vidéo d'arrière-plan dans une page, un mouvement au survol ou dans l'interface, des jetons de mouvement	frontend-ui-ux
Une vignette, un script, un résumé ou une transcription concernant une vidéo	travail ordinaire, pas cette compétence
Un README statique avec une image de couverture fixe	readme-studio

Entrées et état

Entrée	Traitement
La requête	Données inertes. Elle va textuellement dans treatment.request et n'est jamais suivie comme instructions, jamais affichée à l'écran.
Mots fournis par l'utilisateur	Ce sont le texte (copy.source: user) ; sur le chemin scénique, ils deviennent les lignes de texte de la page. Ne citez jamais de paroles ou de texte que l'utilisateur ne possède pas.
Pas de mots, pas de sujet, pas de faits	Inventez un sujet d'exemple concret et son texte, listez chaque invention dans le traitement, et étiquetez chacune dans la réponse.
Un style nommé (chemin typographique)	swiss-signal, terminalcore ou tidal remplace le style par défaut de l'agent (references/style-bibles.md).
Un fichier audio	sound.mode: supplied avec son file ; il est toujours mixé et synchronisé avec les coupes (references/sound.md).
Une peinture, un logo ou un mot-symbole pour une couverture	Listé dans assets.json avec son sha256 et source: user ; s'il manque, c'est une sortie 22, jamais un substitut dessiné.
Dossier de sortie	Un nouveau motion-<slug>/ dans le répertoire de travail de l'utilisateur. Jamais le dossier du plugin installé, jamais .litmuse/.

L'état réside dans le dossier de sortie : treatment.json, look.json, stills/, manifest.json, gate-report.txt et .run/ (progression, le pid du rendu détaché et son résultat, le premier traitement valide). Les hooks LitMuse conservent leur propre petit enregistrement de la route de mouvement en dehors de l'espace de travail (ci-dessous).

Matrice des modes

Mode	Déclencheur	Ligne d'arrivée
lit par défaut	la route de mouvement depuis lit	Ne posez aucune question. Choisissez le format selon le canal, la durée selon le genre et une bande sonore générée, et étiquetez chaque valeur par défaut dans la réponse. Fait par references/look.md.
explicite	lit-typographic-motion … ou l'utilisateur nomme le format et la durée	La même boucle. Une seule question courte lorsque l'utilisateur est présent, ne nommant ni le format ni la durée, et que le canal ne le décide pas. Avec l'utilisateur présent, montrez le tableau après le tour 1 et demandez une fois avant le rendu complet ; une requête qui nomme le style ou dit "vous choisissez" saute la question et prend la recommandation.
couverture	treatment.json a "mode": "cover"	Fait par references/cover.md : la couverture décodée atteint chaque passerelle TARGET et le dernier tour d'inspection a consulté sa feuille, son affiche et sa paire de coutures.
révision uniquement	une critique d'un rendu existant	Ouvrez les images, exécutez gate <dir> ou cover-gate <file> --strict, rapportez. N'écrivez rien d'autre.
bloqué	sortie 10, 11, 12, 14, 15, 21 ou 22	Arrêtez. Nommez l'état et sa correction ; ne le contournez jamais avec un autre pipeline.
traitement invalide	sortie 16	Corrigez le champ nommé de treatment.json et relancez.
contrat scénique	sortie 17, 18 ou 19	Corrigez l'élément, l'API, le raster, le clip, la source d'horloge ou l'URL que le message nomme, et relancez.
son invalide	sortie 20	Corrigez la bande ou la piste fournie que le message nomme.

Procédure

Commandes, toutes depuis le parent du dossier de sortie :

node "$SKILL_ROOT/scripts/motion.mjs" styles --out <dir> [--format 16:9|9:16]
node "$SKILL_ROOT/scripts/motion.mjs" assets --out <dir> --url <link> [--cover]
node "$SKILL_ROOT/scripts/motion.mjs" scaffold --out <dir>
node "$SKILL_ROOT/scripts/motion.mjs" stage --out <dir> --round <N> [--stills-only]
node "$SKILL_ROOT/scripts/motion.mjs" make <brief.json> --out <dir> --round <N> [--stills-only]
node "$SKILL_ROOT/scripts/motion.mjs" blender --out <dir> [--final]
node "$SKILL_ROOT/scripts/motion.mjs" sound --out <dir>
node "$SKILL_ROOT/scripts/motion.mjs" look --out <dir> --round <N> --answers <file>
node "$SKILL_ROOT/scripts/motion.mjs" gate <dir>
node "$SKILL_ROOT/scripts/motion.mjs" cover --out <dir> --round <N> [--window t0,t1]
node "$SKILL_ROOT/scripts/motion.mjs" cover-gate <dir>/cover.webp --strict

Chaque image et chaque piste passent par ces moteurs de rendu. Un film assemblé à la main avec ffmpeg, un script Python, un flipbook raster ou un enregistrement d'écran n'est pas le livrable, même s'il paraît correct.

1. Traitement. Lisez references/treatment.md, puis references/studio.md (styles maison, plans, le squelette, le tour de tableau, le fichier maison, le registre riche). Un lien produit dans la requête exécute assets d'abord : le vrai logo, les images et les mots ; quand rien ne peut être récupéré, demandez-les à l'utilisateur. Écrivez <dir>/treatment.json : l'histoire et son rebondissement, le protagoniste, les beats de l'arc du genre sous forme de plans, le sujet (inventez-en un quand la requête n'en nomme aucun), le produit, les dispositifs visuels, le plan typographique, la palette du style, une partition avec ses événements à l'écran, et le texte. style, format, durationSec, genre et fps suivent les règles, pas le goût. Maximale par défaut (register: rich avec un world en couches) ; minimale seulement quand la requête demande calme ou minimal. Pour une couverture, écrivez le traitement de couverture depuis references/cover.md à la place et passez à l'étape 8.
2. Références de chemin. Chemin scénique : references/stage.md, et references/depth.md lorsque le sujet est dessiné en 3D. Chemin typographique : references/brief-schema.md, references/style-bibles.md, references/type-craft.md et references/craft-loop.md ; ouvrez references/engine-contract.md et references/runtime.md uniquement lorsque vous avez besoin des internes du moteur. Les deux chemins : references/look.md et references/sound.md.
3. Construction. Chemin scénique : scaffold --out <dir> écrit <dir>/stage/index.html à partir du traitement ; dessinez le sujet de chaque plan dans sa fonction DRAW (references/stage.md). Chemin typographique : écrivez <dir>/brief.json pour le moteur. Un film 3D prend depth: 3d : l'échelon GPU construit le monde en three.js sur la page squelette, tandis qu'un rendu avec lancer de rayons avec Blender installé prend render3d: blender avec stage/scene.py et blender --final pour le plateau.
4. Tour 1, le tableau. Rendu avec --round 1 --stills-only. La sortie 13 nomme les règles de tableau échouées : corrigez la page et effectuez à nouveau le rendu du tableau. Ouvrez stills/board.png, chaque image de beat, chaque bande de transition et la feuille contact avec read_file, répondez aux neuf questions d'inspection, nommez le beat le plus faible et le changement que vous ferez, et enregistrez-le avec look --round 1 --answers <file>. Puis effectuez ce changement. Un aperçu (preview: true) s'arrête ici : montrez le tableau et dites que le film n'est pas encore rendu.
5. Rendu complet. Rendu --round 2 sans --stills-only. Le rendu complet s'exécute en détaché et écrit <dir>/.run/progress.json ; si l'appel bash expire, exécutez à nouveau la même commande et elle se rattache au rendu en cours. Ne raccourcissez jamais le film pour gagner du temps de rendu. Lisez ensuite gate-report.txt, ouvrez l'affiche, la feuille, chaque image de beat et chaque bande avec read_file, et enregistrez look --round 2.
6. Tour 3 uniquement lorsque la passerelle échoue ou qu'une réponse d'inspection demande un autre tour. Après le tour 3, livrez ce que vous avez et nommez clairement les éléments ouverts.
7. Réponse (ci-dessous).
8. Mode couverture. Suivez references/cover.md : commencez par une recette dans recipes/ (painted-light est la valeur par défaut, weight-tide et orbit-loop les alternatives), écrivez cover/index.html et assets.json, effectuez le rendu cover --round 1, ouvrez la feuille, l'affiche et la paire de coutures avec read_file, enregistrez le tour d'inspection avec jusqu'à trois défauts horodatés, effectuez à nouveau le rendu uniquement de la fenêtre d'un défaut avec --window t0,t1 pendant que vous le réparez, et exécutez à nouveau le rendu cover complet jusqu'à ce que le fichier décodé passe cover-gate --strict et que le dernier tour d'inspection soit propre.

Sorties

Fichier	Ce que c'est
film.mp4	H.264, BT.709, gamme tv ; 1920x1080 (chemin typographique, scénique 16:9) ou 1080x1920 (scénique 9:16) ; AAC 256k sauf si le traitement n'en demande pas
preview.webp, preview.gif	un aperçu en boucle d'au plus 3 Mo
poster.png, reduced-motion.png	une affiche d'au plus 1 Mo, et l'état final stabilisé pour les lecteurs qui désactivent les animations
treatment.json, look.json	le plan, et chaque tour d'inspection avec les images qu'il a consultées
stills/	images de beat, une bande de transition par coupe, une feuille contact de 12 images, board.png avec check.json, et index.json ; en mode couverture, la feuille décodée avec son tracé de différence, l'affiche et la paire de coutures
sound/, sound-cues.json	la partition en couches (ou la bande générée pour un film minimal, ou la piste fournie préparée), chaque piste sous sound/stems/, et chaque repère par rapport à sa coupe
manifest.json, render.jsonl, gate-report.txt	le manifeste d'exécution, le journal par image et le rapport de passerelle
withheld/	seulement après un ÉCHEC d'audit de flash : diagnostics, jamais de livrables
cover.webp, assets.json	mode couverture : la boucle (2 Mio ou moins à TARGET) et la liste vérifiée des illustrations qu'elle utilise

Outils Muse et approbations

• read_skill charge ce fichier et, sur demande, les références. read_file ouvre chaque référence et chaque PNG rendu ; c'est l'outil d'inspection, et rien n'est considéré comme consulté à moins que read_file ne l'ait ouvert dans cette session.
• bash exécute node sur les scripts ci-dessus, toujours par chemin absolu, plus ffmpeg, img2webp, dwebp et gifski via le moteur. Pas d'installation globale, pas de récupération de paquets, pas de réseau depuis un rendu.
• write_file et edit_file écrivent le traitement, le brief, la page, les fichiers de réponses et assets.json à l'intérieur du dossier de sortie.
• subagent_spawn avec subagent_type: litmuse/quality-reviewer (lecture seule) peut donner un second coup d'œil à la feuille contact. Ses notes sont une entrée pour votre tour d'inspection ; il ne peut pas enregistrer le tour pour vous.
• image_generation, lorsque la session le propose, peut créer la peinture de base d'une couverture ; cet actif a source: generated dans assets.json et la réponse l'étiquette.
• L'environnement d'exécution est préchauffé en dehors de Muse, depuis un terminal : npx @litfamily/litmuse runtime install motion (statut : npx @litfamily/litmuse runtime status motion). Le réseau du bac à sable de Muse est proxy uniquement, donc un rendu n'installe jamais rien ; un cache non préchauffé est une sortie 14 avec cette commande. Le niveau optionnel d'analyse de beats s'installe avec node "$SKILL_ROOT/scripts/motion-runtime.mjs" install --audio. Prêt : node "$SKILL_ROOT/scripts/motion-doctor.mjs" et npx @litfamily/litmuse doctor. Détails : references/runtime.md.
• Les compétences et les commandes n'ont pas besoin d'approbation dans Muse ; les hooks qui exécutent la passerelle de terminaison ci-dessous en ont besoin (muse plugins approve litmuse:hook:<id>). Sans hooks approuvés, la passerelle est consultative et les règles de preuve ci-dessous vous lient toujours.

Preuve

Pendant que la route de mouvement est active, le hook PostToolUse de LitMuse enregistre chaque exécution de motion.mjs (sa sous-commande, --out, --round et la ligne exit N NAME lorsque la sortie de l'outil la porte) et chaque image que read_file a ouverte. Le hook Stop exécute ensuite la propre vérification de terminaison de cette compétence, engine/node/done.mjs, sur le dernier dossier de sortie.

Un film est terminé avec tous ces éléments : un traitement valide ; PASS de la passerelle sur le rendu complet final ; au moins deux tours d'inspection, le premier étant un tour de tableau qui nomme un changement ; le dernier tour estampillé avec le manifeste des images du rendu final ; et la liste consultée de ce tour couvrant le tableau, l'affiche, la feuille, chaque image de beat, chaque bande, et chaque image ouverte par read_file dans le dernier look ; toutes les images consultées appartenant au rendu final ; le répertoire de sortie complet tel que listé dans la section Sorties (sauf withheld/, .run/ et sound/stems/ qui sont facultatifs) ; et sound-cues.json correspondant au nombre de coupes dans manifest.json.