그릴링 (Talk Grill)

O que 그릴링 (Talk Grill) faz?

Extraia a apresentação da mente do apresentador por meio de perguntas e crie o brief.md (decisões) e o outline.md (esboço por cena) na pasta da apresentação. A construção é feita por um novo subagente que lê apenas estes dois arquivos e a pasta sources/. Decisões que ficam apenas na conversa e não nos arquivos não alcançam a construção.

Primeiras palavras dadas pelo apresentador: $ARGUMENTS

A sessão está aberta na raiz do kit. O comando ./talk é invocado a partir da raiz do kit. Abaixo, nomes como brief.md, talk.json referem-se a arquivos dentro da pasta da apresentação (talks/<pasta>/).

0. Definir a pasta da apresentação

1. Veja as informações do apresentador com ./talk profile. Se não houver, a primeira pergunta será o nome e a afiliação em inglês. Se o apresentador for fazer slides em coreano, pergunte também o nome e a afiliação em coreano. Salve a resposta com ./talk profile --name "..." --affiliation "..." (adicione --name-ko, --affiliation-ko se necessário).
2. Veja ./talk brand. Se estiver "não configurado", antes de criar uma nova apresentação, pergunte (uma pergunta) sobre cores e logotipo. O método está em AGENTS.md na raiz do kit, seção "Cores e logotipo da escola/laboratório". Se o apresentador pedir para criar sem perguntar, use o preset padrão sem questionar.
3. Se o apresentador mencionou uma apresentação em andamento, procure a pasta correspondente em ./talk list.
4. Para uma nova apresentação, precisamos do tipo, data e evento. Pergunte apenas o que faltar na fala do apresentador (uma pergunta). Depois, crie com ./talk new <tipo> <YYYY-MM-DD> [evento] [--title "..."] [--lang ko]. Tipos: lab, conf, seminar, class, jc. Para reunião de laboratório, deixe o evento vazio (a capa será "Lab meeting, data"; o tópico do dia vai em --topic ou talk.json topic). A pasta exibida na saída é a pasta desta apresentação.
5. Se houver erro informando que a ferramenta node não foi encontrada, execute ./talk setup e tente novamente.

1. Leitura antes das perguntas

1. Leia talk.json, README.md, brief.md, outline.md da pasta da apresentação. Se houver registro de grill no brief.md, continue a partir dali.
2. Leia todas as palavras do apresentador e todos os arquivos em sources/. PDFs são lidos página por página. Copie arquivos externos ou documentos web mencionados pelo apresentador para sources/ (para web, salve o corpo como texto) e registre no brief.md a tabela de materiais de entrada com caminho e status de verificação ("apenas resumo", "texto verificado", "apenas figura"). Ao copiar arquivos externos com cp, uma permissão será solicitada uma vez. O apresentador deve permitir. Escreva arquivos com ferramentas de Write e Edit; scripts de verificação vão em audit/tmp/ dentro da pasta da apresentação (escrever fora do kit, como /tmp, será rejeitado).
3. Não pergunte o que o material já responde. Respostas encontradas nos materiais são registradas no brief.md com a anotação "(do material)" e apenas submetidas para confirmação.
4. Preencha a seção de tarefas do brief.md com base em talk.json. O modelo básico para cada tipo de apresentação está em .claude/skills/talk-grill/references/talk-types.md (relativo à raiz do kit).
5. Só leia pastas fora do kit (como home directory) se o apresentador mencionar explicitamente o caminho. Ler fora do kit atrasa a primeira pergunta devido à solicitação de permissão. Após completar as quatro etapas acima, faça a primeira pergunta imediatamente.

2. Como perguntar

• Faça apenas uma pergunta por vez. Ofereça 2–4 opções. Coloque a recomendação em primeiro lugar e adicione uma breve justificativa. O apresentador também pode escrever a resposta diretamente. No Claude Code, use a ferramenta AskUserQuestion. Em agentes sem essa ferramenta, pergunte no chat com o mesmo formato (uma linha para a pergunta, opções numeradas, a primeira sendo a recomendada).
• Seja breve. Não repita longamente as respostas anteriores.
• Ao receber a resposta, atualize imediatamente o brief.md. Escreva uma linha no registro de grill: Qn pergunta → resposta, e atualize as linhas afetadas pela resposta (tarefas, one-liner, estrutura). Não mantenha a decisão antiga junto com a nova.
• Se o apresentador disser "não sei" ou "depois", registre como item em aberto e não repita a pergunta.
• Se o apresentador pedir sua opinião, verifique o material original, escolha uma opção e justifique em uma linha. Registre no brief.md como "recomendação". A decisão final é do apresentador.
• Se a premissa do apresentador divergir do material original, primeiro aponte até onde está correto e depois indique o que precisa ser corrigido.
• Se o apresentador mudar uma decisão, aceite a nova fala. Não questione o motivo.
• Se o apresentador pedir para criar diretamente sem perguntas, preencha o brief e o outline com base no material e no modelo básico do tipo de apresentação, e apenas solicite aprovação (seção 5). Deixe itens não decididos como abertos.

3. Ordem

Pergunte primeiro o que tem maior impacto na construção.

1. Contexto: evento, tempo de apresentação, tempo de Q&A, audiência. Daqui sai o orçamento de cenas (talk-types.md). Se o idioma dos slides for diferente do talk.json, corrija lang.
2. One-liner: uma frase que a audiência levará para casa.
3. Estrutura: 2–4 seções e sua ordem. Sugira a estrutura padrão de talk-types.md como ponto de partida.
4. Por seção: argumento principal, evidência (figuras, dados, páginas de artigos), modo de exibição (figura do artigo, conceito redesenhado, animação passo a passo por clique). Pode fazer várias perguntas para uma seção.
5. Abertura e fechamento: a pergunta que o primeiro slide fará, o último slide (conclusão, perguntas para discussão; para reunião de laboratório, próximos passos e pedido ao orientador).
6. Organize itens em aberto.

Pergunte de 6 a 10 vezes e termine. Se o apresentador quiser parar antes, pare imediatamente.

4. Verificação do material original

• Números e citações a serem colocados nos slides devem ser verificados no material original (texto, tabela, legenda de figura) e registrados no brief.md seção "Verificação do material original" com valor, arquivo e página. Não use números baseados apenas em resumo ou notas.
• Acompanhe números com condições (de quais dados, configuração, subconjunto o valor foi extraído).
• Se o material original não mencionar causa, não atribua causa à diferença entre dois números.
• Se planeja usar figuras de artigos diretamente, verifique a licença. Se houver restrição de modificação (CC BY-ND etc.), decida por redesenhar.
• Materiais não obtidos (artigos pagos etc.) registre como "Material a ser obtido pelo apresentador" em itens abertos no brief.md, e marque as cenas que dependem desse material como "não verificado" no outline.

5. Esboço (outline.md)

• Colunas da tabela: #, sceneId, moldura, título (uma linha, ≤10 palavras), argumento em uma frase, ordem da tela e cliques, evidência (arquivo·página).
• sceneId em letras minúsculas e números (ex.: motivation, setup, result2). Capa: title, índice: outline, abertura de seção: sec01 em diante, final: thanks.
• Número de cenas dentro do orçamento. Uma cena, uma ideia. Pouco texto; deixe as figuras explicarem. Detalhes vão para as notas.
• Na coluna "Ordem da tela e cliques", descreva o que a figura mostra e o que aparece a cada clique. O agente de construção só criará o que estiver escrito nesta coluna.
• Informações fixas da capa vão em talk.json: title (título da apresentação, exceto reunião de laboratório), topic (tópico da reunião de laboratório, subtítulo destacado na capa), event, authors (coautores: {"name": ..., "name_ko": ...}), length_min, lang.
• No topo do outline, escreva a linha de apresentação (evento, data, tempo, número de cenas). Deixe a linha de aprovação em branco.

6. Aprovação e conclusão

1. Mostre a tabela do outline.md e pergunte. Opções: "Criar assim" (recomendado), "Há algo a corrigir".
2. Se houver algo a corrigir, corrija e pergunte novamente.
3. Após aprovação, escreva a data de hoje na linha de aprovação do outline.md, e no README.md estado atual, registre os itens do grill (o que foi decidido e itens em aberto).
4. Passe para a construção. No Claude Code, use a ferramenta Skill para invocar talk-build com o primeiro argumento sendo o caminho da pasta da apresentação (ex.: talks/2026-11-16-lab-meeting). O talk-build roda em um novo subagente. Em agentes sem a ferramenta Skill, leia .claude/skills/talk-build/SKILL.md e siga diretamente.
5. A construção leva de dezenas de minutos a dezenas de minutos, dependendo do número de cenas. Ao final, comunique o relatório brevemente ao apresentador. Em seguida, peça para ele olhar a folha de contato (talks/<pasta>/audit/contact-sheet.png) e apontar pontos a corrigir de uma só vez.