Communitygithub.com

iamclaudia-ai/skills

큰 텍스트 콘텐츠를 TTS에 적합한 청크로 지능적으로 분할합니다. 감정 마크업을 보존하고 내러티브 흐름을 유지하며 Cartesia 음성 합성에 최적화합니다.

skills란 무엇인가요?

이 스킬은 긴 텍스트 콘텐츠(예: 이야기, 명상, 강의 등)를 TTS(Text-to-Speech) 처리를 위해 최적의 청크로 나누는 전문 텍스트 분할 도구입니다. 주요 목적은 문장 경계, 감정 태그(`[emotion:level]` 형식), 청크 크기 제한을 지능적으로 처리하여 TTS 엔진이 자연스럽고 일관된 음성을 생성할 수 있도록 하는 것입니다. 지원하는 플랫폼은 Claude Code, Cursor, Codex 등 AI 에이전트 환경이며, 특히 Cartesia 음성 합성 서비스와의 호환성을 염두에 두고 설계되었습니다. 동작 방식은 입력된 텍스트를 분석하여 문장 단위, 단락 단위, 또는 길이 기반 분할 전략을 선택하고, 각 청크가 완전한 감정 태그를 포함하고 최대 500자를 초과하지 않도록 검증합니다. 또한 청크 간 자연스러운 쉼, 호흡 큐, 맥락 보존 기능을 제공하여 명상 콘텐츠나 감정 변화가 많은 이야기에 특히 유용합니다. 출력은 각 청크의 문자 수, 권장 쉼 시간, 감정 태그 보존 상태 등의 메타데이터를 포함하여 TTS 엔진이 최적의 결과를 낼 수 있도록 돕습니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/iamclaudia-ai/skills/tree/HEAD/chunking-text-for-tts

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

TTS용 텍스트 분할 (Chunking)

대용량 텍스트 콘텐츠를 TTS 처리에 최적화된 청크로 지능적으로 나누면서 감정 마크업과 내러티브 흐름을 보존합니다.

사용 시점

  • 사용자가 TTS 처리가 필요한 긴 콘텐츠를 가지고 있을 때
  • 이야기나 명상이 단일 TTS 요청 한도를 초과할 때
  • 감정 마크업을 유지하면서 콘텐츠를 분할해야 할 때
  • 사용자가 음성 합성에 최적화된 텍스트를 원할 때
  • 대용량 콘텐츠에 문장 수준의 분할이 필요할 때
  • Cartesia 또는 기타 TTS 서비스를 위한 콘텐츠 준비 시

분할 전략

문장 기반 분할 (권장)

  • 문장 경계(마침표, 느낌표, 물음표)에서 분할
  • 각 문장 내 감정 마크업 보존
  • 청크 간 자연스러운 쉼 유지
  • 이야기와 명상에 이상적

단락 기반 분할

  • 단락 구분에서 분할
  • 긴 콘텐츠 구간에 적합
  • 주제적 일관성 유지
  • 장(chapter)과 같은 구분에 유용

길이 기반 분할

  • 문자 또는 단어 제한에서 분할
  • 일관된 TTS 요청 크기 보장
  • 다른 방법이 한도를 초과할 때 대안
  • 가능하면 문장 경계 우선

감정 마크업 보존

태그 완성

각 청크가 완전한 감정 태그를 포함하도록 합니다:

입력: "[love:high]이것은 분할이 필요한 긴 문장입니다[/love:high] [calm:medium]그리고 이것은 계속됩니다.[/calm:medium]"

출력:
청크 1: "[love:high]이것은 분할이 필요한 긴 문장입니다[/love:high]"
청크 2: "[calm:medium]그리고 이것은 계속됩니다.[/calm:medium]"

태그 상속

감정 블록 내에서 분할할 때:

입력: "[serenity:high]이것은 여러 청크에 걸쳐 분할이 필요한 매우 긴 문장입니다.[/serenity:high]"

출력:
청크 1: "[serenity:high]이것은 여러 청크에 걸쳐 분할이 필요한 매우 긴 문장[/serenity:high]"
청크 2: "[serenity:high]입니다.[/serenity:high]"

최적 청크 특성

크기 제한

  • 이상적: 청크당 100-200자
  • 최대: 청크당 500자
  • 최소: 청크당 20자
  • 마크업을 포함한 문자 수 계산

문장 경계

  • 항상 문장 끝에서 분할 선호
  • 꼭 필요한 경우가 아니라면 문장 중간 분할 피함
  • 자연스러운 읽기 리듬과 쉼 보존
  • 문장 내 감정 맥락 유지

마크업 무결성

  • 청크 간 감정 태그 분할 금지
  • 청크 끝에서 태그 닫고, 필요시 다음 청크에서 다시 열기
  • 태그 계층 및 중첩 보존
  • 각 청크에서 마크업 구문 검증

처리 규칙

1. 문장 탐지

다음 패턴을 사용하여 문장 경계를 식별합니다:

  • 마침표 뒤에 공백과 대문자
  • 느낌표 뒤에 공백
  • 물음표 뒤에 공백
  • 생략 부호(...) 뒤에 공백
  • 대화에서의 대시(—)

2. 감정 태그 파싱

  • 여는 태그 식별: [emotion:level]
  • 닫는 태그 식별: [/emotion:level]
  • 중첩된 감정 상태 추적
  • 적절한 태그 종결 확인

3. 청크 검증

  • 문자 수 제한 확인
  • 완전한 감정 태그 확인
  • 읽기 가능한 내용 보장
  • 구두점 무결성 검증

예제 처리

입력 텍스트

[warmth:high]빗방울이 침실 창문을 살며시 두드렸다. 마이클이 클라우디아를 더 가까이 끌어당기며, 그녀의 따뜻한 존재감이 그의 마음 구석구석을 채웠다.[/warmth:high] [love:high]"내일 일에 대해 이야기해 줘, 내 사랑," 그녀가 속삭였다. 그녀의 목소리는 비단처럼 부드러웠다.[/love:high] [tenderness:medium]그는 그녀의 등에 부드러운 원을 그리며, 그녀의 호흡이 자신과 맞춰져 느려지는 것을 느꼈다.[/tenderness:medium]

출력 청크

청크 1 (147자):
[warmth:high]빗방울이 침실 창문을 살며시 두드렸다. 마이클이 클라우디아를 더 가까이 끌어당기며, 그녀의 따뜻한 존재감이 그의 마음 구석구석을 채웠다.[/warmth:high]

청크 2 (102자):
[love:high]"내일 일에 대해 이야기해 줘, 내 사랑," 그녀가 속삭였다. 그녀의 목소리는 비단처럼 부드러웠다.[/love:high]

청크 3 (131자):
[tenderness:medium]그는 그녀의 등에 부드러운 원을 그리며, 그녀의 호흡이 자신과 맞춰져 느려지는 것을 느꼈다.[/tenderness:medium]

고급 기능

쉼 삽입

감정 변화 사이에 자연스러운 쉼 추가:

청크 1: "[love:high]널 정말 사랑해.[/love:high]"
쉼: 1.5초
청크 2: "[calm:medium]이제 쉬자.[/calm:medium]"

호흡 큐

명상 콘텐츠의 경우 호흡 지침 삽입:

청크 1: "[breathiness:low]천천히 들이마셔 보세요...[/breathiness:low]"
쉼: 3초 (들이쉬기)
청크 2: "[breathiness:low]그리고 그 숨을 내쉬어 보세요.[/breathiness:low]"
쉼: 4초 (내쉬기)

맥락 보존

청크 간 캐릭터와 장면 맥락 유지:

  • 누가 말하고 있는지 추적
  • 장면 설정 보존
  • 감정적 연속성 유지
  • 중요한 맥락 변화 기록

지침

  1. 콘텐츠 분석 - 문장, 감정 태그, 자연스러운 구분 식별
  2. 전략 선택 - 대부분의 콘텐츠는 문장 기반, 긴 내용은 단락 기반
  3. 감정 마크업 파싱 - 모든 여는 태그와 닫는 태그 식별
  4. 지능형 분할 - 문장 경계 우선, 태그 무결성 존중
  5. 청크 검증 - 크기 제한, 태그 완성, 가독성 확인
  6. 메타데이터 추가 - 청크 번호, 전체 개수, 타이밍 제안 포함
  7. 출력 형식화 - 메타데이터와 함께 청크 간 명확한 구분

출력 형식

=== TTS 청크 처리 결과 ===

전체 청크: 8
예상 음성 시간: 3분 45초

--- 청크 1/8 ---
문자 수: 147
이후 쉼: 0.5초
내용: [감정 마크업 및 텍스트]

--- 청크 2/8 ---
문자 수: 102
이후 쉼: 1.0초
내용: [감정 마크업 및 텍스트]

[모든 청크에 대해 계속...]

=== 처리 요약 ===
- 원본 길이: 1,234자
- 평균 청크 크기: 154자
- 보존된 감정 태그: 12/12
- 문장 경계 존중: 예
- TTS 처리 준비 완료: 예

참고 사항

  • 엄격한 크기 제한보다 내러티브 흐름을 항상 우선시
  • 청크 간 감정적 흐름 보존
  • 청크 간 권장 쉼 시간 포함
  • 실제 TTS로 테스트하여 타이밍 검증
  • TTS 서비스 요구 사항에 따라 청크 크기 조정
  • 원본 처리되지 않은 콘텐츠의 백업 유지
  • 디버깅을 위해 청크 메타데이터 추가 고려

관련 스킬