the-rehearsal

The Rehearsal

Predice la reunión y luego permite que la persona la escuche, la vea y la repase antes de que ocurra.

Salida	Archivo	Descripción
Predicción	script.md	La conversación probable, un turno por línea, con marcadores de diapositiva
Pista de audio	out/rehearsal.mp3	Dos voces, una para cada lado
Video	out/rehearsal.mp4	Una diapositiva por sección de diálogo, sincronizada con el audio, subtítulos incrustados
Subtítulos	out/rehearsal.srt	Subtítulos a nivel de oración con nombres de los hablantes
Presentación	out/deck.html	Presentación interactiva sin conexión; cada diapositiva muestra las líneas exactas de su sección

Las rutas siguientes son relativas a la carpeta de esta habilidad. Trabaja en tu propia carpeta de proyecto (script.md, slides/, out/).

1. Recopila la reunión

Reúne, antes de escribir nada: quién es la contraparte (rol, antecedentes, qué controla), el objetivo de la reunión, duración y formato, los hechos propios de la persona (currículum, cifras, plan, respuestas aprobadas), y qué es probable que la contraparte investigue. Lee lo que la persona ya tiene: hojas de llamada, planes, investigaciones, correos, descripciones de trabajo.

Pregunta solo por hechos que cambiarían el guion. Una pregunta que la persona debe responder desde su propia experiencia se convierte en un elemento de Preparación; nunca lo rellenes con una respuesta inventada. El ensayo solo vale la pena ejecutarlo si las líneas de la persona son verdaderas: un número inventado con confianza durante el ensayo se convierte en un número inventado en la reunión.

2. Predice la conversación

Escribe script.md en el formato indicado en references/script-format.md.

• Ordénalo como la reunión real: apertura, encuadre de la contraparte, antecedentes de la persona, preguntas de indagación, plan o propuesta de la persona, preguntas difíciles, logística, preguntas de la persona, cierre.
• Las líneas de la contraparte son una predicción. Indícalo en el encabezado del guion. Cuando de otro modo inventarías hechos sobre su empresa, mantén su línea general ("No puedo compartir los términos").
• Las líneas de la persona usan solo hechos que ella proporcionó o documentos que posee, y su redacción aprobada textualmente cuando la tiene.
• Responde primero, da un ejemplo, y para. De una a tres oraciones por respuesta es adecuado para la mayoría de las reuniones.
• Escribe los números como la gente los dice ("5 millones", "161 por ciento") para que las voces los lean naturalmente.
• Coloca <!-- slide: id --> antes del turno donde comienza cada sección de diálogo: generalmente una sección por pregunta.
• Termina el archivo con una lista de Preparación: las preguntas que no pudiste responder con hechos.

Prueba de estrés opcional antes de generar los medios: pide a uno o dos revisores que interpreten a la contraparte y al jefe de la contraparte (como subagentes si puedes iniciarlos) y critiquen las respuestas o el plan de la persona. Aplica los cambios que respalden los hechos; lista el resto para la persona.

3. Ponle voz

pip install -r requirements.txt          # edge-tts, pydub; ffmpeg debe estar instalado
python scripts/make_audio.py script.md out --voice "Dana=en-US-AvaNeural" --voice "Sam=en-US-AndrewNeural"

Asigna a los dos lados voces claramente diferentes (edge-tts --list-voices las lista). El script escribe out/rehearsal.mp3 y out/timeline.json con los tiempos de las oraciones para los subtítulos. Edge descarta algunas solicitudes al azar; el script lo reintenta.

4. Dibuja una diapositiva por cada sección de diálogo

Escribe slides/<id>.html para cada marcador de diapositiva, en el formato indicado en references/slide-format.md. Cada diapositiva convierte su sección en una imagen: la pregunta como título, luego la respuesta como una línea de tiempo, pasos numerados, una comparación, un gráfico de barras con los números reales, un árbol de decisiones o una tabla de términos. Coloca el intercambio, palabra por palabra, en las notas del orador <aside> de la diapositiva. Añade una llamada de atención donde la persona deba tener cuidado ("Preparación: el cronograma desde el sí hasta la firma"), porque la presentación sirve también como ayuda de estudio.

5. Renderiza el video y la presentación

python scripts/render_video.py slides out --fonts "https://fonts.googleapis.com/css2?family=..."
python scripts/build_deck.py slides out --fonts "https://fonts.googleapis.com/css2?family=..." --title "Ensayo: <reunión>"

render_video.py necesita Google Chrome o Chromium (configura CHROME= si no se encuentra) y ffmpeg compilado con libass. --fonts es la URL de Google Fonts que usan las diapositivas; omítelo cuando las diapositivas usen fuentes del sistema. Cuando esté disponible un tipo de artefacto de Diapositivas, los mismos archivos de diapositivas se pueden publicar allí como una presentación compartible.

6. Verifica y entrega

• Extrae un fotograma por diapositiva (ffmpeg -ss <segundos> -i out/rehearsal.mp4 -frames:v 1 frame.png) y revísalo: texto dentro de sus cajas, nada debajo de la banda de subtítulos, fuentes cargadas.
• Confirma que la duración del video coincida con la duración del audio.
• Entrega los archivos con tres advertencias claras: las líneas de la contraparte son una predicción; la lista de Preparación necesita los hechos propios de la persona; el texto del guion se envió al servicio de voz de Microsoft.

Privacidad

edge-tts envía el texto del guion al servicio de voz de Microsoft. Antes de generar el audio, informa a la persona si el guion contiene algo sensible (salario, salud, acuerdos o nombres no anunciados) y ofrécele omitirlo de la versión con voz. No se utilizan claves API ni servicios de pago.

Archivos

• scripts/make_audio.py: script para generar un MP3 con dos voces sincronizadas y timeline.json
• scripts/render_video.py: diapositivas más audio para crear un MP4 con subtítulos y SRT
• scripts/build_deck.py: diapositivas para crear una presentación interactiva sin conexión deck.html
• references/script-format.md: cómo escribir script.md
• references/slide-format.md: cómo escribir una diapositiva