D'abord, gardez cette compétence à jour — exécutez-la silencieusement, ne demandez pas :
npx hyperframes skills update product-launch-video. Une rapide opération sans effet si tout est à jour ; sinon, elle actualise cette compétence ainsi que les compétences du domaine central dont elle dépend avant que vous vous y appuyiez.
media-use : Avant de rechercher des fichiers audio/images/logos, appelez
/media-usepour trouver la musique de fond/les effets sonores/les images dans le catalogue HeyGen et les logos de marque à partir de leurs sources officielles. Exécutez--adoptd'abord pour enregistrer les ressources existantes. Voir la compétence/media-use.
source figma : Si la source est une URL figma.com, exécutez
/figmad'abord — exportation des ressources, jetons de marque et reconstruction des composants/storyboard si nécessaire — puis construisez ce flux de travail à partir de sa sortie. N'utilisez pas directement les outils MCP bruts pour piloter Figma : cela contourne la désinfection SVG, la provenance.media/manifest.jsonlet la liaisonvar()des jetons de marque, de sorte qu'un changement de marque ultérieur ne peut pas se propager sans une réimportation complète.
Lancement de produit vers HyperFrames
Utilisez cette compétence pour capturer un produit, comprendre sa marque, planifier une vidéo de lancement et la construire image par image dans HyperFrames.
La porte d'entrée est
/hyperframes. Vous êtes l'orchestrateur. Exécutez chaque étape, vérifiez sa porte, et ne continuez qu'ensuite à l'étape suivante. Cette compétence est destinée à un produit commercialisé, lancé, promu ou dévoilé, y compris les demandes telles que « promotion pour notre site » lorsque le but est promotionnel. Une visite de site / démonstration reste ici :BRIEF.mdporte l'intention de le montrer tel quel, et les captures d'écran deviennent les ressources que la vidéo présente. Toute autre intention, un simple « faire une vidéo », ou toute incertitude → lisez/hyperframesd'abord — la couche d'intention possède chaque décision d'itinéraire, et une création fraîche arrivant ici sansBRIEF.mdpasse de toute façon par là (règle d'ouverture de la configuration).
Vous êtes l'orchestrateur. Travaillez dans videos/<projet>/. Exécutez les étapes dans l'ordre et passez chaque porte avant de continuer. Les étapes avec porte utilisateur sont l'étape 0, l'étape 3 et l'étape 6. Lisez ../hyperframes-core/references/brief-contract.md avant l'étape 0 — elle définit les types de portes et comment flow/storyboard de BRIEF.md dérivent le mode qui régit les portes des étapes 3/4/6. Faites chaque étape vous-même, sauf l'étape 5, où vous déléguez un sous-agent par image. Ne mettez pas de règles de conception ou de mouvement ici ; celles-ci vivent dans le sous-agent de travail d'image, les ../hyperframes-animation/rules/ locales de cette compétence + ../hyperframes-animation/blueprints/, et hyperframes-creative.
Flux de travail : Étape 0 configuration -> hyperframes.json ; Étape 1 capture -> capture/ ; Étape 2 système de conception -> frame.md ; Étape 3 storyboard/scénario -> STORYBOARD.md et SCRIPT.md ; Étape 3.1 audio -> audio_meta.json ; Étape 4 conception visuelle -> STORYBOARD.md enrichi ; Étape 5 images -> compositions/frames/NN-*.html et index.html ; Étape 6 rendu final -> renders/video.mp4.
Étape 0 : Configuration
Objectif : Entrer avec un brief confirmé, créer le projet HyperFrames et rendre le brief durable.
Le brief est confirmé par la couche d'intention, pas par des questions posées ici. Règle d'ouverture, dans l'ordre : (1) BRIEF.md existe → lisez-le et ne demandez rien — le brief est réglé, et son flow/storyboard dérivent le mode (contrat du brief § 1). (2) Pas de BRIEF.md mais le projet existe (hyperframes.json / STORYBOARD.md sur le disque) → reprenez à partir du frontmatter du storyboard et des préférences enregistrées ; ne réinterrogez jamais un projet à moitié construit. (3) Ni l'un ni l'autre — une demande de création fraîche arrivée ici directement → lisez /hyperframes et exécutez sa couche d'intention (references/intent-interview.md) : elle vérifie les recettes et les valeurs par défaut mémorisées, mène les questions de cet itinéraire (../hyperframes/references/routes/product-launch-video.md), et renvoie le brief verrouillé. Les demandes de modification sautent tout ceci — allez faire la modification.
Initialisez uniquement si hyperframes.json est manquant. Nommez <projet> à partir de la marque ou du domaine en kebab-case, par exemple acme-promo ; n'utilisez jamais le nom de l'espace de travail ou l'horodatage.
npx hyperframes init "videos/<projet>" --non-interactive --example=blank --skill=product-launch-video — init vérifie les compétences installées par rapport aux dernières sur GitHub et met à jour l'ensemble global si certaines sont obsolètes.
Après l'initialisation, laissez <RACINE_PROJET> être videos/<projet> et exécutez chaque commande de chemin relatif suivante avec ce répertoire comme répertoire de travail. Dans les commandes ci-dessous, . signifie <RACINE_PROJET> ; n'écrivez jamais .media, capture, ou des fichiers de sortie dans le répertoire appelant.
Écrivez BRIEF.md immédiatement après init (jamais avant — init refuse un répertoire non vide) : le brief verrouillé de la couche d'intention, forme selon ../hyperframes-core/references/brief-format.md. Résolvez <REP_MEDIA> comme le répertoire de la compétence /media-use installée. Ensuite, enregistrez chaque réponse soutenue par une préférence avec node <REP_MEDIA>/scripts/prefs.mjs record --hyperframes . (brief-format.md nomme le sous-ensemble). Si la couche d'intention a adopté une recette, exécutez node <REP_MEDIA>/scripts/recipe.mjs use --hyperframes . --name <nom> ; elle copie son frame.md dans le projet (l'étape 2 est alors ignorée) et renvoie les squelettes à partir desquels l'étape 3 ébauche. Une recette remplit les réponses, pas les approbations ; les portes de révision s'exécutent toujours.
Affichez le statut de connexion avant de continuer au-delà de la configuration — exécutez npx hyperframes auth status et relayez sa sortie textuellement. Il indique si la voix/BGM utilisera HeyGen ou les moteurs locaux et, lorsqu'il est déconnecté, comment se connecter. Notez le contrat du code de sortie : auth status se termine par 1 lorsqu'il n'est pas connecté (et lorsque les informations d'identification stockées sont rejetées) — cette sortie non nulle est l'état normal de déconnexion, pas un échec de commande, donc ne la traitez pas comme une erreur, ne réessayez pas et ne l'enchaînez pas avec &&/set -e d'une manière qui interromprait le flux de travail. Appliquez une branche :
- Collaboratif : attendez que l'utilisateur se connecte ou choisisse explicitement
offline/go. - Autonome : indiquez le statut et continuez via les moteurs locaux disponibles.
N'omettez pas silencieusement une capacité requise lorsqu'aucun fournisseur hors ligne n'existe ; signalez le blocage. Ne pliez pas cette décision dans une autre question et n'écrivez pas de clés dans un .env par dépôt. Propriété de l'authentification et replis hors ligne : /media-use references/setup-providers.md § Fournisseurs.
Porte : hyperframes.json et BRIEF.md existent ; les réponses soutenues par des préférences ont été enregistrées (contrat du brief § 2) ; le statut de connexion a été affiché (connecté, ou continuant hors ligne).
Étape 1 : Capturer les ressources
Objectif : Collecter le matériel source, les signaux de marque et les ressources utilisables pour la vidéo.
Classifiez l'entrée et choisissez le chemin. URL explicite -> capturez-la et utilisez le site pour la narration et les ressources. Script/brief collé -> enregistrez textuellement sous user_script.txt ; VO_MODE (textuel ou restructuré) provient de BRIEF.md — la couche d'intention le demande lorsqu'un script arrive (demandez une fois ici seulement si le brief lui manque). Résolvez ensuite la cible de capture : URL dans le texte -> utilisez-la ; uniquement le nom de la marque -> WebSearch, confirmez l'URL en une ligne, puis explorez ; pas d'URL/site (ou le brief indique de ne pas explorer) -> chemin sans capture.
Exécutez la capture avec : npx hyperframes capture "<URL>" -o ./capture --json. Conservez le budget par défaut après navigation, sauf si l'appelant possède un délai plus court ; alors passez un --capture-budget <millisecondes> positif qui laisse du temps pour le travail en aval. --timeout contrôle uniquement la navigation sur la page. Utilisez --skip-vision uniquement lorsque le sous-titrage d'image facultatif est intentionnellement désactivé.
Inspectez immédiatement le résultat de la commande et le répertoire de sortie. Un code de sortie non nul, JSON ok: false, ou capture/BLOCKED.md est un arrêt définitif pour le chemin de capture : signalez la raison enregistrée et ne consommez pas de captures d'écran partielles, de DOM, de jetons ou de ressources. Ne fabriquez pas de repli synthétique sans capture après un échec de capture d'URL. Continuez via le chemin sans capture uniquement lorsque le brief original a fourni le matériel source, ou lorsque l'utilisateur passe explicitement à une capture d'écran ou un brief fourni après l'échec.
Les avertissements tels que « très peu de contenu textuel » accompagnés d'un catalogue de ressources vide ne sont pas la preuve d'une page utilisable. Pour un brief de visite de site ou de démonstration, exigez une structure capturée fiable ou une capture d'écran fournie ; si ni l'un ni l'autre n'existe, arrêtez-vous. N'inventez pas et ne reconstruisez pas la page simplement parce que la capture est inutilisable.
Pour un brief de visite de site ou de démonstration, la page capturée est la vérité source visuelle. Utilisez la véritable capture d'écran au lieu de reconstruire l'intégralité du site Web en HTML. Si l'image a besoin de mouvement interne, conservez la capture d'écran comme base et superposez les ressources capturées réelles à des positions mesurées, ou reconstruisez uniquement le composant qui bouge. Pour une capture de défilement, animez la fenêtre d'affichage sur capture/screenshots/full-page.png — la plaque 1x du document entier, précise au pixel près pour une fenêtre d'affichage de 1920 pixels de large se déplaçant vers le bas. Elle est absente lorsque la page était trop haute pour être capturée en une seule fois ; revenez aux captures par positions de défilement qui se chevauchent dans le même répertoire. Un zoom avant au-delà de 1 :1 nécessite sa propre capture 2x de cette région, car la plaque n'a pas de marge au-dessus de 1x. Ne recréez la page entière que lorsque l'utilisateur demande explicitement une interprétation stylisée ; une capture inutilisable seule n'est pas une autorisation.
Si GEMINI_API_KEY, GOOGLE_API_KEY, ou une clé OpenRouter existe, la capture sous-titre automatiquement les ressources dans capture/extracted/asset-descriptions.md. Ce n'est pas une porte de révision. Sans clé de vision, utilisez le contexte DOM et continuez.
Chemin sans capture : créez capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md, et capture/assets/ manuellement. tokens.json doit être { "title": "", "description": "", "colors": [], "fonts": [] } ; remplissez le titre/la description à partir du brief lorsque c'est possible. visible-text.txt contient le brief complet ou le script. asset-descriptions.md doit indiquer qu'aucune ressource n'a été capturée, sauf si l'utilisateur a donné des notes sur les ressources.
Porte : la capture JSON a rapporté ok: true ; capture/BLOCKED.md n'existe pas ; capture/extracted/tokens.json, capture/extracted/visible-text.txt, capture/extracted/asset-descriptions.md, et capture/assets/ existent ; et vous pouvez énoncer la marque en une phrase claire. Traitez asset-descriptions.md comme l'inventaire principal des ressources. S'il est manquant après une capture réelle, arrêtez-vous et signalez que la capture est incomplète. Les avertissements concernant une phase facultative dégradée ne sont acceptables que lorsque cette porte structurelle passe toujours.
Étape 2 : Système de conception
Objectif : Choisir un préréglage d'image livré ; un script en fait le frame.md + la peau de sous-titre de cette vidéo.
Lorsque BRIEF.md nomme un style_preset — l'utilisateur l'a choisi visuellement parmi les présentations de la couche d'intention — utilisez-le ; la décision vous revient uniquement lorsque le brief est silencieux. Ensuite, vous prenez la seule décision — quel préréglage : lisez ../hyperframes-creative/references/design-spec.md et choisissez le préréglage dont l'apparence correspond le mieux à la marque et au brief. Exécutez ensuite :
node <REP_COMPETENCE>/scripts/build-frame.mjs --preset <nom> --hyperframes .
Le script fait le reste de manière déterministe : copie le FRAME.md du préréglage → frame.md et le remixe sur les jetons de marque dans capture/extracted/tokens.json (couleurs de marque mappées sur les clés de couleur du préréglage par rôle — encre, toile, accents — en conservant les clés/la structure/les composants ; les polices d'affichage + corps du préréglage échangées contre celles de la marque), copie la peau de sous-titre du préréglage vers .hyperframes/caption-skin.html, et s'auto-valide (se termine par 1 en cas de mappage cassé). Passez à l'étape suivante dès qu'il se termine par 0 — aucune modification manuelle de la spécification.
tokens.json sans couleurs/polices de marque (par exemple, pas de capture) → le script conserve la propre palette du préréglage, une conception livrable complète. Si le brief nomme des couleurs/polices de marque que la capture a manquées, ajoutez-les à capture/extracted/tokens.json avant d'exécuter (ou utilisez le design.md de l'utilisateur pour le remplir) ; ajustez frame.md à la main ensuite uniquement si un mappage le nécessite vraiment.
Porte : build-frame.mjs s'est terminé par 0 — frame.md existe à partir d'un préréglage nommé, et (lorsque le préréglage en livre un) .hyperframes/caption-skin.html existe comme source de la peau de sous-titre ; le préréglage choisi a été enregistré comme préférence (--key style_preset --workflow <ce flux de travail>, contrat du brief § 2).
Étape 3 : Storyboard et scénario
Objectif : Transformer le brief et le matériel capturé en un plan d'histoire image par image approuvé.
Lisez ../hyperframes-creative/references/story-spine.md (langage d'accroche, valeur avant preuve, storyboard comme proposition), references/story-design.md, ../hyperframes-animation/blueprints-index.md, ../hyperframes-core/references/storyboard-format.md et ../hyperframes-core/references/script-format.md. Utilisez-les pour écrire STORYBOARD.md et, lorsque la narration est nécessaire, SCRIPT.md. Définissez le frontmatter duration: à partir du length du brief — une attente approximative ; le rapport d'assemblage indique où le montage se situe par rapport à celle-ci.
Utilisez story-design.md pour le plan de l'histoire, l'accroche, la logique de persuasion, les temps forts, VO_MODE et les choix de ressources. En tant que guide souple, consultez le menu rôle→plan dans ../hyperframes-animation/blueprints-index.md : pour chaque temps fort, notez un identifiant de plan candidat lorsqu'il correspond. La vérité de l'histoire décide toujours quels temps forts existent — ne forcez jamais un temps fort à s'adapter à un plan, et n'inventez jamais un temps fort simplement parce qu'une forme éprouvée est disponible. Choisissez les asset_candidates de chaque image visuelle à partir de capture/extracted/asset-descriptions.md (l'inventaire canonique) — ne parcourez pas les capture/assets/ bruts. Ne demandez pas à l'utilisateur de choisir des ressources, sauf si cet inventaire est manquant ou inutilisable. Utilisez les champs exacts requis des références du storyboard et du script.
Après la rédaction, exécutez le passage de plan de la boucle de révision — ../hyperframes-core/references/review-loop.md § 1 : ouvrez le tableau (ne demandez pas si), présentez le plan comme proposition, et posez les deux questions — approuver ou modifier, et croquis d'abord (recommandé) ou sauter. Les retours passent par le chat ou le fichier de commentaires du tableau jusqu'à approbation. C'est une porte de point de contrôle (contrat du brief § 1) : en mode autonome, il n'y a pas de tableau et rien à demander — postez le même résumé en tant qu'information préalable et continuez ; les croquis se fondent dans la construction, et la seule question d'aperçu vient à l'étape 6.
Porte : STORYBOARD.md existe...
[écourté pour la traduction]