product-launch-video - entrada de despacho
Confirme a rota antes do Passo 0. Esta skill cria um vídeo para um produto sendo comercializado / lançado / promovido. Se for na verdade um site geral (não-lançamento) → vídeo (tour / demonstração do site, não vendendo um produto) →
/website-to-video; um tópico / conceito sem produto →/faceless-explainer; um PR do GitHub →/pr-to-video; um vídeo existente para legendar / empacotar →/embedded-captions·/graphic-overlays. Fora do escopo (recuse, não finja): dados ao vivo / em tempo de renderização (todo valor é fixado no momento da autoria), ou filmagens / capturas de tela / um avatar que ainda não existe (HyperFrames não pode gravar ou capturar). Roteado aqui para um "fazer um vídeo" vago, ou não tem certeza entre produto-vs-tópico / lançamento-vs-site-geral? Leia/hyperframesprimeiro.
Todos os artefatos são escritos em PROJECT_DIR = videos/<project-name>/ (criado no Passo 0). Os caminhos abaixo são relativos a PROJECT_DIR. Você (o orquestrador) executa as etapas Bash e despacha os subagentes; os detalhes por fase estão nos guias/agentes/scripts vinculados — não os expanda aqui. O despacho é portátil para a plataforma: antes do primeiro despacho de subagente, leia <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md uma vez — ele mapeia os verbos de despacho (fan-out paralelo / background / wait) para os primitivos da sua plataforma; um limite de concorrência abaixo de N significa ondas com o tamanho do limite, nunca menos cenas. Este arquivo é um runbook vinculante, não uma leitura de fundo: execute as etapas em ordem e produza cada artefato de fase com seu script ou função de agente designada — não substitua por um pipeline improvisado (narração escrita à mão, chamadas TTS ad hoc, uma composição feita manualmente), e não pule uma etapa de pausa porque a solicitação parece clara. Uma etapa que você não pode executar → pare e relate; improvisar além dela quebra todos os contratos posteriores.
| Fase | Execução | Artefato primário | Fluxo detalhado |
|---|---|---|---|
| init | Bash diretamente | hyperframes.json | Passo 0 (este arquivo) |
| capture | Bash diretamente (hyperframes capture) | capture/extracted/tokens.json | phases/capture/guide.md |
| design-system | subagent | design-system/design.html + chunks/ | agents/design-system.md |
| story-design | subagent | narrator_scripts.json | agents/story-design.md |
| audio | Bash diretamente (audio.mjs) | audio_meta.json | phases/audio/guide.md |
| visual-design | subagent | section_plan.md | agents/visual-design.md |
| prep | Bash diretamente (prep.mjs) | group_spec.json | scripts/prep.mjs cabeçalho |
| captions | Bash diretamente (captions.mjs group -> html) | caption_groups.json + compositions/captions.html | scripts/captions.mjs cabeçalho |
| scenes | N x subagent (paralelo, uma cena cada) | compositions/scene_*.html | agents/hyperframes-scene.md |
| finalize | Prelúdio Bash (wait-bgm + assemble + transitions + hoist + sfx-verify) -> subagent finalize | renders/video.mp4 | Passo 7 / agents/hyperframes-finalize.md |
Pré-requisitos (instalar antes do primeiro uso)
macOS Apple Silicon ou Linux x64:
brew install [email protected] node ffmpeg # No Linux, use o equivalente apt/dnf
npx hyperframes doctor # Verificação única de que o Chrome / dependências estão prontos
[email protected]— Python do Homebrew, não o/usr/bin/python3do sistema (PEP 668 bloqueiapip installcaso contrário); usado pelo fallback MusicGennode >= 18+ffmpeg(audio.mjsusaffprobe)- Chrome baixa automaticamente na primeira execução de
npx hyperframes capture.hoist-videos.mjs(Passo 7, executa apenas quando uma cena declara filmagem) reutiliza esse Chrome em cache; se relatar dependências ausentes, executenode <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-depsuma vez (~5s)
Chaves de API opcionais (não definidas -> fallbacks locais; injeção no Passo 0.5; GEMINI_API_KEY ≡ GOOGLE_API_KEY):
| Chave | Usada para | Voz / fallback padrão |
|---|---|---|
HEYGEN_API_KEY (ou hyperframes auth login) | TTS (nuvem, com timestamps no nível da palavra) | voz: auto (primeira voz starfish em inglês; sobrescrever com --voice) |
ELEVENLABS_API_KEY | TTS (nuvem; requer pip install elevenlabs) | voz 21m00Tcm4TlvDq8ikWAM (Rachel) |
| Nenhuma, e não logado | TTS | Kokoro local, voz am_michael (para não-inglês, passe --voice) |
GEMINI_API_KEY (uma chave para ambos os usos) | Legendagem por visão de captura + BGM Lyria | não definido -> legendas usam apenas contexto DOM; BGM usa MusicGen local (primeira execução baixa ~300 MB) |
Fluxo
Passo 0.0 - Confirmar o brief (uma rodada, depois construir)
Antes do Passo 0, em uma mensagem confirme apenas o que molda materialmente o vídeo de lançamento e você não pode inferir — lidere com um padrão recomendado, pule qualquer coisa que o usuário já deu: o ângulo / foco (o produto como um todo, um recurso principal, uma oferta / CTA), duração (padrão ~30-90s; até ~3 min), e — se /hyperframes já não definiu — proporção (padrão 16:9; 9:16 para vertical / social) e idioma. A predefinição é derivada da captura de marca, não perguntada. Para uma solicitação totalmente especificada, pule isto e construa.
Passo 0 - Inicializar o projeto de vídeo
cwd é a raiz do espaço de trabalho do agente; todos os artefatos de vídeo vão para PROJECT_DIR = videos/<project-name>/.
Nomeando <project-name>: um nome de diretório explicitamente dado pelo usuário vence; caso contrário, escolha um nome curto em kebab-case como <marca>-promo (nunca o nome base do espaço de trabalho ou um timestamp). De uma URL, derive do domínio/título da página; o nome é fixo uma vez que capture/ é escrito.
Inicialização (apenas quando $PROJECT_DIR/hyperframes.json não existe):
PROJECT_DIR="${LAUNCH_VIDEO_DIR:-videos/<project-name>}"
mkdir -p "$(dirname "$PROJECT_DIR")"
npx hyperframes init "$PROJECT_DIR" --non-interactive --skip-skills --example=blank
hyperframes initcoloca umAGENTS.md/CLAUDE.mdgenérico em$PROJECT_DIR; deixe-os no lugar, mas não trate suas orientações genéricas como restrições de tempo de execução — esta skill é a fonte da verdade.
Restrições (cada violação quebra as fases posteriores):
- Não execute
hyperframes init(ou gereAGENTS.md/CLAUDE.md) na raiz do espaço de trabalho; não crie um subprojetohyperframes/dentro dePROJECT_DIR. - Cada contexto de despacho de subagente contém uma linha
PROJECT_DIR: <path>; o subagente o trata como a raiz do projeto. - Disciplina de cwd (mestre também): todo comando Bash executa como um subshell
(cd "$PROJECT_DIR" && ...)— nuncacd "$PROJECT_DIR" && ...(deriva persistente de cwd torna caminhos relativos posteriores errados).
Passo 0.5 - Orientação sobre chaves de API
Pule quando $PROJECT_DIR/.env existe ou context.log não está vazio. Caso contrário, detecte o que está configurado (TTS HeyGen = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials; ElevenLabs / Gemini = suas chaves de env), então sempre pause e pergunte — não prossiga por conta própria, mesmo quando uma configuração funcional é detectada:
Detectado: . As chaves de nuvem são opcionais — sem elas, provedores não configurados usam fallbacks locais (TTS -> Kokoro a menos que HeyGen esteja configurado; BGM -> MusicGen). Responda com:
- cole as chaves -> Eu as escreverei em
$PROJECT_DIR/.env- "go" -> prossiga com o que está configurado agora
- "skip" -> prossiga com fallbacks locais para qualquer coisa não configurada
Chaves coladas -> Escreva/Edite $PROJECT_DIR/.env, uma KEY=value por linha (sobrescreva chaves com o mesmo nome, não julgue valores). "go" / "skip" -> Passo 1.
Passo 1 - Capture (Fase 1)
- Resolva
SKILL_DIRe qualquerTARGET_URLexplícita do prompt; garanta que o Passo 0 foi executado. - Leia
$PROJECT_DIR/context.logse existir e use a tabela de Retomar abaixo para pular fases concluídas. - Classifique a entrada (Passo 1.0) para definir
CAPTUREeVO_MODE, então execute o caminho correspondente. Ambos os caminhos compartilham os mesmos comandos posteriores.
Passo 1.0 - Classificar a entrada (definir CAPTURE + VO_MODE)
| Forma da entrada | O que fazer |
|---|---|
| URL explícita no prompt | TARGET_URL = aquela URL; CAPTURE=yes; nenhuma pergunta de voz-over (a narração vem do site capturado). Caminho (A). |
| Usuário colou / apontou para um script ou brief | (1) Salve o texto literal em $PROJECT_DIR/user_script.txt. (2) Faça a pergunta de voz-over uma vez (abaixo) → defina VO_MODE. (3) Resolva um alvo de captura do script (abaixo) → defina CAPTURE. |
| Um tópico / brief sem prosa de script, sem produto | CAPTURE=no; nenhuma pergunta de voz-over. Caminho (B). |
Pergunta de voz-over (apenas quando o usuário forneceu prosa de script real) — pergunte uma linha curta e aguarde:
Devo usar seu script literalmente como voz-over, ou reestruturá-lo em uma narração de cena mais adequada para tela?
- Literalmente — mantenha a redação original; eu apenas divido as cenas e pareio com visuais. A duração segue o script.
- Reestruturar — trate como um brief e reescreva uma narração mais concisa, 1-2 frases por cena.
VO_MODE = verbatim | restructure (padrão restructure); encaminhado para story-design no Passo 2.
Resolver um alvo de captura do script — padrão para encontrar e rastrear um site (tokens reais de marca vencem fallbacks predefinidos); pule apenas quando o usuário optou por não fazer ("sem web / somente texto / sem captura"). Em ordem: (1) URL http(s):// explícita no script → use-a, anuncie, CAPTURE=yes; (2) nome claro de marca/produto → WebSearch para o site oficial, confirme a URL resolvida com o usuário em uma linha antes de rastrear (recuse / nada crível → CAPTURE=no); (3) nada derivável → CAPTURE=no.
Captura + script do usuário coexistem: o rastreamento fornece apenas tokens de marca + ativos + registro visual; a espinha dorsal da narração permanece
user_script.txt(honrado viaVO_MODE), nunca a cópia do próprio site.
(A) Caminho de captura (CAPTURE=yes):
(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)
(B) Caminho sem captura (CAPTURE=no) — sintetize um pacote de captura mínimo; o downstream é idêntico. Você (mestre) escolhe a predefinição (nenhum site para inferir; escolha entre as 19 predefinições por intenção do usuário, ou faça uma pergunta curta). O script/brief completo vai em visible-text.txt; colors:[] aciona o fallback de paleta predefinida (preencha colors apenas se o usuário nomeou cores da marca):
(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marca/título>", "description": "<uma-linha>", "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 completo do usuário>" > capture/extracted/visible-text.txt)
Se o usuário já tem um
narrator_scripts.jsonfinal, coloque-o em$PROJECT_DIR/; a tabela de Retomar pula story-design.
Downstream compartilhado para ambos os caminhos (Caminho B anexa --style <predefinição-escolhida> ao build-design; Caminho A omite para inferência automática):
(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) # Caminho B: anexar --style <predefinição-escolhida>
Validação (pare e relate se algo estiver faltando; se capture/BLOCKED.md existir, o site bloqueou o rastreamento — siga as instruções dentro dele):
[ - …
—
**[truncado para tradução]**