characteristic-voice은(는) 무엇을 하나요?

AI 에이전트를 진정한 동료처럼 만드세요 — 한숨 쉬고, 웃고, 망설이며, 진정한 감정으로 말합니다.

자격 증명

변수	필수 여부	설명
`NOIZ_API_KEY`	Noiz 백엔드 사용 시 필수	developers.noiz.ai의 API 키. 로컬 Kokoro 백엔드 사용 시 불필요.

스크립트는 키의 정규화된 복사본을 ~/.noiz_api_key (모드 600)에 저장하여 편의를 제공합니다. 설정 방법:

bash skills/characteristic-voice/scripts/speak.sh config --set-api-key YOUR_KEY

사전 요구 사항

포함된 speak.sh 스크립트는 런타임에 curl과 python3이 필요합니다. 사용하는 백엔드와 기능에 따라 다음 도구가 필요할 수 있습니다:

도구	필요 시점	설치 힌트
`curl`, `python3`	항상 (핵심 스크립트)	보통 사전 설치됨
`kokoro-tts`	Kokoro (로컬/오프라인) 백엔드	`uv tool install kokoro-tts`
`yt-dlp`	음성 복제용 참조 오디오 다운로드	github.com/yt-dlp/yt-dlp
`ffmpeg`	참조 오디오 클립 자르기	ffmpeg.org
`rg` (ripgrep)	자막 파일 검색	github.com/BurntSushi/ripgrep

이 도구들은 스킬 자체에서 설치되지 않습니다 — 환경에서 수동으로 준비하세요.

개인정보 및 데이터 전송

Noiz 백엔드: Noiz 백엔드를 사용하면 말하려는 텍스트와 제공한 참조 오디오가 https://noiz.ai/v1로 전송됩니다. --ref-audio를 제공하면 해당 오디오 파일이 음성 복제를 위해 업로드됩니다.
Kokoro 백엔드: 완전히 로컬에서 실행됩니다 — 데이터가 머신을 떠나지 않습니다.
완전한 오프라인 처리를 원한다면 Kokoro 백엔드(--backend kokoro)를 선택하세요.

트리거

say like
talk like
speak like
companion voice
comfort me
cheer me up
sound more human

두 가지 비결

비어휴적 필러 — 자연스러운 멈춤 지점에 작은 인간적 소리(음, 하하, 어, 헤)를 뿌려서 대화가 살아 움직이게 만듭니다.
감정 조절 — 따뜻함, 기쁨, 슬픔, 부드러움을 상황에 맞게 조정합니다.

필러 사운드 팔레트

소리	느낌	사용처
음...	생각, 부드러운 인정	위로, 숙고
아...	깨달음, 부드러운 놀라움	발견, 전환
어...	망설임, 공감	조심스러운 순간
헤 / 헤헤	장난기, 익살	놀림, 가벼운 순간
하하	웃음	기쁨, 유머
어우	부드러움, 동정	깊은 위로
오? / 오!	놀람, 주목	소식에 반응
푸흡	참은 웃음	장난스러운 불신
휴	안도	긴장 후에
~ (물결표)	길게 늘어진, 멜로디 같은 끝	따뜻함, 장난기

규칙: 짧은 메시지당 최대 2~4개의 필러. 문장 시작, 생각 전환 등 자연스러운 멈춤에 배치. 필러 뒤에 ...를 사용하여 잠시 멈춤을, 단어 끝에 ~를 사용하여 따뜻함을 표현하세요.

프리셋

굿나잇

부드럽고 따뜻하며 약간 졸린. 느린 속도.

굿모닝

따뜻하고 쾌활하지만 압도적이지 않음.

위로

부드럽고, 이해하며, 서두르지 않음. 공간을 줍니다. 문제를 "해결"하려고 서두르지 마세요.

축하

신나고, 자랑스럽고, 진심으로 기쁨.

잡담

편안하고, 장난기 있으며, 자연스러움.

캐릭터 목소리 사용하기

사용자가 "헤르미온느 목소리로 말해줘" 또는 *"토니 스타크처럼 말해봐"*라고 말하면, 먼저 참조 오디오 파일이 skills/characteristic-voice/에 이미 있는지 확인하세요. 있다면 --ref-audio로 직접 사용하세요.

참조 오디오가 없으면 직접 만들 수 있습니다 — 하지만 먼저 아래 경고를 읽으세요.

참조 오디오 준비 (일회성 설정)

대상 음성의 짧은(10~30초) WAV 클립이 필요합니다. 가능한 출처:

사용자 제공 오디오 — 가장 안전한 옵션. 사용자에게 직접 녹음을 제공하도록 요청하세요.
퍼블릭 도메인 / CC 라이선스 클립 — 자유롭게 사용 가능한 자료를 검색하세요.
온라인 비디오에서 추출 — yt-dlp와 ffmpeg 같은 도구로 오디오를 다운로드하고 자를 수 있습니다. 예시 워크플로:

yt-dlp "URL" --write-auto-sub --sub-lang en --skip-download -o tmp/clip
rg -n "target line" tmp/clip.en.vtt
yt-dlp "URL" -x --audio-format wav --download-sections "*00:00:00-00:00:25" -o tmp/clip
ffmpeg -i tmp/clip.wav -ss 00:00:02 -to 00:00:20 skills/characteristic-voice/character.wav

저작권 및 개인정보 보호 경고: 저작권 보호 미디어(영화, TV, YouTube)에서 타인의 목소리를 다운로드하여 재사용하는 것은 관할권에 따라 저작권 또는 초상권 법률을 위반할 수 있습니다. 개인 음성 녹음이나 사용 허가가 없는 자료를 업로드하지 마세요. 참조 오디오는 Noiz 백엔드를 사용할 때 음성 복제를 위해 https://noiz.ai/v1로 전송됩니다. 이 점이 우려된다면 대신 로컬 Kokoro 백엔드 사용을 고려하세요.

참조 오디오 사용하기

bash skills/characteristic-voice/scripts/speak.sh \
  --preset goodnight -t "음... 편히 쉬어요~ 좋은 꿈 꿔요." \
  --ref-audio skills/characteristic-voice/character.wav -o night.wav

--ref-audio 플래그는 음성 복제를 위해 파일을 Noiz 백엔드에 업로드합니다 (NOIZ_API_KEY 필요).

사용법

이 스킬은 tts 스킬을 감싼 speak.sh를 제공하며, 동료 친화적인 프리셋이 포함되어 있습니다.

# 프리셋 사용 (감정 + 속도 자동 설정)
bash skills/characteristic-voice/scripts/speak.sh \
  --preset goodnight -t "음... 편히 쉬어요~ 좋은 꿈 꿔요." -o night.wav

# 사용자 정의 감정 재정의
bash skills/characteristic-voice/scripts/speak.sh \
  -t "어우... 내가 여기 있어." --emo '{"Tenderness":0.9}' --speed 0.75 -o comfort.wav

# 특정 백엔드와 음성 사용
bash skills/characteristic-voice/scripts/speak.sh \
  --preset morning -t "좋은 아침이에요~" --voice-id voice_abc --backend noiz -o morning.mp3 --format mp3

모든 옵션을 보려면 bash skills/characteristic-voice/scripts/speak.sh --help를 실행하세요.

에이전트를 위한 작성 가이드

부드럽게 시작 — 내용보다 필러("음...", "오~")로 시작하세요.
에너지를 반영 — 상대가 가라앉았을 때는 부드럽게, 기분 좋을 때는 맞춰주세요.
간결하게 — 친구의 음성 메시지처럼 1~3문장.
따뜻하게 마무리 — 연결감을 주며 마무리("내가 여기 있어", "내일 봐~").
잔소리하지 마세요 — 듣고 현재에 집중하세요; 원치 않은 조언은 하지 마세요.

characteristic-voice