Aperçu
Cette compétence transforme un changelog de version en une composition vidéo soignée en utilisant le rendu HTML d'HyperFrames. Utilisez-la lorsqu'une mise à jour de produit mérite une annonce visuelle — trames héroïques, appels de points clés et motif d'arrière-plan. Elle produit une MP4 rendue à partir des entrées du changelog que vous lui fournissez.
HyperFrames — Vidéo de Changelog
Entrée : un changelog .md (thèmes + éléments). Sortie : un projet HyperFrames propre, vert seam-gate. Ne rendez que lorsque demandé.
Quand l'utiliser
- L'utilisateur fournit un changelog/résumé markdown et souhaite la vidéo hebdomadaire
- L'utilisateur dit "vidéo changelog" ou "vidéo digest hebdomadaire"
- L'utilisateur souhaite une vidéo de marque avec des UI animées et une voix off
Quand NE PAS l'utiliser
- L'utilisateur souhaite un lancement de produit (utiliser
hyperframes-product-launch-video) - L'utilisateur souhaite un graphique animé (utiliser
hyperframes-motion-graphics) - L'utilisateur souhaite une vidéo en plans de parole (utiliser
hyperframes-embedded-captions)
La Directive Principale : Visualiser, Ne Pas Lister
Chaque thème est illustré par une maquette animée de l'interface utilisateur réelle ou d'un analogue fidèle qui joue le changement d'expérience — jamais de puces de texte. Routez chaque thème/élément via le registre de visualisation AVANT d'écrire le script.
Flux de Travail
0 · Bootstrap à partir des actifs de la compétence (non négociable)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
Ensuite, lisez references/build-spec.md de bout en bout — il définit les jetons de marque.
1 · Analyse + coupe éditoriale
- Extraire : plage hebdomadaire, statistiques principales, thèmes, éléments
- Budget : 45-60s total. Titre ≤2s, outro ≤3,5s, 4 thèmes ≈ 9-12s chacun
- Par thème, garder UNE visualisation héroïque + au plus 3 éléments parlés
- Ordonner les thèmes par histoire : fonctionnalité phare → surface produit → performance → fiabilité
2 · Routage de visualisation
Pour chaque thème, choisir la surface depuis le registre de visualisation et écrire une ligne : theme → surface → les 2-4 actions séquencées que la maquette effectue, chacune liée à une phrase du script.
3 · Script à deux couches (parlé vs affiché)
Écrire le script sous forme de lignes de jetons : registre conversationnel, chaque terme technique portant une forme phonétique spoken tandis que display conserve l'orthographe standard. Les sous-titres montrent display ; la VO lit spoken.
4 · VO + horodatages des mots
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
Les timings des mots sont une porte dure. Avant de continuer, vérifiez que vo-words.json n'est pas vide et possède un tableau words: [...] avec start/end pour chaque mot.
5 · Construction
Suivez exactement references/build-spec.md : jetons de marque + polices + encodage d'arrière-plan animé + canevas de scène + chrome + rail de sous-titres. Puis l'ordre de la doctrine : registre vectoriel → timbre seam → battements internes sur les mots de la VO → vérification seam-gate.
Les sous-titres ne sont pas optionnels. Remplissez le tableau LINES à partir de captions.json avant de continuer.
6 · Portes (toutes vertes avant de présenter)
hyperframes check— 0 erreursseam-gate.mjs verify— 0 échec- Redémarrer le serveur de prévisualisation, vérifier 3-4 battements
- Ne PAS rendre sauf si l'utilisateur le demande
- Porte de présence des sous-titres — échantillonner 3-4 images, confirmer que le rail de sous-titres est visible
Tableau Anti-Rationalisation
| Rationalisation | Réalité |
|---|---|
| "Diapositives à puces pour les changements UI" | Maquetter la surface qui joue le changement |
| "Fausse UI pour les éléments non représentables" | Scène de liste honnête |
| "'JSON' simple dans le texte TTS" | Formes parlées du lexique ; affichage reste standard |
| "Deviner la prononciation" | Demander, puis enrichir le lexique |
| "Parler de chaque élément du changelog" | ≤3 par thème ; le lien de digest prend le reste |
| "Accents verts partout" | Un moment vert par scène |
| "Partir du index.html d'une vidéo précédente" | Copier master-skeleton.html, toujours |
| "Un tableau LINES vide est acceptable" | LINES vide = livraison sans sous-titres = refaire le run |
Vérification
-
hyperframes checkpasse avec 0 erreurs -
seam-gate.mjs verifypasse avec 0 échec - Rail de sous-titres visible sur 3+ images échantillonnées
- Horodatages des mots alignés avec l'audio
- Jetons de marque correspondent à build-spec.md
- Rendu uniquement lorsque l'utilisateur le demande explicitement