¿Qué hace Web Video Presentation?
Convierte un artículo o guion en una presentación web de 16:9 que parece un video, con síntesis de voz opcional. El resultado es un proyecto Vite + React + TS con archivos de audio separados por capítulo.
Escenarios de uso
- "Tengo un guion de locución o un artículo, conviértelo en un video": contenido impulsado por locución.
- Crear "PPT dinámico".
- Grabación de pantalla en 16:9 horizontal, con letras grandes, espacios en blanco y animaciones en cada pantalla.
- Contenido educativo / demostraciones de productos / keynote con estilo cinematográfico.
- Contenido para Bilibili / YouTube / TikTok.
Este skill se centra en la metodología y el flujo de trabajo colaborativo. La plantilla base proporciona tokens y primitivas, pero cada decisión estética (paleta de colores, tipografía, estilo de animación) debe rediseñarse para tu tema específico, no copiarse.
Resumen del flujo de trabajo
Fase 1 Redacción de contenido
1.1 Identificar la entrada del usuario
1.2 Generar script.md + outline.md (guion de locución + plan de desarrollo)
▼
[Checkpoint Plan] ← Obligatorio. Alinear 5 aspectos:
Guion / Esquema / Tema / Materiales / Modo de desarrollo
▼
Fase 2 Desarrollo web
2.1 Scaffolding (según tema seleccionado)
2.2 Capítulo 1 = Hilo principal + versión completa (ancla obligatoria)
▼
[Nodo duro] Revisión del usuario del Capítulo 1 ← No se puede saltar
▼
2.3 Capítulos 2~N (según modo seleccionado: A Capítulo por capítulo / B Secuencial / C Paralelo)
▼
[Checkpoint Audio] ← Obligatorio. ¿Sintetizar audio?
▼
Fase 3 Síntesis de audio (opcional)
▼
Fase 4 Grabación de pantalla + Postproducción
Convenciones del directorio de trabajo (el agente crea/edita en el directorio actual del usuario):
my-video/
├── article.md # Obligatorio si el usuario proporciona el original. ¡No borrar! Fuente de información visual en la fase de desarrollo.
├── script.md # Obligatorio: Guion de locución adaptado a la plataforma, conservando el idioma original (determina los tiempos).
├── outline.md # Obligatorio: Plan de desarrollo (división en capítulos + contenido de cada paso + pool de información).
└── presentation/ # Proyecto Vite + React + TS generado por scaffolding.
├── src/chapters/<NN>-<id>/
│ ├── <Chapter>.tsx # Implementación visual.
│ ├── <Chapter>.css
│ └── narrations.ts # ★ Fuente única de verdad para el número de pasos y el texto de la locución.
├── scripts/
│ ├── extract-narrations.ts # Escanea todos los narrations.ts → audio-segments.json.
│ ├── synthesize-audio.sh # Ejecutor agnóstico al proveedor (itera sobre los segmentos).
│ └── tts-providers/ # Un archivo .sh por proveedor (2 incluidos).
│ ├── README.md # Contrato de 3 funciones + 5 fragmentos de código listos (11labs / edge-tts / say / azure / gcloud).
│ ├── minimax.sh # Proveedor por defecto, usa mmx-cli.
│ └── openai.sh # OpenAI TTS incluido (curl + OPENAI_API_KEY).
├── audio-segments.json # Salida del extract (revisar antes de sintetizar).
└── public/audio/<id>/<N>.mp3 # Opcional: archivos de audio sintetizados.
Clave:
narrations.tses la única fuente de verdad para el número de pasos y la síntesis de audio. El número máximo N + 1 que aparece enif (step === N)dentro del.tsxdel capítulo debe ser igual anarrations.length. Esto garantiza que 5 lugares (script / outline / código del capítulo / chapters.ts / archivos de audio) nunca divergan.
Protocolo de autoverificación obligatorio (aplica a todo el skill)
Los tres entregables siguientes, después de completarse, deben pasar por autoinspección → reparación → informe/paso siguiente:
| Entregable | Origen de la lista de verificación |
|---|---|
script.md | SCRIPT-STYLE.md Autoverificación de tres niveles (forma / esencia / lectura en voz alta) |
outline.md | OUTLINE-FORMAT.md Autoverificación |
| Implementación de un capítulo completo | CHAPTER-CRAFT.md Autoverificación de finalización |
Método de ejecución (en orden descendente de capacidad, priorizar el método más aislado):
- Agent Teams (óptimo): Iniciar un agente revisor independiente, proporcionarle "ruta del archivo de salida + lista de verificación correspondiente + contexto clave", para que verifique elemento por elemento e informe estrictamente las conclusiones (qué ítems pasaron / cuáles fallaron + evidencia + sugerencias de reescritura).
- subAgent (subóptimo): Si no hay capacidad de Teams pero se puede iniciar un subagente, usarlo con el mismo proceso.
- Autoinspección (último recurso): Si el agente actual no tiene ninguna de las capacidades anteriores, debe verificar estrictamente elemento por elemento por sí mismo. No se permite una revisión superficial.
Regla de hierro: Después de obtener las conclusiones, primero corregir los elementos fallidos y luego informar al usuario "completado + conclusiones de la autoverificación + qué se corrigió". Informar directamente las conclusiones sin corregir = infracción.
Guía de lectura de archivos por fase
Diferentes fases leen diferentes archivos. En sesiones largas, el agente tiende a olvidar los principios, especialmente en la Fase 2.4 "Implementar un capítulo" que se repite N veces; cada vez se deben revisar las restricciones principales.
| Fase | Lectura obligatoria (cada vez) | Leer una vez / Consultar según sea necesario |
|---|---|---|
| Fase 1.1-1.2 Redacción de contenido | references/SCRIPT-STYLE.md + references/OUTLINE-FORMAT.md + article.md (texto original del usuario, si existe) | —— |
| Checkpoint Plan Seleccionar tema | —— | themes/*/theme.json (leer todos dinámicamente, listar + recomendación bestFor + descriptionZh); references/THEMES.md (cuando el usuario quiera conocer el sistema de temas) |
| Fase 2.1 Scaffolding | —— | SKILL.md de esta sección leer una vez |
| Fase 2.4 Implementar capítulo (×N veces, llamado por 2.2 / 2.3) | references/CHAPTER-CRAFT.md punto de entrada único – Parte 0 Diez principios / Parte 1 5 preguntas para empezar / Parte 2 Árbol de decisión relación→acción / Parte 3 Caja de herramientas visual / Parte 4 Referencia de duración / Parte 5 Antipatrones anti-AI / Parte 6 Reglas duras de código (incluye restricción obligatoria de narrations.ts) / Parte 7 Autoverificación de finalización / Parte 8 Consulta rápida de comentarios + themes/<id>/theme.json del tema actual + párrafo del outline.md del capítulo actual + article.md párrafo correspondiente a este capítulo + lista de materiales | references/EXAMPLES/ (referencia estructural, no plantilla para copiar); references/THEMES.md contrato completo de tokens |
| Fase 3 Síntesis de audio | references/AUDIO.md (incluye flujo narrations.ts → segments.json → cualquier proveedor, con minimax + openai integrados) | templates/scripts/tts-providers/README.md (al cambiar de proveedor / usar TTS propio) |
| Fase 4 Grabación + Postproducción | references/RECORDING.md (incluye ?auto=1 para grabación automática) | —— |
| Seleccionar / Crear / Modificar tema | —— | references/THEMES.md |
Al escribir un capítulo, solo leer
CHAPTER-CRAFT.md. Los diez principios / autopreguntas iniciales / árbol de decisión / antipatrones anti-AI / autoverificación de finalización están todos integrados en este único punto de entrada.EXAMPLES/no es de lectura obligatoria – primero diseñar libremente según el contenido, consultar solo si hay bloqueo (consultar la "forma" como ancla, no copiar).
Fase 1 – Redacción de contenido (producción única)
1.1 Identificar la entrada del usuario
| Lo que da el usuario | Qué hacer |
|---|---|
| Artículo original (lenguaje escrito / WeChat / artículo académico / blog) | Generar script.md + outline.md en una sola pasada (1.2), pasar por Checkpoint Plan |
| Guion de locución / guion de video ya preparado | Guardar como script.md, generar outline.md en una sola pasada (versión simplificada 1.2), pasar por Checkpoint Plan |
| Sin nada, solo dice "Ayúdame a hacer un video sobre el tema X" | Preguntar de vuelta: primero dar un material o esquema. El skill no concibe el contenido por el usuario |
1.2 Generar script.md + outline.md en una sola pasada
Los dos productos se completan en una sola reflexión:
- Generar
script.md: Según las reglas dereferences/SCRIPT-STYLE.md, convertir el artículo en un guion de locución adaptado a la plataforma, conservando el idioma original. Conservararticle.mdsin borrar: es la fuente de detalles para el pool de información del outline y la implementación visual de los capítulos (principio de doble fuente). - Generar
outline.md: Según las reglas dereferences/OUTLINE-FORMAT.md, dividir en capítulos + pasos + extraer el pool de información del primer párrafo de cada capítulo.
Límites del outline (clave):
| El outline debe incluir | El outline no debe incluir |
|---|---|
| División en capítulos / Número de pasos por capítulo / Tiempo estimado | Tipos de animación específica (blur clear / wipe / spring) |
| Contenido de la pantalla por paso (hero / datos / eslogan / elementos de lista) | Medios de implementación CSS (filter / SVG / clip-path) |
| Pool de información a nivel de capítulo: números / citas / casos / etiquetas extraídos del artículo | Valores de duración (no escribir |
| Prefijo opcional del nombre de la relación a nivel de paso ("Contraste de oposición" / "Lista progresiva" / "Frase clave" etc.) | Micro-ritmos como micro-movimiento continuo / compensación escalonada |
Razón por la que el outline no escribe animaciones: Si se escriben, el agente del capítulo degenera en una máquina de traducción; el espacio en blanco permite que el agente del capítulo diseñe libremente siguiendo el "árbol de decisión impulsado por el contenido" de
CHAPTER-CRAFT.mdal comenzar cada paso, logrando así una verdadera sensación de video. VerCHAPTER-CRAFT.mdParte 0 Principio 7.
Después de guardar, primero pasar por autoverificación antes de entrar a Checkpoint Plan: Según el «Protocolo de autoverificación obligatorio» anterior, ejecutar sobre script.md / outline.md respectivamente (priorizar Agent Teams → subAgent → autoinspección), reparar según las conclusiones y luego entrar a Checkpoint Plan.
Checkpoint Plan – Alinear 5 aspectos a la vez (Nodo duro)
Después de escribir script.md + outline.md, hay que detenerse. El usuario confirma simultáneamente 5 aspectos en este nodo.
Trabajo preparatorio que el agente debe hacer en este momento
- Leer todos los
themes/*/theme.jsonpara obtenernameZh/descriptionZh/bestFor/mood– No codificar la lista. - Según el tipo de contenido / palabras clave / tono de
script.md, seleccionar activamente 2~3 juegos de recomendaciones más adecuadas de los temas (coincidiendo con el campobestFor). - Revisar la sección "Lista de materiales" al final de
outline.md.
Plantilla de resumen (esqueleto, el agente rellena según el caso)
Plan de contenido completado, archivos generados:
📄 article.md {Si el usuario proporcionó el original, se conserva}
📄 script.md {X} palabras / ~{T} minutos
📄 outline.md {N} capítulos / {M} pasos + pool de información por capítulo + lista de materiales al final
Resumen de capítulos:
1. <id> <Título del capítulo> <S> pasos ~<T>s
2. ...
A continuación, alinear 5 aspectos a la vez:
1. ¿El guion (script.md) necesita cambios?
Puedes editar el archivo directamente o indicarme la dirección de los cambios oralmente.
2. ¿El plan de desarrollo (outline.md) necesita cambios? Presta especial atención a:
- ¿Es razonable la división en capítulos / número de pasos / tiempo estimado? (Razonable: 30~60s por capítulo)
- ¿Es claro el contenido de la pantalla por paso?
- ¿El «pool de información» del primer párrafo de cada capítulo tiene suficientes detalles del artículo para enganchar la imagen?
- ¿Está completa la lista de materiales al final?
3. ¿Qué tema elegir? Mis recomendaciones:
★ <Recomendación 1: nameZh (id)> — Porque <coincidencia bestFor>; <resumen descriptionZh>
★ <Recomendación 2 / Recomendación 3>
Otras opciones: <Temas restantes, nameZh + una frase>
También puedes pedirme que cree un tema nuevo (ver references/THEMES.md).
4. ¿Cómo preparar los materiales reales? Un vistazo rápido a las imágenes necesarias para este video: <Lista aproximada>
a) Yo selecciono de <Ruta de materiales existentes> b) Tú los proporcionas c) Todo placeholder
5. ¿Qué modo de desarrollo eliges?
**El Capítulo 1 debe completarse en el hilo principal con revisión del usuario sin importar el modo** (ancla obligatoria).
La diferencia está a partir del Capítulo 2:
A) Por defecto · Confirmación capítulo por capítulo (recomendado)
Pausa y revisión al terminar cada capítulo → Riesgo controlable / Ritmo más estable
B) Desarrollo secuencial después del Capítulo 1 (sin paralelismo)
Los capítulos 2~N se completan secuencialmente en el hilo principal y se revisan al final → Velocidad media / Adecuado para agentes que no soportan tareas paralelas
C) Desarrollo en paralelo después del Capítulo 1 (subagentes)
Los capítulos 2~N se completan en paralelo con subagentes → Más rápido / El usuario controla el número de tareas paralelas (¿cuántos capítulos a la vez?)
⚠️ Habrá diferencias de estilo entre capítulos (esto es esperado, los tokens del tema evitan que se salga de control)
Después de recibir comentarios:
- Si hay que cambiar el guion / outline: editar el archivo directamente, y después de editar, ping (o el agente cambia según la descripción oral).
- El tema debe estar claro para entrar a Fase 2. Si el usuario dice "tú eliges el tema" → tomar la primera recomendación, decirle al usuario qué se eligió y por qué, darle oportunidad de cambiar de opinión.
- Modo seleccionado → Entrar a Fase 2.
Fase 2 – Desarrollo web
2.1 Scaffolding
bash <ruta-a-web-video-presentation>/scripts/scaffold.sh \
./presentation \
--theme=<id del tema seleccionado por el usuario>
bash <ruta-a-web-video-presentation>/scripts/scaffold.sh --list-themes
Tema personalizado → Primero, según el flujo de "Crear nuevo tema" de
references/THEMES.md, crear unthemes/<my-theme>/, luego--theme=<my-theme>.
El scaffolding incluye un demo 01-example. Eliminarlo antes de escribir el contenido real del primer capítulo:
rm -rf presentation/src/chapters/01-example
Y eliminar el import y el elemento del array EXAMPLE_CHAPTER en presentation/src/registry/chapters.ts.
2.2 Capítulo 1 – Hilo principal + Revisión obligatoria
Clave: El Capítulo 1 es la versión completa de una sola vez (ritmo + imagen + materiales reales completos). No existe el concepto de "versión esqueleto" – el primer capítulo debe ser un prototipo que el usuario pueda revisar directamente.
Por qué el Capítulo 1 debe estar en el hilo principal:
- Es la primera aplicación de la guía
CHAPTER-CRAFT.mden el tema actual + contenido actual. - Si la guía tiene puntos ciegos / los tokens de color o fuente del tema son insuficientes, el Capítulo 1 lo revelará – entonces, con la retroalimentación humana, se puede ajustar la guía o el tema, el costo de corregir temprano es mínimo.
- Los capítulos siguientes (sean secuenciales o paralelos) deben tomar como referencia el patrón de código del Capítulo 1. Por lo tanto, el Capítulo 1 es el "ancla de estilo" del proyecto actual (no se busca uniformidad entre capítulos, pero el capítulo en sí mismo debe tener una capacidad de persuasión completa).
Después de completar el Capítulo 1, hay que detenerse y esperar la revisión del usuario:
Capítulo 1 <id> completado. El servidor de desarrollo se ejecuta en localhost:5173.
Puntos clave de revisión:
□ ¿La atmósfera visual es la correcta? ¿Coincide con las expectativas de <nombre del tema>?
□ ¿El ritmo es correcto? ¿Algún paso demasiado rápido / demasiado lento / información demasiado escasa?
□ ¿Las animaciones están impulsadas por el contenido? ¿O hay pasos con animaciones de entrada sin sentido?
□ Principio de doble fuente: ¿La pantalla tiene detalles que "la locución no menciona pero el artículo sí"?
□ Verificación anti-AI: ¿Hay degradados púrpura-rosa / bordes redondeados de colores / ilustraciones falsas / emojis?
Dime los problemas y los corregiré. Cuando esté bien, dime "continuar" y haré el Capítulo 2 y siguientes según el modo seleccionado.
2.3 Capítulos 2~N – Según modo seleccionado
Regla común en todos los modos: Cada capítulo se desarrolla de forma independiente según CHAPTER-CRAFT.md. No se busca uniformidad total de estilo entre capítulos – los tokens de color / fuente del tema garantizan la uniformidad visual; las animaciones / ritmo / demostración visual quedan a la libre interpretación del capítulo, lo cual es un objetivo de diseño.
Modo A · Por defecto · Confirmación capítulo por capítulo
Capítulo 2 completado → Pausa para revisión → OK → Capítulo 3 → Pausa → ... → Capítulo N. Revisión independiente de cada capítulo, problemas corregibles en cualquier momento, menor riesgo, ritmo más estable. Si el usuario no selecciona un modo explícitamente, se usa este por defecto.
Modo B · Desarrollo secuencial después del Capítulo 1
Capítulo 2 → Capítulo 3 → ... → Capítulo N completados secuencialmente en el hilo principal, revisión final unificada. Velocidad media, adecuado para entornos donde el agente no soporta tareas paralelas.
Modo C · Desarrollo en paralelo después del Capítulo 1 (subagentes)
Usar subagentes para completar los capítulos 2~N en paralelo. El número máximo de tareas paralelas lo controla el usuario ("4 capítulos a la vez" / "2 capítulos a la vez"). Más rápido, pero habrá diferencias de estilo entre capítulos – esto es esperado, porque:
- Cada subagente no ve el resultado de los otros subagentes, por lo que no pueden alinearse mecánicamente.
- El código de los capítulos está físicamente separado (una carpeta por capítulo / prefijo CSS propio), sin interferencias mutuas.
- Los tokens del tema garantizan la uniformidad visual (colores / fuentes / números hero / tarjetas / líneas divisorias / decoraciones), la atmósfera no se desvía.
- La falta de uniformidad de estilo = la sensación de respiración de un video escrito a mano (múltiples voces / múltiples perspectivas).
El prompt del subagente paralelo debe incluir:
- El párrafo del outline del capítulo actual (con el pool de información).
- La ruta de
references/CHAPTER-CRAFT.md(lectura única obligatoria – requisitos de demostración visual + revelación progresiva + principio de doble fuente + anti-AI + líneas rojas de código + autoverificación de finalización, todo en este archivo). descriptionZh/mood/bestFordeltheme.jsondel tema actual (consultar la atmósfera, pero las animaciones / duración / tamaño de fuente / emojis los decide libremente el agente del capítulo).- El código del Capítulo 1 como referencia de "estilo de código" (no como "objeto de copia visual").
- Regla dura: prefijo CSS independiente por capítulo (
.cd-/.mg-/.pm-/ ...); no modificarchapters.ts; al finalizar, ejecutarnpx tsc --noEmit.
Importante: Independientemente del modo seleccionado, el usuario puede cambiar de modo en cualquier momento. Si el Capítulo 2 está bien, el usuario puede decir "el resto en paralelo" / "el resto capítulo por capítulo".
2.4 Implementar un capítulo (obligatorio para cada capítulo)
Ver la guía detallada en references/CHAPTER-CRAFT.md – punto de entrada de lectura única obligatoria, que cubre: requisitos de demostración visual / revelación progresiva / selección de contenido / principio de doble fuente / estética básica de la demostración en video / anti-AI / líneas rojas de código / autoverificación de finalización.
Puntos clave (detallados en CHAPTER-CRAFT.md):
- Cada capítulo debe tener una demostración visual con CSS / SVG / Canvas / JS, prohibidos los capítulos de solo texto.
- Revelación progresiva: Las listas / enumeraciones deben mostrar 1 elemento = 1 paso, prohibido mostrar todo de una vez.
- Principio de doble fuente: El ritmo sigue al guion de locución (el orden no puede alterarse), los detalles se extraen del artículo original (pool de información + párrafo del artículo de este capítulo).
- Pasar por la autoverificación de finalización elemento por elemento, si no se cumple, volver a corregir – según el «Protocolo de autoverificación obligatorio» anterior (priorizar Agent Teams → subAgent → autoinspección), corregir antes de informar al usuario la entrega del capítulo.
2.5 Aumentar STORAGE_KEY después de cambios grandes
Después de modificar chapters.ts (añadir / eliminar / reordenar capítulos, o cambios en la longitud de narrations.ts de algún capítulo), aumentar STORAGE_KEY en presentation/src/hooks/useStepper.ts (ej. v4 → v5), para evitar que el cursor persistente caiga en un paso inexistente.
Checkpoint Audio – ¿Sintetizar audio? (Nodo duro)
Al finalizar la Fase 2, hay que detenerse y preguntar al usuario:
Página web completada, {N} capítulos {M} pasos, servidor de desarrollo en localhost:5173.
¿Sintetizar audio para grabación de pantalla con reproducción automática?
✓ Sintetizar → Escanear todos los narrations.ts de los capítulos para generar audio-segments.json,
llamar al proveedor TTS para sintetizar un mp3 por paso en public/audio/.
Después de la síntesis, se puede usar el modo ?auto=1 para grabar la pantalla en una sola toma (audio y video sincronizados naturalmente).
Dos proveedores incluidos:
• minimax (mmx-cli) – Por defecto, estable para voz en chino.
• openai (OPENAI_API_KEY) – Basado en curl, la mayoría ya tiene clave.
Otros backends (ElevenLabs / edge-tts gratuito / macOS say offline /
Azure / Google) ver los fragmentos listos en scripts/tts-providers/README.md.
✗ No sintetizar → Saltar Fase 3, ir directamente a Fase 4 con grabación manual + locución en postproducción.
Si quiere sintetizar → Fase 3. Si no → directamente Fase 4.
Fase 3 – Síntesis de audio (opcional)
Ver el flujo detallado en references/AUDIO.md. Versión simplificada:
cd presentation
npm run extract-narrations # Escanea todos los narrations.ts → audio-segments.json
# Deja que el usuario eche un vistazo a audio-segments.json para confirmar el texto.
npm run synthesize-audio # Proveedor minimax por defecto, incremental
# O usar el openai incluido (necesita OPENAI_API_KEY):
PRESENTATION_TTS=openai npm run synthesize-audio
# O personalizado: escribir un scripts/tts-providers/<nombre>.sh, ver el README.md de ese directorio.
Después de la síntesis, informar al usuario: ubicación de salida / número total de segmentos / qué segmentos tienen duraciones anómalas (demasiado largos = el paso necesita dividirse; demasiado cortos = el texto es muy escaso) – dar la última oportunidad de calibrar el ritmo. Luego entrar a Fase 4.
Fase 4 – Grabación de pantalla + Postproducción
Ver references/RECORDING.md para más detalles. Dos caminos:
| Escenario | Camino recomendado |
|---|---|
| Fase 3 con audio sintetizado | Modo Auto de una sola toma: Abrir localhost:5173/?auto=1 en el navegador → Presionar SPACE → El video completo se reproduce automáticamente → Detener la grabación → Recortar el inicio y final → Video terminado, sin necesidad de sincronizar pistas de audio en postproducción |
| Fase 3 omitida | Modo Manual por defecto, avanzar haciendo clic manualmente → Sincronizar audio con cualquier herramienta de edición en postproducción |
El agente, después de la Fase 3 / Checkpoint Audio, debe informar activamente al usuario sobre la ruta de grabación adecuada.
Diez principios (lista de una frase)
El desarrollo completo está en references/CHAPTER-CRAFT.md Parte 0 – Al escribir un capítulo, consultar allí. Lo siguiente es solo un índice.
| # | Principio | Una frase |
|---|---|---|
| 1 | Escenario fijo 16:9 | Contenido 1920×1080 + transform scale, sin responsividad |
| 2 | Contador de pasos global | El capítulo es una función pura de los pasos, sin temporizadores |
| 3 | Cada paso ocupa toda la pantalla | if (step === N) return <FullScene /> |
| 4 | Tiempo de locución = paso | Un tiempo = un paso = una idea enfocada |
| 5 | Controles de esquina ocultos | Barra de progreso / navegador con opacidad 0 por defecto |
| 6 | Escenario sin cromo | Sin header / footer / número de página / barra de marca |
| 7 | Animaciones impulsadas por el contenido | Primero buscar la acción intrínseca, solo si no se encuentra usar animación de entrada; micro-movimiento continuo con moderación |
| 8 | Revelación múltiple punto por punto | 1 elemento = 1 paso, prohibido mostrar N elementos a la vez con stagger |
| 9 | Mismo tema en todo el video | No cambiar el color de fondo entre capítulos; colores / fuentes mediante tokens, otras escalas libres por capítulo |
| 10 | Principio de doble fuente | El script marca el ritmo, el artículo determina la densidad visual (materializada en el pool de información) |
Consulta rápida de comentarios comunes del usuario
Tabla simplificada en references/CHAPTER-CRAFT.md Parte 8 «Consulta rápida de comentarios comunes». Clave: Primero identificar a qué nivel pertenece (ritmo / visual / contenido / código), luego modificar la porción más pequeña, no rehacer todo el capítulo.
Recursos relacionados
Marcados con "cuándo leer" para evitar leer todo de una vez:
| Archivo | Cuándo leer | Contenido |
|---|---|---|
references/SCRIPT-STYLE.md | Fase 1.2 Lectura obligatoria | Reglas para convertir artículo → guion de locución, variantes de plataforma |
references/OUTLINE-FORMAT.md | Fase 1.2 Lectura obligatoria | Especificación de campos de outline.md, convenciones de nomenclatura, división de capítulos, pool de información |
references/CHAPTER-CRAFT.md | Fase 2.4 Punto de entrada único de lectura obligatoria para cada capítulo | Parte 0 Diez principios / Parte 1 5 preguntas para empezar / Parte 2 Árbol de decisión relación→acción / Parte 3 Caja de herramientas visual / Parte 4 Duración / Parte 5 Antipatrones anti-AI / Parte 6 Reglas duras de código / Parte 7 Autoverificación de finalización / Parte 8 Consulta rápida de comentarios |
references/EXAMPLES/ | Opcional – ver estructura | Ejemplos de estructura de capítulos (hook / list-reveal / case-tech-review); no son plantillas para copiar |
references/THEMES.md | Al seleccionar / crear / modificar temas | Contrato completo de tokens + lista de temas integrados + flujo de creación |
references/AUDIO.md | Solo leer en Fase 3 | Flujo de síntesis de audio agnóstico al proveedor, uso de minimax integrado, ruta para cambiar de proveedor, solución de problemas |
templates/scripts/tts-providers/README.md | Al cambiar / añadir proveedor TTS | Contrato de 3 funciones + 2 integrados (minimax / openai) + 5 fragmentos de código listos (ElevenLabs / edge-tts / macOS say / Azure / Google) |
references/RECORDING.md | Solo leer en Fase 4 | Herramientas de grabación de pantalla + postproducción |
themes/ | Consultar en Checkpoint Plan / Fase 1.2 | Temas integrados (cada uno con theme.json + tokens.css) |
scripts/scaffold.sh | Ejecutar una vez en Fase 2.1 | Scaffolding del proyecto con un solo comando |