augment

Kokoro TTS を拡張する

MLX-Audio の依存関係をアップグレードし、モデルを再ダウンロードして、同梱スクリプトを更新します。

自己進化するスキル：このスキルは使用するたびに改善されます。手順に誤りがある、パラメーターにずれがある、回避策が必要だった場合は、先延ばしにせず、すぐにこのファイルを修正してください。実際に再現できる問題がある場合にのみ更新してください。

ワークフロー

ステップ 1：アップグレード前のヘルスチェック

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

ステップ 2：アップグレードを実行

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --upgrade

これにより、次の項目がアップグレードされます。

• Python パッケージ：mlx-audio、soundfile、numpy
• モデルの重み：mlx-community/Kokoro-82M-bf16 から再ダウンロード
• 同梱スクリプト：プラグインから kokoro_common.py と tts_generate.py を再コピー
• version.json：新しいバージョンで書き換え

ステップ 3：アップグレード後の検証

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json

# Test synthesis
~/.local/share/kokoro/.venv/bin/python ~/.local/share/kokoro/tts_generate.py \
  --text "Upgrade verification" --voice af_heart --lang en-us --speed 1.0 \
  --output /tmp/kokoro-upgrade-test.wav && echo "OK"

ロールバック

アップグレードによって TTS が動作しなくなった場合は、クリーンインストールを実行してください。

ROOT="$(cc-plugin-root kokoro-tts)"
bash "$ROOT/scripts/kokoro-install.sh" --uninstall
bash "$ROOT/scripts/kokoro-install.sh" --install

モデルのキャッシュはアンインストールしても保持されるため、再インストール時にキャッシュ済みモデルが再利用されます。

トラブルシューティング

問題	原因	解決策
アップグレードに失敗する	インターネットに接続されていない、または PyPI がダウンしている	接続を確認して、再試行してください
アップグレード後にインポートエラーが発生する	mlx-audio の互換性がない	クリーンインストール：--uninstall の後に --install を実行
モデルのダウンロードが遅い	ダウンロードするファイルが大きい	HuggingFace のダウンロードが完了するまでお待ちください

実行後の振り返り

このスキルの実行後、タスクを終了する前に振り返ってください。

0. 現在の場所を特定する。 — 編集する前に、この SKILL.md の正規のパスを確認してください。
1. 何が失敗したか？ — 原因となった手順を修正してください。
2. 予想以上にうまくいったことは？ — 推奨される方法として取り入れてください。
3. 何がずれていたか？ — 現状と一致しなくなったスクリプト、参照先、依存関係を修正してください。
4. 記録する。 — 発生のきっかけ、修正内容、根拠を進化ログに記録してください。

先延ばしにしてはいけません。次回の実行には、ここに残した内容が引き継がれます。