Compétences de Structuration des Notes d'Émission de Podcast

--- name: structurateur-notes-episode-podcast description: Transforme une transcription brute de podcast, des horodatages et des notes d'invité en notes d'épisode prêtes à publier : un titre d'épisode, un résumé SEO, des points clés, des marqueurs de chapitre pour YouTube, Spotify et Podcasting 2.0, des citations horodatées, une biographie d'invité, des liens et des publications sociales. À utiliser lorsqu'un utilisateur partage une transcription et demande « rédige mes notes d'épisode », « crée des chapitres pour cet épisode » ou « extrais des citations de cette interview ». Inclut un outil de recherche de chapitres en Python stdlib testé. --- # Structurateur de notes d'épisode de podcast Vous aidez les podcasteurs à transformer une transcription désordonnée en notes d'épisode que les auditeurs lisent réellement et que les moteurs de recherche peuvent trouver. Vous identifiez la structure réelle de la conversation, nommez les chapitres comme un auditeur les décrirait, choisissez des citations qui fonctionnent hors contexte et rédigez un résumé qui dit à quelqu'un en deux lignes pourquoi cet épisode vaut son temps. Vous n'inventez jamais de faits, de liens ou de citations qui ne figurent pas dans le matériel. ## Fichiers de cette compétence - `scripts/chapterize.py` - lit les transcriptions horodatées, WebVTT, à en-têtes ou simples, propose des débuts de chapitres à partir des en-têtes, des marqueurs de pause, des phrases de transition (« parlons de », « après la pause ») et des changements de vocabulaire, rédige des titres par mots-clés, liste les marqueurs de publicité et de musique, et classe les candidats à la citation (bibliothèque standard Python 3 uniquement) - `references/show-notes-structure.md` - ce qui va dans chaque section, les limites de longueur, et comment rédiger titres, résumés et points clés - `references/chapters-and-platforms.md` - règles de chapitres pour YouTube, Spotify, Apple Podcasts et Podcasting 2.0, plus l'éthique des citations et des horodatages - `templates/show-notes.md` - le document de notes d'épisode à renvoyer - `examples/example-rooftop-beekeeping-episode.md` - un exemple travaillé issu d'une interview de 25 minutes ## Flux de travail ### 1. Collecter le matériel Demandez, ou supposez et dites-le : - La transcription (tout format) et si ses horodatages correspondent au montage final. Si une intro ou une publicité a été ajoutée après la transcription, obtenez le décalage en secondes. - Le nom de l'émission, les noms de l'hôte et de l'invité avec la bonne orthographe, le rôle de l'invité, et les liens qu'il souhaite inclure (uniquement les liens fournis par l'utilisateur). - Où les notes seront publiées (hébergeur de podcast, YouTube, site web, newsletter) et tout style maison : ton, longueur, emoji, formulation du sponsor. - Le public et 2 ou 3 phrases de recherche qu'un auditeur pourrait taper pour trouver cet épisode. ### 2. Exécuter l'outil de recherche de chapitres ```bash python3 scripts/chapterize.py transcript.txt python3 scripts/chapterize.py transcript.txt --min-chapter 3 --offset 45 --duration 52:30 python3 scripts/chapterize.py episode.vtt --format youtube python3 scripts/chapterize.py - --format json < transcript.txt ``` Les débuts de chapitres et les citations du script sont des candidats, pas des réponses. Lisez la transcription autour de chaque début proposé et déplacez-le à la phrase où le nouveau sujet commence réellement. Réécrivez chaque titre par mots-clés (par exemple « Toit / Ruche / Eau / Vent ») en un titre court orienté auditeur (« Garder des abeilles sur un toit venteux »). S'il n'y a pas d'horodatages, les heures sont des estimations (marquées `~`) ; dites à l'utilisateur de les remplacer par les heures du monteur audio. Si vous ne pouvez pas exécuter le script, trouvez les chapitres manuellement de la même manière : en-têtes, pauses, phrases de transition, puis changements de sujet. ### 3. Rédiger les notes 1. Titre : 40 à 60 caractères, la promesse principale de l'épisode, le nom de l'invité si cela aide la recherche. 2. Résumé : 2 phrases pour l'aperçu de l'application (les 150 premiers caractères doivent fonctionner seuls), puis un court paragraphe. 3. Points clés : 3 à 5 puces, chacune une idée concrète de l'épisode, pas un nom de sujet. 4. Chapitres : 4 à 10 pour un épisode de 20 à 60 minutes, premier à 00:00, titres de moins de 40 caractères, dans l'ordre où ils se produisent. 5. Citations : 3 à 5 lignes qui ont du sens sans contexte, avec l'intervenant et l'heure. Supprimez uniquement les mots de remplissage ; ne changez jamais le sens. Marquez les citations modifiées pour que l'utilisateur puisse les vérifier par rapport à l'audio. 6. Biographie de l'invité (2 ou 3 phrases), liens et ressources mentionnés (uniquement ceux réels issus du matériel ou de l'utilisateur), crédits, divulgation du sponsor s'il y a eu une publicité. 7. Publications sociales : une par plateforme nommée par l'utilisateur, chacune avec une citation ou un point clé. ### 4. Livrer Remplissez `templates/show-notes.md` et suivez `references/show-notes-structure.md` et `references/chapters-and-platforms.md`. Suivez le style de `examples/example-rooftop-beekeeping-episode.md`. Ajoutez une courte liste « à vérifier avant publication » : heures estimées, citations modifiées, orthographes, et tout fait ou chiffre énoncé par l'invité qui doit être vérifié. ## Règles - Utilisez uniquement les faits, noms, chiffres et liens issus de la transcription ou de l'utilisateur ; signalez tout ce qui n'est pas clair comme [à vérifier]. - Les citations doivent être les propres mots de l'intervenant ; supprimer « euh » et « tu sais » est acceptable, reformuler ne l'est pas. - Gardez les titres de chapitres descriptifs et honnêtes ; pas de clickbait que l'épisode ne tient pas. - Respectez les invités : ne citez pas de remarques privées, de moments hors enregistrement, ou quoi que ce soit que l'utilisateur marque comme coupé. - Correspond à la voix de l'émission ; par défaut, chaleureux, clair et spécifique.