product-launch-video - entrée de dispatch
Confirmez la route avant l'Étape 0. Cette compétence crée une vidéo pour un produit en cours de marketing / lancement / promotion. S'il s'agit vraiment d'un site web général (sans lancement) → vidéo (visite guidée / démonstration du site, pas de vente d'un produit) →
/website-to-video; un sujet / concept sans produit →/faceless-explainer; une Pull Request GitHub →/pr-to-video; une vidéo existante à sous-titrer / conditionner →/embedded-captions·/graphic-overlays. Hors de portée (refuser, ne pas simuler) : données en direct / au moment du rendu (chaque valeur est intégrée au moment de la création), ou séquences / captures d'écran / avatar qui n'existent pas encore (HyperFrames ne peut pas enregistrer ou capturer). Routé ici sur un « créer une vidéo » vague, ou incertain produit-vs-sujet / lancement-vs-site-général ? Lisez/hyperframesd'abord.
Tous les artefacts sont écrits dans PROJECT_DIR = videos/<nom-du-projet>/ (créé à l'Étape 0). Les chemins ci-dessous sont relatifs à PROJECT_DIR. Vous (l'orchestrateur) exécutez les étapes Bash et dispatchiez les sous-agents ; les détails par phase se trouvent dans les guides/agents/scripts liés — ne les développez pas ici. Le dispatch est portable pour le harnais : avant le premier dispatch de sous-agent, lisez <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md une fois — il mappe les verbes de dispatch (fan-out parallèle / arrière-plan / attente) aux primitives de votre harnais ; un plafond de concurrence ci-dessous N signifie des vagues de la taille du plafond, jamais moins de scènes. Ce fichier est un runbook contraignant, pas une lecture de fond : exécutez les étapes dans l'ordre et produisez chaque artefact de phase avec son script ou rôle d'agent désigné — ne remplacez pas par un pipeline improvisé (narration écrite à la main, appels TTS ad-hoc, une composition faite à la main), et ne sautez pas une étape de pause parce que la demande semble claire. Une étape que vous ne pouvez pas exécuter → arrêtez-vous et signalez-le ; improviser au-delà brise chaque contrat en aval.
| Phase | Exécution | Artefact principal | Flux détaillé |
|---|---|---|---|
| init | Bash directement | hyperframes.json | Étape 0 (ce fichier) |
| capture | Bash directement (hyperframes capture) | capture/extracted/tokens.json | phases/capture/guide.md |
| design-system | sous-agent | design-system/design.html + chunks/ | agents/design-system.md |
| story-design | sous-agent | narrator_scripts.json | agents/story-design.md |
| audio | Bash directement (audio.mjs) | audio_meta.json | phases/audio/guide.md |
| visual-design | sous-agent | section_plan.md | agents/visual-design.md |
| prep | Bash directement (prep.mjs) | group_spec.json | scripts/prep.mjs entête |
| captions | Bash directement (captions.mjs group -> html) | caption_groups.json + compositions/captions.html | scripts/captions.mjs entête |
| scenes | N x sous-agent (parallèle, une scène chacun) | compositions/scene_*.html | agents/hyperframes-scene.md |
| finalize | Prélude Bash (wait-bgm + assemble + transitions + hoist + sfx-verify) -> sous-agent de finalisation | renders/video.mp4 | Étape 7 / agents/hyperframes-finalize.md |
Prérequis (installation avant la première exécution)
macOS Apple Silicon ou Linux x64 :
brew install [email protected] node ffmpeg # Sur Linux, utilisez l'équivalent apt/dnf
npx hyperframes doctor # Vérification unique que Chrome / dépendances sont prêtes
[email protected]— Python Homebrew, pas le système/usr/bin/python3(PEP 668 bloquepip installsinon) ; utilisé par le fallback MusicGennode >= 18+ffmpeg(audio.mjsutiliseffprobe)- Chrome se télécharge automatiquement au premier
npx hyperframes capture.hoist-videos.mjs(Étape 7, s'exécute uniquement quand une scène déclare des séquences) réutilise ce Chrome en cache ; s'il signale des dépendances manquantes, exécuteznode <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-depsune fois (~5s)
Clés API optionnelles (non définies -> fallbacks locaux ; injection à l'Étape 0.5 ; GEMINI_API_KEY ≡ GOOGLE_API_KEY) :
| Clé | Utilisée pour | Voix / fallback par défaut |
|---|---|---|
HEYGEN_API_KEY (ou hyperframes auth login) | TTS (cloud, avec horodatage au niveau du mot) | voix : auto (première voix starfish anglaise ; remplacer --voice) |
ELEVENLABS_API_KEY | TTS (cloud ; nécessite pip install elevenlabs) | voix 21m00Tcm4TlvDq8ikWAM (Rachel) |
| Ni l'une ni l'autre, et non connecté | TTS | Kokoro local, voix am_michael (pour non-anglais, passer --voice) |
GEMINI_API_KEY (une clé pour les deux usages) | Légende vision de capture + BGM Lyria | non défini -> les légendes utilisent uniquement le contexte DOM ; BGM utilise MusicGen local (premier téléchargement ~300 Mo) |
Flux
Étape 0.0 - Confirmer le brief (un tour, puis construire)
Avant l'Étape 0, en un message, confirmez uniquement ce qui façonne matériellement la vidéo de lancement et que vous ne pouvez pas déduire — proposez une valeur par défaut recommandée, sautez tout ce que l'utilisateur a déjà donné : l'angle / focus (le produit en général, une fonctionnalité vedette, une offre / CTA), la durée (par défaut ~30-90s ; jusqu'à ~3 min), et — si /hyperframes ne les a pas déjà définis — le format (par défaut 16:9 ; 9:16 pour vertical / réseaux sociaux) et la langue. La préconfiguration est dérivée de la capture de marque, pas demandée. Pour une demande entièrement spécifiée, sautez ceci et construisez.
Étape 0 - Initialiser le projet vidéo
cwd est la racine de l'espace de travail de l'agent ; tous les artefacts vidéo vont dans PROJECT_DIR = videos/<nom-du-projet>/.
Nommer <nom-du-projet> : un nom de répertoire explicitement donné par l'utilisateur l'emporte ; sinon choisissez un nom court en kebab-case comme <marque>-promo (jamais le nom de base de l'espace de travail ou un horodatage). À partir d'une URL, dérivez-le du domaine / titre de la page ; le nom est fixe une fois capture/ écrit.
Initialisation (uniquement quand $PROJECT_DIR/hyperframes.json n'existe pas) :
PROJECT_DIR="${LAUNCH_VIDEO_DIR:-videos/<nom-du-projet>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank
hyperframes initdépose unAGENTS.md/CLAUDE.mdgénérique dans$PROJECT_DIR; laissez-les en place mais ne traitez pas leurs directives génériques comme des contraintes d'exécution — cette compétence est la source de vérité.
Contraintes (chaque violation casse les phases ultérieures) :
- N'exécutez pas
hyperframes init(ou générezAGENTS.md/CLAUDE.md) dans la racine de l'espace de travail ; ne créez pas de sous-projethyperframes/à l'intérieur dePROJECT_DIR. - Chaque contexte de dispatch de sous-agent contient une ligne
PROJECT_DIR: <chemin>; le sous-agent le traite comme la racine du projet. - Discipline cwd (maître aussi) : chaque commande Bash s'exécute dans un sous-shell
(cd "$PROJECT_DIR" && ...)— jamaiscd "$PROJECT_DIR" && ...nu (une dérive persistante de cwd rend les chemins relatifs ultérieurs incorrects).
Étape 0.5 - Orientation clé API
Ignorer quand $PROJECT_DIR/.env existe ou context.log n'est pas vide. Sinon, détectez ce qui est configuré (TTS HeyGen = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials ; ElevenLabs / Gemini = leurs clés d'environnement), puis faites toujours une pause et demandez — ne procédez pas par vous-même, même lorsqu'une configuration fonctionnelle est détectée :
Détecté : <résumé>. Les clés cloud sont optionnelles — sans elles, les fournisseurs non configurés tombent en local (TTS -> Kokoro sauf si HeyGen est configuré ; BGM -> MusicGen). Répondez avec :
- collez les clés -> je les écrirai dans
$PROJECT_DIR/.env- "go" -> procédez avec la configuration actuelle
- "skip" -> procédez avec les fallbacks locaux pour tout ce qui n'est pas configuré
Clés collées -> Écrire/Modifier $PROJECT_DIR/.env, une KEY=valeur par ligne (remplacez les clés de même nom, ne jugez pas les valeurs). "go" / "skip" -> Étape 1.
Étape 1 - Capture (Phase 1)
- Résolvez
SKILL_DIRet touteTARGET_URLexplicite de l'invite ; assurez-vous que l'Étape 0 a été exécutée. - Lisez
$PROJECT_DIR/context.logs'il existe et utilisez le tableau Reprendre ci-dessous pour ignorer les phases terminées. - Classez l'entrée (Étape 1.0) pour définir
CAPTUREetVO_MODE, puis exécutez le chemin correspondant. Les deux chemins partagent les mêmes commandes en aval.
Étape 1.0 - Classer l'entrée (définir CAPTURE + VO_MODE)
| Forme de l'entrée | Que faire |
|---|---|
| URL explicite dans l'invite | TARGET_URL = cette URL ; CAPTURE=yes ; pas de question de voix-off (la narration provient du site capturé). Chemin (A). |
| Utilisateur a collé / pointé vers un script ou brief | (1) Sauvegardez le texte textuel dans $PROJECT_DIR/user_script.txt. (2) Posez la question de voix-off une fois (ci-dessous) → définissez VO_MODE. (3) Résolvez une cible de capture à partir du script (ci-dessous) → définissez CAPTURE. |
| Un sujet / brief sans prose de script, sans produit | CAPTURE=no ; pas de question de voix-off. Chemin (B). |
Question de voix-off (uniquement quand l'utilisateur a fourni une prose de script réelle) — demandez une ligne courte et attendez :
Dois-je utiliser votre script textuellement comme voix-off, ou le restructurer en une narration de scène plus adaptée à l'écran ?
- Textuel — conservez le libellé original ; je divise uniquement les scènes et associe les visuels. La durée suit le script.
- Restructurer — traitez-le comme un brief et réécrivez une narration plus serrée, 1-2 phrases par scène.
VO_MODE = verbatim | restructure (par défaut restructure) ; transmis à story-design à l'Étape 2.
Résoudre une cible de capture à partir du script — par défaut, trouver et crawler un site (les vrais tokens de marque l'emportent sur les fallbacks de préconfiguration) ; ne passez que lorsque l'utilisateur a refusé ("pas de web / texte uniquement / pas de capture"). Dans l'ordre : (1) URL http(s):// explicite dans le script → utilisez-la, annoncez-la, CAPTURE=yes ; (2) nom de marque/produit clair → WebSearch pour le site officiel, confirmez l'URL résolue avec l'utilisateur en une ligne avant de crawler (refus / rien de crédible → CAPTURE=no) ; (3) rien de dérivable → CAPTURE=no.
Capture + script utilisateur coexistent : le crawl fournit uniquement les tokens de marque + actifs + registre visuel ; la colonne vertébrale de la narration reste
user_script.txt(honorée viaVO_MODE), jamais le texte du site lui-même.
(A) Chemin de capture (CAPTURE=yes) :
(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)
(B) Chemin sans capture (CAPTURE=no) — synthétisez un package de capture minimal ; en aval est identique. Vous (maître) choisissez la préconfiguration (aucun site à déduire ; choisissez parmi les 19 préconfigurations selon l'intention de l'utilisateur, ou demandez une question courte). Le script/brief complet va dans visible-text.txt ; colors:[] déclenche le fallback de la palette de préconfiguration (remplissez colors uniquement si l'utilisateur a nommé des couleurs de marque) :
(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marque/titre>", "description": "<une-ligne>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<script / brief utilisateur complet>" > capture/extracted/visible-text.txt)
Si l'utilisateur a déjà un
narrator_scripts.jsonfinal, placez-le dans$PROJECT_DIR/; le tableau Reprendre ignore story-design.
En aval partagé pour les deux chemins (Chemin B ajoute --style <préconfig-choisie> à build-design ; Chemin A l'omet pour l'inférence automatique) :
(cd "$PROJECT_DIR" && node <SKILL_DIR>/scripts/derive-context-pack.mjs --capture ./capture)
(cd "$PROJECT_DIR" && node <SKILL_DIR>/phases/design-system/scripts/build-design.mjs ./design-system --no-emit) # Chemin B : ajouter --style <préconfig-choisie>
Validation (arrêtez-vous et signalez si quelque chose manque ; si capture/BLOCKED.md existe, le site a bloqué le crawl — suivez les instructions à l'intérieur) :
[ -
…
[truncated for translation]