product-launch-video - entrada de envío
Confirma la ruta antes del Paso 0. Esta habilidad crea un video para un producto que se está comercializando / lanzando / promocionando. Si es realmente un sitio web general (sin lanzamiento) → video (recorrido / demostración del sitio, no venta de un producto) →
/website-to-video; un tema / concepto sin producto →/faceless-explainer; un PR de GitHub →/pr-to-video; un video existente para subtitular / empaquetar →/embedded-captions·/graphic-overlays. Fuera del alcance (rechazar, no fingir): datos en vivo / en tiempo de renderizado (todos los valores se hornean en el momento de la autoría), o imágenes / capturas de pantalla / un avatar que aún no existe (HyperFrames no puede grabar ni capturar). Enrutado aquí por un vago "hacer un video", o si no estás seguro de si es producto vs. tema / lanzamiento vs. sitio general? Lee primero/hyperframes.
Todos los artefactos se escriben en PROJECT_DIR = videos/<project-name>/ (creado en el Paso 0). Las rutas a continuación son relativas a PROJECT_DIR. Tú (el orquestador) ejecutas los pasos de Bash y envías los subagentes; los detalles por fase viven en las guías/agentes/scripts vinculados — no los expandas aquí. El envío es portátil para el arnés: antes del primer envío de subagente, lee <SKILL_DIR>/../hyperframes-core/references/subagent-dispatch.md una vez — asigna los verbos de envío (fan-out paralelo / fondo / espera) a las primitivas de tu arnés; un límite de concurrencia por debajo de N significa ondas del tamaño del límite, nunca menos escenas. Este archivo es un runbook vinculante, no una lectura de fondo: ejecuta los pasos en orden y produce cada artefacto de fase con su script o rol de agente designado — no sustituyas un pipeline improvisado (narración escrita a mano, llamadas TTS ad hoc, una composición hecha a mano), y no te saltes un paso de pausa porque la solicitud parezca clara. Un paso que no puedas realizar → detente e informa; improvisar más allá rompe todos los contratos posteriores.
| Fase | Ejecución | Artefacto principal | Flujo detallado |
|---|---|---|---|
| init | Bash directamente | hyperframes.json | Paso 0 (este archivo) |
| captura | Bash directamente (hyperframes capture) | capture/extracted/tokens.json | phases/capture/guide.md |
| sistema-diseño | subagente | design-system/design.html + chunks/ | agents/design-system.md |
| diseño-historia | subagente | narrator_scripts.json | agents/story-design.md |
| audio | Bash directamente (audio.mjs) | audio_meta.json | phases/audio/guide.md |
| diseño-visual | subagente | section_plan.md | agents/visual-design.md |
| prep | Bash directamente (prep.mjs) | group_spec.json | Encabezado de scripts/prep.mjs |
| subtítulos | Bash directamente (captions.mjs group -> html) | caption_groups.json + compositions/captions.html | Encabezado de scripts/captions.mjs |
| escenas | N x subagente (paralelo, una escena cada uno) | compositions/scene_*.html | agents/hyperframes-scene.md |
| finalizar | Preludio Bash (esperar-bgm + ensamblar + transiciones + izar + verificar-sfx) -> subagente finalizar | renders/video.mp4 | Paso 7 / agents/hyperframes-finalize.md |
Requisitos previos (instalar antes de la primera ejecución)
macOS Apple Silicon o Linux x64:
brew install [email protected] node ffmpeg # En Linux, usa el equivalente apt/dnf
npx hyperframes doctor # Verificación única de que Chrome / dependencias están listas
[email protected]— Python de Homebrew, no el/usr/bin/python3del sistema (de lo contrario, PEP 668 bloqueapip install); usado por el fallback de MusicGennode >= 18+ffmpeg(audio.mjsusaffprobe)- Chrome se descarga automáticamente en la primera ejecución de
npx hyperframes capture.hoist-videos.mjs(Paso 7, se ejecuta solo cuando una escena declara metraje) reutiliza ese Chrome en caché; si informa que faltan dependencias, ejecutanode <SKILL_DIR>/scripts/hoist-videos.mjs --ensure-depsuna vez (~5s)
Claves API opcionales (no configuradas -> fallbacks locales; inyección en el Paso 0.5; GEMINI_API_KEY ≡ GOOGLE_API_KEY):
| Clave | Usada para | Voz / fallback predeterminado |
|---|---|---|
HEYGEN_API_KEY (o hyperframes auth login) | TTS (nube, con marcas de tiempo a nivel de palabra) | voz: auto (primera voz starfish en inglés; anular con --voice) |
ELEVENLABS_API_KEY | TTS (nube; requiere pip install elevenlabs) | voz 21m00Tcm4TlvDq8ikWAM (Rachel) |
| Ninguna, y no ha iniciado sesión | TTS | Kokoro local, voz am_michael (para no inglés, pasa --voice) |
GEMINI_API_KEY (una clave para ambos usos) | Subtítulos de visión de captura + BGM de Lyria | no configurada -> los subtítulos usan solo el contexto DOM; BGM usa MusicGen local (la primera ejecución descarga ~300 MB) |
Flujo
Paso 0.0 - Confirmar el resumen (una ronda, luego construir)
Antes del Paso 0, en un mensaje, confirma solo lo que dé forma material al video de lanzamiento y no puedas inferir: comienza con un valor predeterminado recomendado, omite cualquier cosa que el usuario ya haya dado: el enfoque / ángulo (el producto en general, una función destacada, una oferta / CTA), la duración (predeterminada ~30-90s; hasta ~3 min), y — si /hyperframes no los estableció ya — la relación de aspecto (predeterminada 16:9; 9:16 para vertical / redes sociales) y el idioma. El ajuste preestablecido se deriva de la captura de marca, no se pregunta. Para una solicitud completamente especificada, omite esto y construye.
Paso 0 - Inicializar el proyecto de video
cwd es la raíz del espacio de trabajo del agente; todos los artefactos de video van en PROJECT_DIR = videos/<project-name>/.
Nombrar <project-name>: gana un nombre de directorio explícito dado por el usuario; de lo contrario, elige un nombre corto en kebab-case como <marca>-promo (nunca el nombre base del espacio de trabajo o una marca de tiempo). De una URL, derívalo del dominio/título de la página; el nombre se fija una vez que se escribe capture/.
Inicialización (solo cuando $PROJECT_DIR/hyperframes.json no 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 unAGENTS.md/CLAUDE.mdgenérico en$PROJECT_DIR; déjalos en su lugar pero no trates su guía genérica como restricciones en tiempo de ejecución — esta habilidad es la fuente de verdad.
Restricciones (cada violación rompe fases posteriores):
- No ejecutes
hyperframes init(ni generesAGENTS.md/CLAUDE.md) en la raíz del espacio de trabajo; no crees un subproyectohyperframes/dentro dePROJECT_DIR. - Cada contexto de envío de subagente contiene una línea
PROJECT_DIR: <ruta>; el subagente lo trata como la raíz del proyecto. - Disciplina de cwd (maestro también): cada comando de Bash se ejecuta como un subshell
(cd "$PROJECT_DIR" && ...)— nuncacd "$PROJECT_DIR" && ...desnudo (la deriva persistente de cwd hace que las rutas relativas posteriores sean incorrectas).
Paso 0.5 - Guía de clave API
Omitir cuando $PROJECT_DIR/.env existe o context.log no está vacío. De lo contrario, detecta lo que está configurado (TTS de HeyGen = $HEYGEN_API_KEY / $HYPERFRAMES_API_KEY / ~/.heygen/credentials; ElevenLabs / Gemini = sus claves de entorno), luego siempre haz una pausa y pregunta — no continúes por tu cuenta, incluso cuando se detecte una configuración funcional:
Detectado: . Las claves en la nube son opcionales — sin ellas, los proveedores no configurados recurren a opciones locales (TTS -> Kokoro a menos que HeyGen esté configurado; BGM -> MusicGen). Responde con:
- pega las claves -> las escribiré en
$PROJECT_DIR/.env- "adelante" -> continúa con lo que esté configurado ahora
- "saltar" -> continúa con fallbacks locales para cualquier cosa no configurada
Claves pegadas -> Escribe/Edita $PROJECT_DIR/.env, una CLAVE=valor por línea (sobrescribe las claves con el mismo nombre, no juzgues los valores). "adelante" / "saltar" -> Paso 1.
Paso 1 - Captura (Fase 1)
- Resuelve
SKILL_DIRy cualquierTARGET_URLexplícito del mensaje; asegúrate de que se haya ejecutado el Paso 0. - Lee
$PROJECT_DIR/context.logsi existe y usa la tabla de Reanudar a continuación para saltar las fases completadas. - Clasifica la entrada (Paso 1.0) para establecer
CAPTUREyVO_MODE, luego ejecuta la ruta coincidente. Ambas rutas comparten los mismos comandos posteriores.
Paso 1.0 - Clasificar la entrada (establecer CAPTURE + VO_MODE)
| Forma de entrada | Qué hacer |
|---|---|
| URL explícita en el mensaje | TARGET_URL = esa URL; CAPTURE=yes; sin pregunta de voz en off (la narración proviene del sitio capturado). Ruta (A). |
| El usuario pegó / señaló un guion o resumen | (1) Guarda el texto textual en $PROJECT_DIR/user_script.txt. (2) Haz la pregunta de voz en off una vez (abajo) → establece VO_MODE. (3) Resuelve un objetivo de captura desde el guion (abajo) → establece CAPTURE. |
| Un tema / resumen sin prosa de guion, sin producto | CAPTURE=no; sin pregunta de voz en off. Ruta (B). |
Pregunta de voz en off (solo cuando el usuario proporcionó prosa de guion real) — haz una línea corta y espera:
¿Debo usar tu guion textualmente como voz en off, o reestructurarlo en una narración de escena más adecuada para la pantalla?
- Textual — mantén la redacción original; solo divido escenas y emparejo imágenes. La duración sigue el guion.
- Reestructurar — trátalo como un resumen y reescribe una narración más ajustada, 1-2 oraciones por escena.
VO_MODE = textual | reestructurar (predeterminado reestructurar); se pasa al diseño de historia en el Paso 2.
Resolver un objetivo de captura desde el guion — por defecto, buscar y rastrear un sitio (los tokens de marca reales ganan a los fallbacks preestablecidos); saltar solo cuando el usuario optó por no hacerlo ("sin web / solo texto / sin captura"). En orden: (1) http(s):// URL explícita en el guion → úsala, anuncia, CAPTURE=yes; (2) nombre de marca/producto claro → WebSearch para el sitio oficial, confirma la URL resuelta con el usuario en una línea antes de rastrear (rechazar / nada creíble → CAPTURE=no); (3) nada derivable → CAPTURE=no.
Captura + guion de usuario coexisten: el rastreo proporciona solo tokens de marca + activos + registro visual; la columna vertebral de la narración sigue siendo
user_script.txt(honrado a través deVO_MODE), nunca la copia del propio sitio.
(A) Ruta de captura (CAPTURE=yes) :
(cd "$PROJECT_DIR" && npx hyperframes capture "<TARGET_URL>" -o ./capture)
(B) Ruta sin captura (CAPTURE=no) — sintetiza un paquete de captura mínimo; el flujo posterior es idéntico. Tú (el maestro) eliges el ajuste preestablecido (sin sitio del que inferir; elige entre los 19 ajustes preestablecidos según la intención del usuario, o haz una pregunta corta). El guion/resumen completo va en visible-text.txt; colors:[] activa el fallback de paleta preestablecida (llena colors solo si el usuario nombró colores de marca):
(cd "$PROJECT_DIR" && mkdir -p capture/extracted capture/assets)
(cd "$PROJECT_DIR" && cat > capture/extracted/tokens.json <<'JSON'
{ "title": "<marca/título>", "description": "<una línea>", "colors": [], "fonts": [], "headings": [], "sections": [], "ctas": [], "svgs": [], "cssVariables": {} }
JSON
)
(cd "$PROJECT_DIR" && echo '{}' > capture/extracted/design-styles.json)
(cd "$PROJECT_DIR" && printf '%s\n' "<guion completo del usuario / resumen>" > capture/extracted/visible-text.txt)
Si el usuario ya tiene un
narrator_scripts.jsonfinal, colócalo en$PROJECT_DIR/; la tabla de Reanudar salta el diseño de historia.
Flujo posterior compartido para ambas rutas (la Ruta B agrega --style <ajuste-preestablecido-elegido> a build-design; la Ruta A lo omite para inferencia 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) # Ruta B: agregar --style <ajuste-preestablecido-elegido>
Validación (detener e informar si falta algo; si capture/BLOCKED.md existe, el sitio bloqueó el rastreo — sigue las instrucciones dentro):
[ -