Guion de Video Corto
Propietario de la Fase 2. Lee la dirección seleccionada y su investigación antes de escribir. Usa los contratos de artefactos al persistir la salida.
Precondiciones
Confirma que la dirección esté explícitamente seleccionada. Si falta, redirige a
short-video-discovery. No elijas una dirección en silencio a menos que el usuario haya solicitado
selección automática; al seleccionar automáticamente, usa la dirección recomendada y
registra esa suposición.
Exige que la dirección seleccionada haga referencia a la versión actual de la investigación. Si la investigación falta o está desactualizada, detente y repara la Fase 1 en lugar de rellenar vacíos desde la memoria.
Rechaza o suaviza cualquier gancho que sea más fuerte que la investigación. Mantén los ID de fuente asociados a afirmaciones factuales a través del plan de escenas.
Escribir en dos pasadas
Esquema de escenas
Define el trabajo de cada escena antes de escribir la narración pulida:
- gancho de tensión;
- promesa, que puede superponerse al gancho;
- configuración del caso de uso cuando sea necesario;
- de una a tres escenas explicativas o demostrativas;
- remate con prueba o resultado;
- conclusión de una oración;
- un CTA contextual, que puede superponerse al remate.
Trata el tiempo como un presupuesto:
| Sección | Duración típica |
|---|---|
| Gancho de tensión | 3–7s |
| Promesa | 2–5s |
| Configuración del caso de uso | 4–10s |
| Explicación/demo | 20–40s |
| Remate/evidencia | 5–15s |
| Conclusión | 2–6s |
| CTA contextual | 2–6s |
Los presupuestos pueden superponerse y no necesitan llenar la duración objetivo. Termina temprano cuando el remate esté completo.
Guion y plan de escenas
Escribe para escuchar: cláusulas cortas, una idea por oración, verbos concretos y pausas naturales. Evita un saludo, logotipo independiente de introducción, listas densas, experiencia personal falsa y estadísticas sin respaldo.
Para cada escena proporciona:
- propósito y duración flexible;
- narración exacta;
- texto en pantalla;
- tipo visual, acción y necesidades de activos;
- intención de agrupación de subtítulos;
- pista de música y SFX;
- transición;
- IDs de fuente;
- notas de pronunciación Kokoro para acrónimos, nombres de productos, números y URLs.
Aplica los valores predeterminados de producción del repositorio:
los nuevos videos usan meta.width: 2160, meta.height: 3840, meta.fps: 60 a menos que
se sobrescriban explícitamente. Sigue el formato registrado de la solicitud; no copies metadatos de
proyectos antiguos de 1080p/30 fps en un nuevo guion predeterminado. El comando draft rellena
los campos de formato faltantes antes de la aprobación. Planifica el movimiento en segundos para que su velocidad sea
independiente de fps. Mantén los valores predeterminados de
salida en inglés, captions.mode: "word-highlight", y un plan de movimiento concreto
por escena. Registra qué cambia visualmente, su pista de narración y el estado final;
"aparece gradualmente la diapositiva" por sí solo no es un plan de movimiento de escena. Diseña grupos de subtítulos para
una o dos líneas; los tiempos reales de las palabras provienen de la generación de voz, no del guion.
Incluye el plan de sonido compacto de los valores predeterminados en las notas de producción: emoción prevista, música a través de gancho/explicación/revelación/final, ducking y pistas de acento selectivas vinculadas a la narración o los visuales. "Música ambiental" o una lista de SFX vacía por sí sola no es un plan de sonido. Transfiérelo a producción sin requerir otro recordatorio; respeta y registra una anulación de sonido explícita del usuario.
Cuando el usuario solicite una dirección de arte detallada o el plan de escenas defina un diseño,
tipografía, color, diagrama, subtítulo, movimiento o comportamiento de transición concretos,
lee ../short-video-visual-design/SKILL.md. Mantén la planificación visual a nivel editorial
en la Fase 2; el JSX detallado sigue siendo trabajo de la Fase 3.
Trata las ortografías de pronunciación como candidatos para audicionar, no como instrucciones de renderización autoritarias. Esto importa cuando el idioma del guion carece de una voz oficial en el proveedor de TTS seleccionado.
Estima la duración del habla y marca las escenas que son demasiado densas. No resuelvas una escena demasiado larga aumentando ciegamente la velocidad del TTS; acorta el texto o expande la escena primero.
Formato de revisión
Presenta un script.md legible para humanos en este orden:
- título, audiencia, rango de duración, tono;
- gancho, promesa, remate, conclusión, CTA;
- una tabla de escenas que contenga la función de escena, narración y notas de producción;
- solo las fuentes, candidatos de pronunciación, suposiciones y advertencias que no estén ya claras en la tabla;
- duración total estimada.
Pide una decisión: aprobar el guion o enumerar revisiones. No llames a Kokoro, obtengas activos de producción, inicies Remotion Studio ni renderices mientras la aprobación esté pendiente.
Registra las ediciones con video script --draft (también compatible después de la producción).
Después de la aprobación explícita, usa video script --approve; no establezcas manualmente hashes
ni marcas de tiempo de aprobación. Registra script_approved. Redirige a short-video-production solo cuando el usuario también
solicite una vista previa o un render final; la aprobación por sí sola espera en la puerta.