Visión general
Esta skill convierte un changelog de lanzamiento en una composición de video pulida usando el renderizado HTML de HyperFrames. Úsala cuando una actualización de producto merezca un anuncio visual: fotogramas destacados, viñetas clave y un patrón de fondo. Produce un MP4 renderizado a partir de las entradas del changelog que le proporciones.
HyperFrames — Video de Changelog
Entrada: un changelog en .md (temas + elementos). Salida: un proyecto HyperFrames limpio y con el sello 'seam-gate-green'. Renderiza solo cuando se te pida.
Cuándo Usarla
- El usuario proporciona un changelog/resumen markdown y quiere el video semanal
- El usuario dice "video de changelog" o "video del resumen semanal"
- El usuario quiere un video con marca que incluya interfaces de usuario animadas y locución
Cuándo NO Usarla
- El usuario quiere un lanzamiento de producto (usa
hyperframes-product-launch-video) - El usuario quiere un gráfico en movimiento (usa
hyperframes-motion-graphics) - El usuario quiere un video de una persona hablando (usa
hyperframes-embedded-captions)
La Directriz Principal: Visualizar, No Listar
Cada tema se ilustra mediante una interfaz de usuario animada que representa el cambio real o un análogo fiel, actuando la evolución de la experiencia — nunca con viñetas de texto. Enruta cada tema/elemento a través del registro de visualizaciones ANTES de escribir el guion.
Flujo de Trabajo
0 · Inicializar desde los assets de la skill (no negociable)
mkdir -p project/assets/fonts
cp <SKILL_DIR>/assets/fonts/*.woff2 project/assets/fonts/
cp <SKILL_DIR>/assets/bgm.mp3 project/bgm.mp3
ffmpeg -y -stream_loop 15 -i <SKILL_DIR>/assets/bg-pattern.mp4 -t <TOTAL> \
-vf "scale=1080:1080,fps=30,eq=saturation=0.72,[email protected]:t=fill" \
-an -c:v libx264 -crf 20 -pix_fmt yuv420p project/assets/bg-pattern-<TOTAL>s.mp4
cp <SKILL_DIR>/examples/master-skeleton.html project/index.html
Luego, lee references/build-spec.md de principio a fin: allí se definen los tokens de marca.
1 · Análisis + corte editorial
- Extrae: rango de semana, estadísticas destacadas, temas, elementos
- Presupuesto: 45-60s en total. Título ≤2s, cierre ≤3.5s, 4 temas ≈ 9-12s cada uno
- Por tema, mantén UNA visualización destacada + como máximo 3 elementos narrados
- Ordena los temas por historia: función estrella -> superficie del producto -> rendimiento -> fiabilidad
2 · Enrutamiento de visualizaciones
Para cada tema, elige la superficie del registro de visualizaciones y escribe una línea: tema → superficie → las 2-4 acciones secuenciadas que realizará la maqueta, cada una vinculada a una frase del guion.
3 · Guion de dos capas (hablado vs mostrado)
Escribe el guion como líneas de tokens: registro conversacional, cada término técnico lleva una forma fonética spoken mientras que display mantiene la ortografía estándar. Los subtítulos muestran display; la locución lee spoken.
4 · Locución + marcas de tiempo de palabras
node scripts/heygen-tts.mjs ./vo-spoken.txt -o voiceover.mp3 --words vo-words.json --voice <voice_id>
node scripts/align-captions.mjs --tokens script-tokens.json --words vo-words.json --out captions.json
Las marcas de tiempo por palabra son un punto de control obligatorio. Antes de continuar, verifica que vo-words.json no esté vacío y contenga un array words: [...] con start/end por cada palabra.
5 · Construcción
Sigue exactamente references/build-spec.md: tokens de marca + fuentes + codificación del fondo animado + esqueleto de escena + interfaz de usuario + barra de subtítulos. Luego, el orden de la doctrina: vector ledger → seam-stamp → pulsos internos sobre las palabras de la locución → verificación seam-gate.
Los subtítulos no son opcionales. Llena el array LINES desde captions.json antes de continuar.
6 · Verificaciones (todas en verde antes de presentar)
hyperframes check— 0 erroresseam-gate.mjs verify— 0 fallos- Reinicia el servidor de previsualización, comprueba 3-4 momentos clave
- NO renderices a menos que el usuario lo pida
- Verificación de presencia de subtítulos — muestrea 3-4 fotogramas, confirma que la barra de subtítulos sea visible
Tabla Antirracionalización
| Racionalización | Realidad |
|---|---|
| "Diapositivas con viñetas para cambios en la IU" | Simula la superficie actuando el cambio |
| "IU falsa para elementos no representables" | Escena de lista honesta |
| "'JSON' simple en el texto de TTS" | Formas fonéticas del léxico; la visualización mantiene la ortografía estándar |
| "Adivinar la pronunciación" | Pregunta, luego amplía el léxico |
| "Narrar cada elemento del changelog" | ≤3 por tema; el enlace al resumen lleva el resto |
| "Acentos verdes por todas partes" | Un momento verde por escena |
| "Empezar desde el index.html de un video anterior" | Copia master-skeleton.html, siempre |
| "Un array LINES vacío está bien" | LINES vacío = video sin subtítulos = repetir la ejecución |
Verificación
-
hyperframes checkpasa con 0 errores -
seam-gate.mjs verifypasa con 0 fallos - Barra de subtítulos visible en 3+ fotogramas muestreados
- Las marcas de tiempo de palabras se alinean con el audio
- Los tokens de marca coinciden con build-spec.md
- Solo se renderiza cuando el usuario lo solicita explícitamente