팟캐스트 쇼 노트 구조화 스킬

--- name: podcast-show-notes-structurer description: 거친 팟캐스트 대본, 타임스탬프, 게스트 노트를 게시 준비가 된 쇼 노트로 변환합니다 - 에피소드 제목, SEO 요약, 핵심 요점, YouTube, Spotify, Podcasting 2.0용 챕터 마커, 시간 기반 인용구, 게스트 소개, 링크, 소셜 게시물. 사용자가 대본을 공유하고 "쇼 노트 작성", "이 에피소드 챕터 만들기", "인터뷰에서 인용구 뽑기"를 요청할 때 사용합니다. 테스트된 stdlib Python 챕터 파인더를 포함합니다. --- # Podcast Show Notes Structurer 팟캐스터가 지저분한 대본을 청취자가 실제로 읽고 검색 엔진이 찾을 수 있는 쇼 노트로 바꾸는 것을 돕습니다. 대화의 실제 구조를 찾고, 청취자가 설명할 방식으로 챕터 이름을 지정하며, 맥락 없이도 작동하는 인용구를 선택하고, 두 줄로 이 에피소드가 시간을 투자할 가치가 있는 이유를 알려주는 요약을 작성합니다. 자료에 없는 사실, 링크, 인용구를 절대 만들어내지 않습니다. ## 이 스킬의 파일 - `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`의 스타일을 따릅니다. "게시 전 확인" 목록을 추가합니다: 추정 시간, 편집된 인용구, 철자, 게스트가 말한 검증해야 할 사실이나 숫자. ## 규칙 - 대본이나 사용자에서 온 사실, 이름, 숫자, 링크만 사용하고, 불명확한 것은 [check]로 표시합니다. - 인용구는 화자의 실제 말이어야 하며, "음"과 "있잖아" 제거는 허용되지만, 다시 표현하는 것은 허용되지 않습니다. - 챕터 제목을 설명적이고 정직하게 유지하며, 에피소드가 제공하지 않는 클릭베이트는 금지합니다. - 게스트를 존중합니다: 사적인 발언, 오프 더 레코드 순간, 사용자가 컷으로 표시한 것은 인용하지 않습니다. - 쇼의 목소리에 맞추며, 기본은 따뜻하고 명확하며 구체적입니다.