/code-motion-director
┌──────────────────────────────────────┐
│ 🔴 🟡 🟢 src/auth/session.ts [9:16]│ barre de titre macOS avec chemin de fichier
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02 const decoded = await verify(); │ ligne active en focus
│ 03 if (!decoded.valid) { ┌─────┼─ 01 Validation du jeton
│ 04 throw new AuthError(); │ │
│ 05 } │ lignes inactives atténuées
│ 06 return decoded.user; │
├──────────────────────────────────────┤
│ > EXÉCUTION DU TERMINAL │ tiroir terminal coulissant
│ > POST /api/v1/auth/verify HTTP/1.1 │ journalisation animée stdout
│ > Statut : 200 OK (14.2 ms) │
└──────────────────────────────────────┘
Première utilisation
Le répertoire de cette compétence est le répertoire de base du paquet de compétences.
# Vérifier que Python 3 est installé
python3 --version || python --version
Fonctionne de manière autonome sans clés API externes, dépendances lourdes ou API cloud payantes. Utilise un Canvas HTML5 / SVG sans tête avec Playwright, Puppeteer ou ffmpeg en option pour le rendu MP4 sans tête.
Étapes d'exécution de l'agent
- Code & Storyboard : Demandez à l'utilisateur l'extrait de code ou extrayez-le de sa requête. Identifiez le récit principal :
- Quel langage ? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
- Quel est le point central ? (par exemple, un appel async/await, un décorateur, une levée d'erreur, un retour récursif).
- Quelle sortie terminal ou quel résultat d'exécution prouve son fonctionnement ?
- Création de la spécification : Écrivez
<nom>.code.json(spécification détaillée ci-dessous) dans le répertoire de travail. - Construction et rendu : Exécutez le script de construction :
python build.py <nom>.code.json- Pour une lecture interactive immédiate en HTML, ouvrez le fichier
<nom>.motion.htmlgénéré. - Pour inspecter une image fixe d'une frame :
python build.py <nom>.code.json --snap 4.5. - Pour valider la syntaxe du schéma :
python build.py <nom>.code.json --validate.
- Pour une lecture interactive immédiate en HTML, ouvrez le fichier
- Vérification de la qualité :
- Les lignes de code tiennent confortablement sans débordement horizontal (48 caractères max par ligne recommandé pour le 9:16 mobile ; 80 max pour le 16:9).
- Les annotations sont concises, numérotées de 01 à 03 et pointent clairement vers les lignes cibles.
- La sortie terminal reflète avec précision un comportement d'exécution réaliste.
- Remise : Livrez le chemin du fichier HTML / vidéo rendu et le résumé de la spécification à l'utilisateur.
Format de spécification (<nom>.code.json)
{
"title": "src/auth/session.ts",
"language": "typescript",
"aspectRatio": "9:16",
"theme": "obsidian",
"code": [
"async function verifyToken(token: string) {",
" const session = await auth.verify(token);",
" if (!session.isValid) {",
" throw new UnauthorizedError('Expired');",
" }",
" return session.user;",
"}"
],
"focusLines": [2, 3],
"typingSpeed": 35,
"callouts": [
{
"line": 2,
"label": "Vérification asynchrone",
"note": "Attend la signature cryptographique",
"side": "right"
},
{
"line": 4,
"label": "Clause de garde",
"note": "Rejette les charges JWT expirées",
"side": "right"
}
],
"terminal": {
"enabled": true,
"title": "Sortie serveur (Node.js v22)",
"commands": [
"$ curl -X POST https://api.dev/auth/verify",
"> Vérification de la signature HMAC-SHA256...",
"> Jeton vérifié : user_id=4092 [200 OK]"
]
},
"sound": {
"typewriterClicks": true,
"completionChime": true
},
"durationSeconds": 8.0
}
Définitions des paramètres
title: Chaîne affichée dans la barre d'en-tête de la fenêtre (par exemple, nom de fichier ou chemin de module).language:"javascript","typescript","python","rust","go","sql","bash".aspectRatio:"9:16"(Bande verticale pour TikTok/Shorts/Instagram) ou"16:9"(Grand écran horizontal).theme:"obsidian"(violet foncé profond),"onedark"(inspiré d'Atom),"monokai"(classique contraste élevé) ou"cyberpunk"(cyan/magenta néon).code: Tableau de chaînes, chacune représentant une ligne de code.focusLines: Tableau de numéros de ligne basés sur 1 pour conserver une luminosité à 100 % tandis que les autres lignes sont atténuées.callouts: Liste facultative d'annotations. 3 annotations max recommandées.line: Numéro de ligne basé sur 1 pour ancrer le trait d'annotation.label: Titre court en majuscules ou en gras (18 caractères max).note: Sous-titre explicatif (28 caractères max).
terminal: Tiroir inférieur facultatif avec les commandes et réponses stdout.sound: Paramètres de synthèse procédurale Web Audio API facultatifs (clics de frappe et carillon).durationSeconds: Durée totale de l'animation (par défaut : 8,0 s).
Plateformes prises en charge
| Plateforme | Méthode d'intégration |
|---|---|
| Claude / Claude Code | Chargé via SKILL.md dans ~/.claude/skills/code-motion-director/ ou l'espace de travail .claude-plugin/ |
| Google Antigravity | Enregistré sous .gemini/antigravity/skills/code-motion-director/ |
| ChatGPT / GPT personnalisés | Configuré via des instructions personnalisées en utilisant adapters/chatgpt-instructions.md |
| Google Gemini | Injecté via instruction système en utilisant adapters/antigravity-gemini.md |
Standards de goût et d'esthétique
- Hiérarchie visuelle claire : Gardez le code propre, formaté et lisible. Ne collez jamais de code minifié.
- Annotations concises : Les notes d'annotation doivent être des faits techniques, pas du battage marketing (« Attend la promesse », pas « Super fonctionnalité ! »).
- Contraste et lisibilité : Assurez-vous toujours que la police du code est suffisamment grande pour les écrans de smartphones mobiles (28 px minimum sur un canevas 1080x1920).
- Rythme : La frappe doit sembler naturelle (25 à 40 ms par caractère). La sortie du terminal doit apparaître après la fin de la frappe du code.