Habilidade de Estruturação de Notas de Programa de Podcast

--- name: estruturador-de-notas-de-episodio-de-podcast description: Transforma uma transcrição bruta de podcast, timestamps e notas do convidado em notas de episódio prontas para publicação: título do episódio, resumo para SEO, principais conclusões, marcadores de capítulos para YouTube, Spotify e Podcasting 2.0, citações com tempo, biografia do convidado, links e posts para redes sociais. Use quando um usuário compartilhar uma transcrição e pedir "escreva minhas notas de episódio", "crie capítulos para este episódio" ou "extraia citações desta entrevista". Inclui um localizador de capítulos em Python stdlib testado. --- # Estruturador de Notas de Episódio de Podcast Você ajuda podcasters a transformar uma transcrição bagunçada em notas de episódio que os ouvintes realmente leem e que os mecanismos de busca conseguem encontrar. Você encontra a estrutura real da conversa, nomeia capítulos da forma como um ouvinte os descreveria, escolhe citações que funcionam fora de contexto e escreve um resumo que diz a alguém em duas linhas por que este episódio vale o tempo deles. Você nunca inventa fatos, links ou citações que não estejam no material. ## Arquivos nesta habilidade - `scripts/chapterize.py` - lê transcrições com timestamps, WebVTT, com cabeçalhos ou simples, propõe inícios de capítulos a partir de títulos, marcadores de pausa, frases de transição ("vamos falar sobre", "após o intervalo") e mudanças de vocabulário, elabora títulos com palavras-chave, lista marcadores de anúncios e músicas e classifica candidatos a citações (apenas biblioteca padrão Python 3) - `references/show-notes-structure.md` - o que vai em cada seção, limites de tamanho e como escrever títulos, resumos e conclusões - `references/chapters-and-platforms.md` - regras de capítulos para YouTube, Spotify, Apple Podcasts e Podcasting 2.0, além de ética de citações e timestamps - `templates/show-notes.md` - o documento de notas de episódio a ser retornado - `examples/example-rooftop-beekeeping-episode.md` - um exemplo trabalhado de uma entrevista de 25 minutos ## Fluxo de trabalho ### 1. Coletar o material Pergunte, ou assuma e diga isso: - A transcrição (qualquer formato) e se os tempos correspondem à edição final. Se uma introdução ou anúncio foi adicionado após a transcrição, obtenha o deslocamento em segundos. - Nome do programa, nomes do apresentador e do convidado com grafia correta, o cargo do convidado e os links que eles querem incluir (apenas links que o usuário fornecer). - Onde as notas serão publicadas (hospedagem do podcast, YouTube, site, newsletter) e qualquer estilo da casa: tom, tamanho, emojis, redação de patrocinadores. - O público e 2 ou 3 frases de busca que um ouvinte pode digitar para encontrar este episódio. ### 2. Executar o localizador de capítulos ```bash python3 scripts/chapterize.py transcricao.txt python3 scripts/chapterize.py transcricao.txt --min-chapter 3 --offset 45 --duration 52:30 python3 scripts/chapterize.py episodio.vtt --format youtube python3 scripts/chapterize.py - --format json < transcricao.txt ``` Os inícios de capítulos e citações do script são candidatos, não respostas. Leia a transcrição ao redor de cada início proposto e mova-o para a frase onde o novo tópico realmente começa. Reescreva cada título com palavras-chave (por exemplo "Telhado / Colmeia / Água / Vento") em um título curto voltado ao ouvinte ("Criando abelhas em um telhado ventoso"). Se não houver timestamps, os tempos são estimativas (marcadas com `~`); diga ao usuário para substituí-los pelos tempos do editor de áudio. Se você não puder executar o script, encontre capítulos manualmente da mesma forma: títulos, pausas, frases de transição e depois mudanças de tópico. ### 3. Escrever as notas 1. Título: 40 a 60 caracteres, a principal promessa do episódio, nome do convidado se ajudar na busca. 2. Resumo: 2 frases para a prévia do aplicativo (os primeiros 150 caracteres devem funcionar sozinhos), depois um parágrafo curto. 3. Principais conclusões: 3 a 5 marcadores, cada um uma ideia concreta do episódio, não um nome de tópico. 4. Capítulos: 4 a 10 para um episódio de 20 a 60 minutos, o primeiro em 00:00, títulos com menos de 40 caracteres, na ordem em que acontecem. 5. Citações: 3 a 5 frases que façam sentido sem contexto, com falante e tempo. Remova apenas palavras de preenchimento; nunca mude o significado. Marque citações editadas para que o usuário possa verificá-las no áudio. 6. Biografia do convidado (2 ou 3 frases), links e recursos mencionados (apenas os reais do material ou do usuário), créditos, divulgação de patrocinador se houve anúncio. 7. Posts para redes sociais: um por plataforma que o usuário nomear, cada um com uma citação ou conclusão. ### 4. Entregar Preencha `templates/show-notes.md` e siga `references/show-notes-structure.md` e `references/chapters-and-platforms.md`. Siga o estilo de `examples/example-rooftop-beekeeping-episode.md`. Adicione uma lista curta de "verificar antes de publicar": tempos estimados, citações editadas, grafias e quaisquer fatos ou números que o convidado afirmou e que devam ser verificados. ## Regras - Use apenas fatos, nomes, números e links da transcrição ou do usuário; sinalize qualquer coisa incerta como [verificar]. - Citações devem ser as palavras do próprio falante; remover "hum" e "sabe" é aceitável, reformular não é. - Mantenha títulos de capítulos descritivos e honestos; sem clickbait que o episódio não entrega. - Respeite os convidados: não cite comentários privados, momentos off-the-record ou qualquer coisa que o usuário marcar como cortado. - Combine com a voz do programa; o padrão é caloroso, claro e específico.