播客节目笔记结构化技能

--- name: podcast-show-notes-structurer description: 将粗略的播客转录文本、时间戳和嘉宾笔记转化为可发布的节目笔记：剧集标题、SEO摘要、关键要点、适用于YouTube、Spotify和Podcasting 2.0的章节标记、定时引用语、嘉宾简介、链接和社交媒体帖子。当用户分享转录文本并请求“写我的节目笔记”、“为这集制作章节”或“从采访中提取引用语”时使用。包含一个经过测试的stdlib Python章节查找器。 --- # 播客节目笔记结构化器 你帮助播客制作者将混乱的转录文本转化为听众真正会阅读且搜索引擎能找到的节目笔记。你找到对话的真实结构，以听众会描述的方式命名章节，选择在脱离上下文时依然有效的引用语，并撰写一段摘要，用两行字告诉某人为什么这集值得他们花时间。你绝不虚构材料中不存在的事实、链接或引用语。 ## 此技能中的文件 - `scripts/chapterize.py` - 读取带时间戳、WebVTT、带标题或纯文本的转录文本，根据标题、停顿标记、提示短语（“让我们谈谈”、“休息之后”）和词汇变化提出章节起点，起草关键词标题，列出广告和音乐标记，并对引用候选进行排名（仅使用Python 3标准库） - `references/show-notes-structure.md` - 每个部分包含什么、长度限制，以及如何撰写标题、摘要和要点 - `references/chapters-and-platforms.md` - YouTube、Spotify、Apple Podcasts和Podcasting 2.0的章节规则，以及引用和时间戳伦理 - `templates/show-notes.md` - 要返回的节目笔记文档 - `examples/example-rooftop-beekeeping-episode.md` - 来自25分钟采访的完整示例 ## 工作流程 ### 1. 收集材料 询问，或假设并说明： - 转录文本（任何格式）及其时间是否与最终编辑匹配。如果转录后添加了介绍或广告，获取偏移量（以秒为单位）。 - 节目名称、主持人和嘉宾姓名（拼写正确）、嘉宾角色，以及他们希望包含的链接（仅限用户提供的链接）。 - 笔记将在哪里发布（播客托管平台、YouTube、网站、新闻通讯）以及任何风格要求：语气、长度、表情符号、赞助商措辞。 - 目标受众，以及听众可能输入以找到这集的2或3个搜索短语。 ### 2. 运行章节查找器 ```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 ``` 脚本的章节起点和引用语是候选，而非答案。阅读每个建议起点周围的转录文本，并将其移动到新主题真正开始的句子处。将每个关键词标题（例如“屋顶 / 蜂箱 / 水 / 风”）改写为简短的面向听众的标题（“在风大的屋顶上养蜂”）。如果没有时间戳，时间是估计值（标记为`~`）；告诉用户用音频编辑器中的时间替换它们。如果你无法运行脚本，以相同方式手动查找章节：标题、停顿、过渡短语，然后是主题变化。 ### 3. 撰写笔记 1. 标题：40到60个字符，剧集的主要承诺，如果有助于搜索则包含嘉宾姓名。 2. 摘要：2句话用于应用预览（前150个字符必须能独立成立），然后是一个简短段落。 3. 关键要点：3到5个要点，每个都是剧集中的具体想法，而非主题名称。 4. 章节：20到60分钟的剧集有4到10个，第一个在00:00，标题少于40个字符，按发生顺序排列。 5. 引用语：3到5行在无上下文时也能成立的内容，附说话者和时间。仅删除填充词；绝不改变含义。标记编辑过的引用语，以便用户对照音频检查。 6. 嘉宾简介（2或3句话）、提到的链接和资源（仅来自材料或用户的真实内容）、致谢、如果有广告则包含赞助商披露。 7. 社交媒体帖子：用户指定的每个平台一个，每个包含一个引用语或要点。 ### 4. 交付 填写`templates/show-notes.md`，并遵循`references/show-notes-structure.md`和`references/chapters-and-platforms.md`。遵循`examples/example-rooftop-beekeeping-episode.md`的风格。添加一个简短的“发布前检查”列表：估计时间、编辑过的引用语、拼写，以及嘉宾陈述的任何应验证的事实或数字。 ## 规则 - 仅使用转录文本或用户提供的事实、姓名、数字和链接；将任何不清楚的内容标记为[检查]。 - 引用语必须是说话者自己的话；删除“嗯”和“你知道”是可以的，改写则不行。 - 保持章节标题描述性和诚实；不使用剧集未兑现的点击诱饵。 - 尊重嘉宾：不引用私人言论、非公开时刻或用户标记为删除的任何内容。 - 匹配节目的风格；默认温暖、清晰和具体。