그릴링 (Talk-Grill)

¿Qué hace 그릴링 (Talk-Grill)?

Extrae la presentación de la mente del presentador mediante preguntas y la plasma en brief.md (decisiones) y outline.md (esquema por diapositivas) dentro de la carpeta de la presentación. La construcción la realiza un nuevo subagente que solo lee estos dos archivos y sources/. Las decisiones que solo están en la conversación y no en los archivos no llegan a la construcción.

Primeras palabras del presentador: $ARGUMENTS

La sesión se abre en la raíz del kit. El comando ./talk se invoca desde la raíz del kit. A continuación, nombres como brief.md, talk.json se refieren a archivos dentro de la carpeta de la presentación (talks/<carpeta>/).

0. Determinar la carpeta de la presentación

1. Consulta el perfil del presentador con ./talk profile. Si no existe, la primera pregunta pide el nombre en inglés y la afiliación. Si el presentador va a hacer diapositivas en coreano, también pregunta el nombre y la afiliación en coreano. Guarda las respuestas con ./talk profile --name "..." --affiliation "..." (si es necesario, --name-ko, --affiliation-ko).
2. Consulta la marca con ./talk brand. Si está "sin configurar", antes de crear una nueva presentación, con una sola pregunta define el color y el logotipo. El método está en AGENTS.md de la raíz del kit, en "Colores y logotipo del laboratorio/escuela". Si el presentador pide crear sin preguntas, se usa el preset por defecto.
3. Si el presentador mencionó una presentación que ya está en curso, busca esa carpeta en ./talk list.
4. Si es una presentación nueva, se necesita el tipo, la fecha y el evento. Solo pregunta lo que falte de lo que dijo el presentador. Luego, crea la presentación con ./talk new <tipo> <AAAA-MM-DD> [evento] [--title "..."] [--lang ko]. Los tipos son lab, conf, seminar, class, jc. Para reuniones de laboratorio, el evento se deja vacío (la portada será "Lab meeting, fecha" y el tema del día se escribe con --topic o en topic de talk.json). La carpeta que aparece en la salida es la carpeta de esta presentación.
5. Si aparece un error de que falta la herramienta node, ejecuta ./talk setup y vuelve a intentarlo.

1. Leer antes de preguntar

1. Lee talk.json, README.md, brief.md y outline.md de la carpeta de la presentación. Si brief.md tiene un historial de grillado, continúa desde ahí.
2. Lee todo lo que dijo el presentador y todos los archivos de sources/. Los PDF se leen página por página. Los archivos externos o documentos web que mencione el presentador se copian a sources/ (para la web, se guarda el texto del cuerpo) y se registran en la tabla de materiales de entrada de brief.md con la ruta y el estado de verificación ("solo resumen", "texto verificado", "solo figuras"). Al copiar archivos externos con cp, aparecerá una pregunta de permiso una vez. El presentador lo permite. Los archivos se escriben con herramientas Write y Edit; los scripts de verificación se colocan en audit/tmp/ de la carpeta de la presentación (escribir fuera del kit, como en /tmp, será rechazado).
3. No preguntes sobre algo que los materiales ya responden. Las respuestas encontradas en los materiales se escriben en brief.md con "(de los materiales)" y solo se confirman.
4. Completa la sección de tarea de brief.md con talk.json. La plantilla básica para cada tipo de presentación está en .claude/skills/talk-grill/references/talk-types.md (relativo a la raíz del kit).
5. Fuera de la carpeta del kit (como el directorio personal), solo se lee si el presentador menciona la ruta. Leer fuera retrasa la primera pregunta porque aparece una solicitud de permiso. Una vez completados los cuatro pasos anteriores, haz la primera pregunta inmediatamente.

2. Cómo preguntar

• Solo una pregunta a la vez. Las opciones son de 2 a 4. Coloca la recomendación en primer lugar y añade una razón de una línea. El presentador también puede escribir su propia respuesta. En Claude Code, pregunta con AskUserQuestion. En agentes que no tengan esa herramienta, pregunta en el chat con el mismo formato (una línea de pregunta, opciones numeradas, la primera es la recomendación).
• Escribe preguntas cortas. No repitas extensamente respuestas anteriores.
• Al recibir una respuesta, edita brief.md inmediatamente. En el historial de grillado, escribe una línea Qn pregunta → respuesta y actualiza las líneas que esa respuesta cambie (tarea, oración principal, estructura). No dejes juntas la decisión antigua y la nueva.
• Si el presentador dice "no sé" o "después", regístralo como elemento abierto y no vuelvas a preguntar.
• Si el presentador pide opinión, verifica la fuente original, elige una opción y da una razón de una línea. En brief.md, escríbelo como "recomendación". La decisión la toma el presentador.
• Si la suposición del presentador difiere de la fuente original, primero di hasta dónde es correcto y luego señala qué corregir.
• Si el presentador cambia una decisión, sigue lo nuevo. No insistas en preguntar por qué.
• Si el presentador pide crear directamente sin preguntas, completa el brief y el outline con los materiales y la plantilla básica del tipo de presentación, y solo pide aprobación (sección 5). Lo que no se haya decidido se registra como elemento abierto.

3. Orden

Pregunta primero lo que más impacto tenga en la construcción.

1. Contexto: evento, tiempo de presentación, tiempo de preguntas, audiencia. De aquí sale el presupuesto de diapositivas (talk-types.md). Si el idioma de las diapositivas difiere de talk.json, corrige lang.
2. Una oración: la oración que la audiencia se llevará.
3. Estructura: 2–4 secciones y su orden. Sugiere la estructura básica de talk-types.md como punto de partida.
4. Por cada sección: afirmación, evidencia (figura, datos, página del artículo), modo de visualización (figura del artículo, diagrama conceptual redibujado, proceso que avanza paso a paso con cada clic). Puedes hacer varias preguntas para una sola sección.
5. Inicio y final: la pregunta que planteará la primera diapositiva, la última diapositiva (conclusión, preguntas de discusión, y en reuniones de laboratorio, el plan siguiente y la petición al supervisor).
6. Organizar elementos abiertos.

Termina después de 6–10 preguntas. Si el presentador dice que pare, termina inmediatamente.

4. Verificación de fuentes

• Las cifras y citas que aparecerán en las diapositivas deben verificarse en la fuente original (texto, tabla, pie de figura) y anotarse en "Verificación de fuente" de brief.md con el valor, archivo y página. No uses cifras basadas solo en el resumen o notas.
• Adjunta condiciones a las cifras (de qué datos, configuración o subconjunto provienen).
• Si la fuente original no explica la causa, no atribuyas una causa a la diferencia entre dos cifras.
• Si planeas usar figuras de artículos tal cual, verifica la licencia. Si es no derivados (como CC BY-ND), decide redibujar.
• Las fuentes no obtenidas (artículos de pago, etc.) se registran en los elementos abiertos de brief.md como "Materiales que el presentador debe obtener", y las secciones que dependen de esa fuente se marcan en outline como "por verificar".

5. Esquema (outline.md)

• Columnas de la tabla: #, sceneId, plantilla, título (una línea, máximo 10 palabras), afirmación en una oración, secuencia de pantalla y clics, evidencia (archivo·página).
• sceneId se escribe en minúsculas y números en inglés (ej.: motivation, setup, result2). La portada es title, el índice es outline, los abridores de sección son sec01 en adelante, el final es thanks.
• El número de diapositivas debe estar dentro del presupuesto. Una diapositiva = una idea. Poco texto, que las figuras expliquen. Los detalles van en las notas.
• En la columna "Secuencia de pantalla y clics" se escribe qué muestra la figura y qué aparece con cada clic. El agente de construcción solo crea lo que está escrito en esta columna.
• La información de portada definida se escribe en talk.json: title (título de la presentación si no es reunión de laboratorio), topic (tema de la reunión de laboratorio, subtítulo en color de acento en la portada), event, authors (coautores: {"name": ..., "name_ko": ...}), length_min, lang.
• En la parte superior del outline, escribe la línea de presentación (evento, fecha, hora, número de diapositivas). La línea de aprobación se deja vacía.

6. Aprobación y pase a construcción

1. Muestra la tabla de outline.md y pregunta. Opciones: "Crear así" (recomendado), "Hay algo que corregir".
2. Si hay algo que corregir, corrígelo y vuelve a preguntar.
3. Una vez aprobado, escribe la fecha de hoy en la línea de aprobación de outline.md y en el estado actual de README.md, escribe los elementos del grillado (lo decidido y los elementos abiertos).
4. Pasa a la construcción. En Claude Code, usa la herramienta Skill para invocar talk-build y pasa como primer argumento la ruta de la carpeta de la presentación (ej.: talks/2026-11-16-lab-meeting). talk-build se ejecuta en un nuevo subagente. Si el agente no tiene la herramienta Skill, lee .claude/skills/talk-build/SKILL.md y lo hace directamente según las instrucciones.
5. La construcción toma de diez a varias decenas de minutos dependiendo del número de diapositivas. Al terminar, informa brevemente al presentador. Luego, pídele que revise la hoja de contacto (talks/<carpeta>/audit/contact-sheet.png) y que diga de una vez qué corregir.