Constructor de Prompts de Video
Despachador genérico y agnóstico al proveedor para prompts de generación de video. Lee la matriz de enrutamiento en .specs/architecture/PROVIDERS.md, decide qué proveedor debe ejecutar la pieza y delega en el especialista correspondiente (higgsfield-prompt-builder, topview-prompt-builder, wavespeed-batch, hyperframes-prompt-builder).
Cuándo invocarlo
- Cualquier paso de generación de video en el pipeline (
brief -> script -> creativecuando el tipo creativo es video). - Cuando una pieza declara
type: videoen.specs/pieces/*.md. - Pruebas A/B de hooks de video entre proveedores y el orquestador necesita un punto de entrada único.
- Re-ejecutar el mismo brief en un proveedor diferente después de seleccionar un ganador de A/B.
- Cuando un agente upstream tiene un brief pero no sabe qué proveedor elegir.
Entradas
brief: objeto. Brief visual con al menossubject,motion,mood,aspect,duration_seconds.task_kind: cadena. Uno decinematic_reel,motion_control,ugc_product_holder,product_demo,talking_head,batch_hook_test,motion_typography,data_viz_reel,programmatic_short.piece_path: cadena, opcional. Ruta al archivo de la pieza. Puede contenerprovider_override.video.dry_run: booleano, opcional. Cuando es verdadero, devuelve el proveedor resuelto y los parámetros sin llamar al MCP.
Proceso
- Leer
.specs/architecture/PROVIDERS.mdy analizar la matriz de Video en un mapatask_kind -> provider. - Si
piece_pathestá establecido y contieneprovider_override.video, usar la sobrescritura. - Si no, buscar
task_kinden la matriz. Si es desconocido, usar el valor predeterminado de la matriz paracinematic_reel. - Verificar que el proveedor elegido tenga las variables de entorno establecidas (
HIGGSFIELD_MCP_ACTIVE,TOPVIEW_API_KEY,WAVESPEED_API_KEY,HYPERFRAMES_ACTIVE). - Mapear proveedor a skill especialista: Higgsfield ->
higgsfield-prompt-builder, Topview ->topview-prompt-builder, Wavespeed ->wavespeed-batch, Hyperframes ->hyperframes-prompt-builder. - Traducir los campos del
briefa la forma de entrada que espera el especialista. - Invocar al especialista y capturar su
paramsy salidamcp_tool. - Si
dry_run, devolver el proveedor resuelto, los parámetros y la herramienta MCP. De lo contrario, llamar al MCP y devolver la referencia del artefacto. - Registrar la ejecución en
data/video-usage.jsonlcon marca de tiempo, proveedor, task_kind y resultado.
Salidas
provider_used: cadena.params: objeto. Objeto de parámetros final listo para la llamada MCP.mcp_tool: cadena. El nombre de la herramienta MCP.artifact_ref: cadena, cuando no está en dry_run. Ruta o URL al video generado.cost_estimate_usd: número.
Ejemplos
Ejemplo 1: reel cinematográfico enrutado a Higgsfield
Entrada: { brief: { subject: "modelo en traje de lino", motion: "travelling", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" }
Salida: { provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }
Ejemplo 2: anuncio UGC enrutado a Topview
Entrada: { brief: { subject: "frasco de cuidado de la piel sostenido por avatar", motion: "estático", mood: "amigable", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" }
Salida: { provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }
Ejemplo 3: reel semanal de KPI enrutado a Hyperframes
Entrada: { brief: { headline: "Semana 21 en números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" }
Salida: { provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — renderizado local mediante los skills hyperframes + hyperframes-cli.
Modos de fallo
- task_kind no está en la matriz: registrar una advertencia y usar el valor predeterminado de cinematic_reel.
- Falta la variable de entorno requerida para el proveedor elegido: pasar al siguiente proveedor en la matriz y mostrar una advertencia.
- El skill especialista devuelve un error: mostrarlo y no reintentar automáticamente en un proveedor diferente a menos que el llamador opte por ello.
- La duración excede el límite del proveedor: recortar al máximo del proveedor y mostrar un aviso.
Skills relacionados
higgsfield-prompt-builder: especialista para Soul, DoP, Seedance.topview-prompt-builder: especialista para UGC y anuncios impulsados por avatar.wavespeed-batch: especialista para pruebas de hook por lotes de bajo costo.hyperframes-prompt-builder: especialista para tipografía animada renderizada en HTML, reels de visualización de datos y cortos programáticos parametrizados.llm-router: despachador separado para generación de texto; mismo patrón, dominio diferente.qa-tech-specs: valida el video final contra las especificaciones de la plataforma.