voice-quality-audition について
Kokoro TTS の音声を試聴・比較し、プロジェクトで使う音声を選ぶためのスキルです。テキストを各音声で順に再生し、クリップボードの文章または既定の文章を使えます。Apple Silicon 搭載 Mac 向けです。
主な機能
- 01Kokoro の音声を順番に試聴
- 02クリップボードまたは既定の文章を使用
- 03音声を選んで試聴
- 04好みを確認し既定音声を任意で更新
活用シーン
- 01プロジェクト用の音声を比較
- 02カスタム文章を複数の音声で確認
- 03Kokoro 更新後に音声を再評価
- 04英語または中国語の既定音声を選択
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/voice-quality-auditionを入力して読み込まれたか確認します。
同梱ファイルreferences/evolution-log.mdreferences/voice-catalog.md
詳細
音声品質の試聴
利用可能なすべての音声で Kokoro TTS の音声品質を比較します。tts_kokoro_audition.sh を実行し、上位の音声それぞれで一節を再生します。各音声は、一節を読み上げる前に自分の名前を告げます。クリップボードのテキスト、または既定の一節を使用します。
プラットフォーム：macOS（Apple Silicon）
自己進化型スキル：このスキルは使用を通じて改善されます。手順に誤りがある、パラメーターが変わっている、または回避策が必要だった場合は、先延ばしにせず、このファイルをすぐに修正してください。実際に再現可能な問題がある場合にのみ更新してください。
このスキルを使用する場面
- 利用可能なすべての Kokoro 音声を試聴して、品質の違いを確認する
- プロジェクトで使用する特定の音声を並べて比較する
- Kokoro エンジンのアップグレード後に音声の評価を見直す
- TTS_VOICE_EN または TTS_VOICE_ZH の新しい既定の音声を選ぶ
- 特定の一節を複数の音声で再生して確認する
要件
- Kokoro TTS エンジンがインストールされ、正常に動作していること（
kokoro-install.sh --health） - MLX Metal が利用可能な Apple Silicon 搭載 Mac
afplayが利用可能であること（macOS に付属）- プラグインの
scripts/tts_kokoro_audition.shに試聴スクリプトがあること - プラグインの
scripts/lib/tts-common.shに共有ライブラリがあること
音声カタログ
| 音声 ID | 名前 | 評価 | 性別 |
|---|---|---|---|
| af_heart | Heart | A | 女性 |
| af_bella | Bella | A- | 女性 |
| af_nicole | Nicole | B- | 女性 |
| af_aoede | Aoede | C+ | 女性 |
| af_kore | Kore | C+ | 女性 |
| af_sarah | Sarah | C+ | 女性 |
| am_adam | Adam | F+ | 男性 |
| am_michael | Michael | 未評価 | 男性 |
| am_echo | Echo | D | 男性 |
| am_puck | Puck | 未評価 | 男性 |
現在の既定値（~/.claude/automation/claude-telegram-sync/mise.toml で設定）：
- 英語の音声：
af_heart（評価 A）、TTS_VOICE_ENで指定 - 中国語の音声：
zf_xiaobei、TTS_VOICE_ZHで指定 - macOS
sayの英語フォールバック：Samantha、TTS_VOICE_SAY_ENで指定 - macOS
sayの中国語フォールバック：Ting-Ting、TTS_VOICE_SAY_ZHで指定
詳しい特徴と評価基準については、音声カタログを参照してください。
ワークフローの段階
段階 1：事前確認
Kokoro がインストールされ、正常に動作していることを確認します。
kokoro-install.sh --health
6 項目すべて（venv、Python 3.14、mlx_audio のインポート可否、kokoro_common.py、tts_generate.py、version.json）に合格する必要があります。
段階 2：テキストの選択
試聴スクリプトは macOS のクリップボード（pbpaste）から読み取ります。クリップボードが空、またはテキストでない場合は、ライブラリでの読書についての組み込みの一節に切り替わります。
カスタムテキストを試聴するには、実行前に希望する一節をクリップボードにコピーしてください。
段階 3：ユーザーに確認 — 全音声または選択試聴
AskUserQuestion を使って、試聴の範囲を確認します。
- 全音声を試聴 — 10 音声すべてを順番に再生します（数分かかります）
- 特定の音声を選択 — 一部の音声のみを実行します（例：上位 3 つの女性音声）
選択試聴を行う場合は、スクリプト内の VOICES 配列を編集するか、音声 ID を手動で渡します。
段階 4：試聴の実行
~/.local/bin/tts_kokoro_audition.sh
または、プラグインのソースから直接実行します。
/path/to/plugins/tts-tg-sync/scripts/tts_kokoro_audition.sh
スクリプトは TTS ロックを取得し、各音声を 1 秒間隔で順番に再生してから、終了時にロックを解放します。
段階 5：フィードバック
AskUserQuestion を使って、ユーザーの好みを確認します。
- どの音声が最も良かったですか？
- 今後の候補から外したい音声はありますか？
- 評価の割り当てを更新しますか？
段階 6：設定の適用
必要に応じて、mise.toml の既定の音声を更新します。
# ~/.claude/automation/claude-telegram-sync/mise.toml
[env]
TTS_VOICE_EN = "af_heart" # Change to preferred voice ID
TTS_VOICE_ZH = "zf_xiaobei"
mise.toml を変更した後は、新しい音声を反映するために Telegram ボットを再起動してください。
TodoWrite タスクテンプレート
1. [Preflight] Verify Kokoro TTS is installed and healthy (kokoro-install.sh --health)
2. [Text] Check clipboard for passage, fall back to default if empty
3. [Select] Ask user: full audition (all 10 voices) or specific voices
4. [Audition] Run tts_kokoro_audition.sh and let user listen
5. [Feedback] Ask user which voice they prefer and collect grade feedback
6. [Apply] Optionally update TTS_VOICE_EN in mise.toml and restart bot
変更後のチェックリスト
- 試聴前に Kokoro のヘルスチェックに合格した
- 選択したすべての音声がエラーなく再生された
- ユーザーが希望する音声を確認した
- mise.toml を新しい音声 ID で更新した（変更した場合）
- 設定変更後にボットを再起動した（該当する場合）
- 参照ドキュメントの音声カタログの評価を更新した（再評価した場合）
トラブルシューティング
| 問題 | 原因 | 解決策 |
|---|---|---|
| 音声が再生されない | Kokoro がインストールされていない | kokoro-install.sh --install を実行するか、full-stack-bootstrap スキルを使用します |
| 音声が文の途中で途切れる | 別のプロセスに TTS ロックを奪われた | 競合する TTS プロセスを確認します：pgrep -la afplay |
| 音声が正しく聞こえない | Kokoro モデルの音声 ID が無効 | 音声 ID が VOICES 配列に存在することを確認し、Kokoro のバージョンを確認します |
| クリップボードが空 | テキストがコピーされていない | スクリプトがデフォルトの文章を自動的に使用するため、操作は不要です |
| "ERROR: Local Kokoro not found" | 仮想環境またはスクリプトがない | 原因を診断するには kokoro-install.sh --health を、修正するには --install を実行します |
| 特定の音声で FAILED になる | モデルでその音声を利用できない | 別の Kokoro バージョンが必要な場合があります。モデルの互換性を確認してください |
| ロックが解放されない | クリーンアップ前にスクリプトがクラッシュした | 古いロックを削除します：rm -f /tmp/kokoro-tts.lock |
| すべての音声が同じように聞こえる | Kokoro モデルが正しく読み込まれていない | モデルを再ダウンロードします：kokoro-install.sh --upgrade |
参考ドキュメント
実行後の振り返り
このスキルの実行が完了したら、タスクを終了する前に振り返ります：
- 現在位置を特定します。 — 編集する前に、この SKILL.md の正式なパスを（このスキル名で Glob を実行して）見つけます。すべての修正対象はこのファイルと同階層の references/ です。他のドキュメントは対象にしません。
- 何が失敗しましたか？ — 原因となった指示を修正します。再発する可能性がある場合は、アンチパターンとして追加します。
- 予想以上にうまくいったことは何ですか？ — 推奨プラクティスにします。その理由も記録します。
- 何が現状と乖離しましたか？ — 実態と一致しなくなったスクリプト、参考資料、外部依存関係は、今すぐ修正します。
- 記録します。 — 変更のたびに、きっかけ、修正内容、根拠を含む変更履歴の項目を追加します。
先送りしないでください。次回の実行には、ここに残した状態が引き継がれます。