Construtor de Prompt de Vídeo
Despachante genérico e independente de provedor para prompts de geração de vídeo. Lê a matriz de roteamento em .specs/architecture/PROVIDERS.md, decide qual provedor deve executar a peça e delega para o especialista correto (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).
Quando Invocar
- Qualquer etapa de geração de vídeo no pipeline (
brief -> script -> creativequando o tipo criativo é vídeo). - Quando uma peça declara
type: videoem.specs/pieces/*.md. - Testes A/B de hooks de vídeo entre provedores e o orquestrador precisa de um único ponto de entrada.
- Reexecução do mesmo brief em um provedor diferente após um vencedor de A/B ser escolhido.
- Quando um agente upstream tem um brief mas não sabe qual provedor escolher.
Entradas
brief: objeto. Brief visual com pelo menossubject,motion,mood,aspect,duration_seconds.task_kind: string. Um decinematic_reel,motion_control,ugc_product_holder,product_demo,talking_head,batch_hook_test,motion_typography,data_viz_reel,programmatic_short.piece_path: string, opcional. Caminho para o arquivo da peça. Pode conterprovider_override.video.dry_run: boolean, opcional. Quando verdadeiro, retorna o provedor resolvido e os parâmetros sem chamar o MCP.
Processo
- Ler
.specs/architecture/PROVIDERS.mde analisar a matriz de Vídeo em um mapa detask_kind -> provider. - Se
piece_pathestiver definido e contiverprovider_override.video, usar a substituição. - Caso contrário, procurar
task_kindna matriz. Se desconhecido, usar o padrão da matriz paracinematic_reel. - Verificar se o provedor escolhido possui as variáveis de ambiente definidas (
HIGGSFIELD_MCP_ACTIVE,TOPVIEW_API_KEY,WAVESPEED_API_KEY,HYPERFRAMES_ACTIVE). - Mapear provedor para skill especialista: Higgsfield ->
higgsfield-prompt-builder, Topview ->topview-prompt-builder, Wavespeed ->wavespeed-batch, Hyperframes ->hyperframes-prompt-builder. - Traduzir os campos do
briefpara a forma de entrada que o especialista espera. - Invocar o especialista e capturar sua saída
paramsemcp_tool. - Se
dry_run, retornar o provedor resolvido, os params e a ferramenta MCP. Caso contrário, chamar o MCP e retornar a referência do artefato. - Registrar a execução em
data/video-usage.jsonlcom timestamp, provedor, task_kind e resultado.
Saídas
provider_used: string.params: objeto. Objeto de parâmetros final pronto para a chamada MCP.mcp_tool: string. O nome da ferramenta MCP.artifact_ref: string, quando não estiver em dry_run. Caminho ou URL para o vídeo gerado.cost_estimate_usd: número.
Exemplos
Exemplo 1: reel cinematográfico roteado para Higgsfield
Entrada: { brief: { subject: "modelo em terno de linho", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
Saída: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
Exemplo 2: anúncio UGC roteado para Topview
Entrada: { brief: { subject: "frasco de skincare segurado por avatar", motion: "estático", mood: "amigável", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
Saída: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
Exemplo 3: reel semanal de KPI roteado para Hyperframes
Entrada: { brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
Saída: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — renderização local via as skills hyperframes + hyperframes-cli.
Modos de Falha
- task_kind não está na matriz: registrar um aviso e usar o padrão cinematic_reel.
- Variável de ambiente necessária ausente para o provedor escolhido: cair para o próximo provedor na matriz e exibir um aviso.
- Skill especialista retorna um erro: exibi-lo e não repetir automaticamente em um provedor diferente, a menos que o chamador opte por isso.
- Duração excede o limite do provedor: truncar para o máximo do provedor e exibir um aviso.
Skills Relacionadas
higgsfield-prompt-builder: especialista para Soul, DoP, Seedance.topview-prompt-builder: especialista para anúncios UGC e baseados em avatar.wavespeed-batch: especialista para testes de hook em lote de baixo custo.hyperframes-prompt-builder: especialista para tipografia animada renderizada em HTML, reels de visualização de dados e curtas programáticos parametrizados.llm-router: despachante separado para geração de texto; mesmo padrão, domínio diferente.qa-tech-specs: valida o vídeo final contra a especificação da plataforma.