Communitygithub.com

O Ensaio

Ensaiar qualquer reunião importante antes dela acontecer. Prevê como a conversa vai fluir e constrói um kit de ensaio a partir da previsão: roteiro, faixa de áudio com duas vozes, vídeo com legendas incorporadas, arquivo de legendas e uma apresentação com um slide por seção de fala. Use quando alguém estiver se preparando para entrevista de emprego, reunião de vendas ou descoberta, negociação, pitch, atualização para investidores ou conselho, avaliação de desempenho ou qualquer conversa de alto risco, ou pedir por uma entrevista simulada, role-play, prática, roteiro, preparação de chamada, ou 'como será essa reunião', mesmo que nunca mencionem áudio, vídeo ou slides.

O que é O Ensaio?

O Ensaio (The Rehearsal) é uma skill para agentes de IA que permite prever o andamento de uma reunião importante e gerar um conjunto completo de materiais de ensaio: um roteiro da conversa prevista, um áudio com duas vozes (uma para cada lado), um vídeo com legendas sincronizadas, um arquivo de legendas e uma apresentação de slides interativa. A skill é útil para profissionais que precisam se preparar para reuniões de alto risco (entrevistas, negociações, pitches, etc.), pois permite ouvir, assistir e folhear a conversa antes dela acontecer. Ela funciona em três etapas principais: primeiro, coleta informações sobre a reunião e o interlocutor; segundo, prevê a conversa e escreve o roteiro em formato markdown; terceiro, gera os arquivos de áudio, vídeo, legendas e apresentação usando scripts Python e serviços como edge-tts. A skill enfatiza o uso apenas de fatos fornecidos pelo usuário para as falas da pessoa, evitando inventar respostas, e inclui um sistema de 'Prepare' para itens que requerem experiência pessoal. É compatível com plataformas que suportam execução de scripts Python e instalação de pacotes como edge-tts, pydub e ffmpeg.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Arash-yazdani/The-Rehearsal-Skill/tree/main/skills/the-rehearsal

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que O Ensaio faz?

Preveja a reunião e depois deixe a pessoa ouvir, assistir e folhear antes dela acontecer.

SaídaArquivoO que é
Previsãoscript.mdA conversa provável, uma fala por linha, com marcadores de slide
Faixa de áudioout/rehearsal.mp3Duas vozes, uma para cada lado
Vídeoout/rehearsal.mp4Um slide por seção de fala, temporizado com o áudio, legendas incorporadas
Legendasout/rehearsal.srtLegendas no nível de frase com nomes dos falantes
Apresentaçãoout/deck.htmlApresentação offline de folhear; mostra as linhas exatas de cada seção

Os caminhos abaixo são relativos à pasta desta skill. Trabalhe em uma pasta de projeto própria (script.md, slides/, out/).

1. Reúna a reunião

Colete, antes de escrever qualquer coisa: quem é o interlocutor (cargo, histórico, o que ele controla), o objetivo da reunião, duração e formato, os fatos da própria pessoa (currículo, números, plano, respostas aprovadas), e o que esse interlocutor provavelmente vai investigar. Leia o que a pessoa já tem: fichas de chamada, planos, pesquisas, e-mails, descrições de cargo.

Pergunte apenas por fatos que mudariam o roteiro. Uma pergunta que a pessoa deve responder com base na própria experiência se torna um item Prepare; nunca preencha com uma resposta inventada. O ensaio só vale a pena ser executado se as falas da pessoa forem verdadeiras: um número inventado com confiança no ensaio se transforma em um número inventado na reunião.

2. Preveja a conversa

Escreva script.md no formato encontrado em references/script-format.md.

  • Organize como a reunião real: abertura, enquadramento do interlocutor, histórico da pessoa, perguntas investigativas, plano ou pitch da pessoa, perguntas difíceis, logística, perguntas da pessoa, encerramento.
  • As falas do interlocutor são uma previsão. Diga isso no cabeçalho do roteiro. Onde você teria que inventar fatos sobre a empresa deles, mantenha a fala genérica ("Não posso compartilhar os termos").
  • As falas da pessoa usam apenas fatos fornecidos por ela ou documentos que ela possui, e a redação aprovada textualmente onde ela a tiver.
  • Responda primeiro, dê um exemplo, pare. Uma a três frases por resposta serve para a maioria das reuniões.
  • Escreva números da forma como as pessoas os dizem ("5 milhões", "161 por cento") para que as vozes os leiam naturalmente.
  • Coloque <!-- slide: id --> antes da fala onde cada seção de fala começa: geralmente uma seção por pergunta.
  • Termine o arquivo com uma lista Prepare: as perguntas que você não conseguiu responder com fatos.

Teste de estresse opcional antes de gerar a mídia: peça a um ou dois revisores para interpretar o interlocutor e o chefe do interlocutor (como subagentes, se puder iniciá-los) e criticar as respostas ou o plano da pessoa. Aplique as mudanças que os fatos suportam; liste o restante para a pessoa.

3. Dê voz

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

Dê aos dois lados vozes claramente diferentes (edge-tts --list-voices as lista). O script escreve out/rehearsal.mp3 e out/timeline.json com temporizações de frase para as legendas. O Edge descarta algumas requisições aleatoriamente; o script tenta novamente.

4. Desenhe um slide por seção de fala

Escreva slides/<id>.html para cada marcador de slide, no formato encontrado em references/slide-format.md. Cada slide transforma sua seção em uma imagem: a pergunta como título, depois a resposta como uma linha do tempo, etapas numeradas, uma comparação, um gráfico de barras com os números reais, um caminho de decisão ou uma tabela de termos. Coloque a troca, palavra por palavra, nas notas do orador <aside> do slide. Adicione um destaque sempre que a pessoa precisar ter cuidado ("Prepare: o cronograma do sim à assinatura"), porque a apresentação também serve como auxílio de estudo.

5. Renderize o vídeo e a apresentação

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 "Ensaio: <reunião>"

render_video.py precisa do Google Chrome ou Chromium (defina CHROME= se não for encontrado) e ffmpeg compilado com libass. --fonts é a única URL do Google Fonts que os slides usam; omita quando os slides usarem fontes do sistema. Onde um tipo de artefato Slides estiver disponível, os mesmos arquivos de slide podem ser publicados lá como uma apresentação compartilhável.

6. Verifique e entregue

  • Extraia um quadro por slide (ffmpeg -ss <segundos> -i out/rehearsal.mp4 -frames:v 1 frame.png) e olhe para ele: texto dentro de suas caixas, nada sob a faixa de legendas, fontes carregadas.
  • Confirme que a duração do vídeo corresponde à duração do áudio.
  • Entregue os arquivos com três ressalvas simples: as falas do interlocutor são uma previsão; a lista Prepare precisa dos próprios fatos da pessoa; o texto do roteiro foi enviado ao serviço de fala da Microsoft.

Privacidade

edge-tts envia o texto do roteiro para o serviço de fala da Microsoft. Antes de gerar o áudio, informe a pessoa se o roteiro contiver algo sensível (salário, saúde, negócios ou nomes não anunciados) e ofereça para deixar de fora da versão falada. Nenhuma chave de API ou serviços pagos são usados.

Arquivos

  • scripts/make_audio.py - script para MP3 com duas vozes temporizado e timeline.json
  • scripts/render_video.py - slides mais áudio para MP4 e SRT legendados
  • scripts/build_deck.py - slides para uma apresentação offline de folhear deck.html
  • references/script-format.md - como escrever script.md
  • references/slide-format.md - como escrever um slide

Habilidades Relacionadas