Créer une vidéo - La compétence Du Débutant au MP4 Terminé
Deux phases, huit étapes séquentielles. Chaque étape produit un artéfact concret consommé par l'étape suivante. Ne sautez pas les étapes.
Quand utiliser cette compétence - et quand passer la main
Utilisez cette compétence quand :
- L'utilisateur est novice avec HyperFrames et part d'un concept, d'un script ou d'un plan
- Il souhaite un parcours complet, pas des références sur le framework
- Il n'a pas encore choisi de format
Passez la main quand :
- L'utilisateur colle une URL et veut une vidéo de ce site → invoquez
/website-to-hyperframes - L'utilisateur veut explicitement une vidéo verticale 9:16 avec visage et superpositions de scènes → exécutez les étapes 1 à 4 ici, puis invoquez
/short-form-videoà partir de l'étape 5 - L'utilisateur demande les règles du framework, pas une vidéo → invoquez
/hyperframes
Note de routage (pipeline AI Edit Video) : lorsque cette compétence est exécutée à partir d'un brief de projet, les sections STYLE DESIGN et PHONG CÁCH DỰNG (style vidéo) de l'invite d'édition remplacent les valeurs par défaut de l'interview ci-dessous - ne posez pas à nouveau les questions de style auxquelles le brief répond déjà.
Les deux phases
- Phase 1 - INTERVIEW (étapes 1–4) : un seul passage conversationnel pour rassembler tout avant de toucher au code. Intention, format, script, voix, style, assets, rythme. Synthétisez en un
BRIEF.mdet attendez une approbation explicite. - Phase 2 - CONSTRUCTION (étapes 5–8) : scaffold → storyboard → compositions → lint → prévisualisation Studio → rendu brouillon → vérification visuelle → prévisualisation MP4 → rendu final.
Étape 1 · Intention et format
Posez une question à la fois via AskUserQuestion, avec des choix multiples si possible.
- À quoi sert cette vidéo ? (promo · publicité sociale · teaser de lancement · démo produit · tutoriel · explicatif · carte d'intro/outro · autre)
- Qui est le public ? (libre)
- Durée cible ? (10–20s court · 20–45s promo · 45–90s explicatif · 1.5–3 min leçon · personnalisé)
- Format d'image ? (16:9 1920×1080 · 9:16 1080×1920 · 1:1 1080×1080)
- Images par seconde ? (30 par défaut · 60 pour UI nette · 24 cinématographique)
- Plateforme / contraintes de livraison ? (taille de fichier · date limite · lieu de lecture)
Étape : les six éléments sont capturés. Si la réponse est 9:16 + visage, prévoyez de passer à /short-form-video à l'étape 5.
Banque de questions complète : Read: references/interview-questions.md
Étape 2 · Script et voix
- Source du script ? (coller · plan → je rédige · j'enregistre · TTS à partir du texte · pas de narration)
- Si TTS : préférence vocale. Proposez des choix à partir de
npx hyperframes tts --help. Capturez également le rythme.hyperframes tts(Kokoro) est uniquement en anglais - la narration vietnamienne passe par le/api/ttsdu système (Gemini TTS ou VieNeu). - Si visage : chemin d'enregistrement · placement plein écran ou dans un coin · besoin de transcription ? (
npx hyperframes transcribe <fichier> --model small.en --json- anglais uniquement ; pour le vietnamien, utilisez faster-whisper selon la compétence noti-tiktok-vn) - Sous-titres ? (désactivé · hype · corporate · karaoké mot-à-mot · minimal)
Étape : script capturé (ou rédigé), plan audio capturé, plan de sous-titres capturé.
Étape 3 · Recueil du style
Avant de demander quoi que ce soit à l'utilisateur, inventorier les assets existants. Vérifiez <racine-espace-de-travail>/assets/ et tout dossier assets/ du projet. Ne demandez pas ce qui est déjà là.
Puis demandez progressivement - ils n'ont pas besoin de réponses à tout :
- Guide de style ou document de marque ? (coller/chemin · non)
- Palette de couleurs ? (codes hex · aucun - utiliser les valeurs par défaut de MOTION_PHILOSOPHY)
- Polices ? (nom(s) Google Fonts · chemins de fichiers · aucun - utiliser les valeurs par défaut Inter + JetBrains Mono)
- Fichier logo ? (chemin · aucun). Si une marque est nommée mais aucun fichier n'est donné : cherchez dans
assets/brand-logos/, ou récupérez-le avecPOST /api/brand-logos {"name":"..."}- un mot-symbole textuel est autorisé UNIQUEMENT après un404 BRAND_LOGO_NOT_FOUND. Ne dessinez ni ne générez jamais de logo. - Vidéos de référence pour l'ambiance ? (URLs/chemins · aucun)
- Autres assets ? (captures d'écran · photos de produits · rushes · musique - listez les chemins)
- Esthétique MOTION_PHILOSOPHY (toile noire · texte chromé · grille de perspective · transitions whip) ou une autre sensation ?
- Rythme ? (kinétique 1–2s · équilibré 2–3s · relaxé 3–5s)
- Musique ? (aucune · nappe ambiante 0.15 · fond musical 0.4 · complet 0.8 - chemin du fichier s'ils en ont un)
- Texte d'outro / appel à l'action ?
N'imposez jamais une marque à l'utilisateur. Revenez aux valeurs par défaut de MOTION_PHILOSOPHY uniquement lorsqu'il refuse explicitement de fournir un style.
Flux de style complet + valeurs par défaut de MOTION_PHILOSOPHY : Read: references/style-intake.md
Étape 4 · Synthèse du brief (ÉTAPE VERROU avant la construction)
- Lisez
MOTION_PHILOSOPHY.mds'il existe dans la racine de l'espace de travail - obligatoire s'il est présent. S'il manque, procédez avec les valeurs par défaut dansreferences/style-intake.mdet notez l'absence dans le brief. - Demandez où se trouvent les projets si ce n'est pas évident :
- Si
video-projects/existe → utilisezvideo-projects/<slug>/ - Sinon → demandez à l'utilisateur
- Si
- Écrivez
<dossier-projet>/BRIEF.md:- slug · intention · public · dimensions · fps · durée
- script (complet ou plan)
- choix de voix · plan de sous-titres · plan de visage
- profil de style : palette (hex), polices, chemin du logo, vidéos de référence
- rythme
- inventaire des assets avec chemins
- texte d'outro / CTA
- Montrez le brief. ATTENDEZ une approbation explicite. Ne passez pas à l'étape 5 sans un « oui, construis-le » clair.
Étape 5 · Scaffold et storyboard
Vérification de passage d'abord
Si le brief décrit une vidéo verticale 9:16 avec visage et superpositions de scènes, invoquez /short-form-video MAINTENANT et transmettez le brief. Son scaffold en 4 couches est spécialement conçu pour ce format.
Sinon, continuez :
Scaffold
mkdir <dossier-projet>- Si un projet frère avec un format similaire existe, proposez de copier ses
hyperframes.json+meta.jsoncomme modèle. Sinon, depuis l'intérieur du dossier :npx hyperframes init - Modifiez
meta.jsonavec le slug, les dimensions, le fps de l'utilisateur. - Copiez les assets fournis dans
<dossier-projet>/assets/. - Créez
<dossier-projet>/assets/style-profile.mdà partir de l'étape 3 - source unique de vérité pour la palette/ polices/logo.
Storyboard
Générez <dossier-projet>/STORYBOARD.md en utilisant le modèle dans references/storyboard-template.md. Chaque battement obtient :
Battement N - TITRE (début–fin, durée) - Concept en une phrase
Éléments visuels : [chaque élément, taille, animation, timing]
Langage de mouvement : [type de mouvement]
Easings utilisés : [3–4 easings GSAP distincts]
Sortie : [transition vers le battement suivant]
Audio : [ligne VO / SFX / couche musicale]
En haut du fichier : un tableau de timing avec scène · début · durée · fichier de composition.
Proposez une structure en trois actes :
- Acte 1 (accroche) ≈ 20% de la durée
- Acte 2 (corps) ≈ 55%
- Acte 3 (conclusion + outro avec pause de 4–6 secondes) ≈ 25%
(MOTION_PHILOSOPHY §0 Loi 9, §1.)
Mappez les intentions utilisateur → blocs du catalogue : Read: references/catalog-intent-map.md
Étape : montrez le storyboard + le tableau de timing. Itérez jusqu'à ce que l'utilisateur approuve.
Étape 6 · Construire les compositions
Invoquez /hyperframes pour les règles du framework. Cette compétence possède le scaffold et la discipline ; /hyperframes applique les règles.
Scaffold pour chaque sous-composition
<div data-composition-id="nom-scène" data-start="..." data-duration="...">
<style>[data-composition-id="nom-scène"] { /* limité */ }</style>
<!-- DOM -->
<script>
(function(){
const SLOT_DURATION = ...;
const tl = gsap.timeline({ paused: true });
// ... interpolations ...
tl.to({}, { duration: SLOT_DURATION }, 0); // ancrage - MOTION_PHILOSOPHY Loi 11
window.__timelines["nom-scène"] = tl;
})();
</script>
</div>
Modèle complet + modèle de sous-titres + modèle d'arrière-plan ambiant : Read: references/composition-scaffold.md
Règles de construction
- Arrière-plan ambiant sur
data-track-index="0"pour toute la durée de la composition. - Ouvertures typographiques cinétiques : décalage par mot de 0.06–0.10s.
- Sous-titres en tant que frères de niveau corps de la composition racine dans
index.html, chacun avecdata-track-index ≥ 20. Jamais à l'intérieur des timelines de scène (MOTION_PHILOSOPHY §3.13). - Blocs du catalogue installés via
npx hyperframes add <nom>. Immédiatement limitez le CSS du bloc à[data-composition-id="..."]- les blocs du catalogue sont livrés avec des règleshtml, body { ... }qui se répandent dans le document parent lorsqu'ils sont chargés comme sous-compositions. - Vertical + visage : enveloppez le visage natif 1920×1080 dans une transformation (
translate+scale) pour le mode moitié inférieure ou plein écran. (Si vous arrivez ici au lieu de/short-form-video, envisagez sérieusement le passage.) - Appliquez UNIQUEMENT ce que l'utilisateur a fourni. Leur palette, leurs polices, leur logo. N'injectez rien d'autre. S'ils ont choisi les valeurs par défaut de MOTION_PHILOSOPHY, tirez la palette + la paire de polices de
references/style-intake.md.
Déterminisme
Pas de Math.random(), pas de Date.now(), pas de fetch() au moment du rendu. Utilisez des PRNG ensemencés ou des hachages sinusoïdaux harmoniques (MOTION_PHILOSOPHY §3.10).
Étape 7 · Lint → Prévisualisation Studio (PRÉVISUALISATION ÉTAPE 1 - OBLIGATOIRE)
npx hyperframes lint- corrigez toutes les erreurs, triez les avertissements.npx hyperframes previewen arrière-plan.- Attendez "Studio running" sur
http://localhost:3002. - Donnez à l'utilisateur l'URL plus les URLs individuelles des compositions (
http://localhost:3002/?comp=<id>). Si le projet a des blocs shader WebGL, commencez par les URLs individuelles - le repli logiciel WebGL peut bloquer la composition principale. - ATTENDEZ un « ça a l'air bon, fais un rendu brouillon » explicite avant de continuer. Le silence n'est pas une approbation.
Le rechargement à chaud est activé - les modifications apparaissent en direct.
Étape 8 · Rendu brouillon → Vérification visuelle → Prévisualisation MP4 → Final
Rendu brouillon
npx hyperframes render --quality draft --output renders/<slug>-draft.mp4
Vérification visuelle (OBLIGATOIRE avant la livraison)
Réussir le lint ne signifie pas que le design fonctionne. Extrayez les images et regardez-les.
mkdir -p renders/frames- Pour chaque moment clé de battement ET chaque transition :
ffmpeg -y -ss <t> -i renders/<slug>-draft.mp4 -frames:v 1 -q:v 2 renders/frames/t<t>.png - Appelez l'outil
Readsur chaque PNG. L'outil Read charge l'image dans le contexte - ne vous contentez pas de lister les noms de fichiers. - Confirmez par image : pas de visages recadrés, mode visage correct par scène, texte lisible et dans la palette, pas de débordement, transitions atterrissant sur les mots prévus, pas d'images vides.
- Si quelque chose ne va pas : corrigez → re-rendu → re-vérifiez. Ne livrez jamais un brouillon défectueux.
Prévisualisation MP4 (PRÉVISUALISATION ÉTAPE 2 - OBLIGATOIRE)
npx serve renders -p 8080 -n
N'utilisez PAS le http.server de Python - il ne prend pas en charge les requêtes HTTP Range, donc le défilement est cassé.
Donnez à l'utilisateur http://localhost:8080/<slug>-draft.mp4. ATTENDEZ un feu vert explicite sur la lecture et la synchronisation audio.
Rendu final
npx hyperframes render --quality standard --output renders/<slug>-final.mp4
Dans le pipeline AI Edit Video, ce n'est PAS la fin : continuez avec la compétence video-pipeline (QC → assemblez le final via la file d'attente de rendu → outputs/<id>-v<N>.mp4 → mettez à jour meta.json → vignette/publication). Utilisation autonome en dehors du pipeline : rapportez le chemin de sortie. Terminé.
Liste de contrôle complète avant vol et avant livraison : Read: references/build-checklist.md
Non-négociables (structuraux - ne les assouplissez pas)
- NE SAUTEZ PAS la PRÉVISUALISATION ÉTAPE 1 (Studio) ou la PRÉVISUALISATION ÉTAPE 2 (MP4 rendu). Deux étapes par construction, toujours.
- NE DITES PAS qu'un rendu est terminé avant que les images aient été extraites ET lues via l'outil Read.
- NE CONSTRUISEZ PAS ailleurs que dans un dossier de projet dédié. Ne mettez jamais
index.htmlà la racine de l'espace de travail. - NE DEMANDEZ PAS les assets à l'utilisateur avant d'avoir inventorier son espace de travail.
- NE SAUTEZ PAS l'interpolation d'ancrage
tl.to({}, { duration: SLOT_DURATION }, 0)à la fin de chaque timeline de sous-composition. MOTION_PHILOSOPHY Loi 11. - N'UTILISEZ PAS
Math.random()/Date.now()dans la logique de rendu. Uniquement des hachages ensemencés. - N'AJOUTEZ PAS
class="clip"aux balises<video>. Cela les casse. - N'IMPOSEZ PAS une marque à l'utilisateur. Demandez d'abord ; revenez aux valeurs par défaut de MOTION_PHILOSOPHY uniquement lorsqu'il refuse explicitement.
Références
references/interview-questions.md- banque de questions complète par étapereferences/style-intake.md- interview de style + valeurs par défaut de MOTION_PHILOSOPHYreferences/catalog-intent-map.md- « l'utilisateur dit X → installez Y »references/storyboard-template.md- modèle battement par battement + exemple travailléreferences/composition-scaffold.md- styles limités + modèle GSAP IIFEreferences/build-checklist.md- étapes avant vol et avant livraison
Externes (niveau espace de travail) :
MOTION_PHILOSOPHY.md- la seule référence externe que cette compétence suppose exister. Base de référence esthétique. Le repli se trouve dansreferences/style-intake.mdsi le fichier est manquant.
Compétences associées
/hyperframes- règles du framework, invoquez à l'étape 6/hyperframes-cli- init · lint · preview · render · transcribe · tts/hyperframes-registry- installation des blocs du catalogue/gsap- référence d'animation GSAP/short-form-video- passez la main à l'étape 5 pour le format 9:16 avec visage/website-to-hyperframes- passez la main à l'étape 1 si l'entrée de départ est une URL