mcpField
U
upgrade

upgrade

github.com/terrylica開発142 回インストール今日更新
リポジトリ

upgrade について

upgradeは、Kokoro TTS環境を保守するスキルです。MLX-Audioの依存関係、モデル、同梱スクリプトを更新し、結果の確認やロールバック、トラブルシューティングも案内します。

主な機能

  1. 01アップグレード前後のヘルスチェック
  2. 02依存関係、モデル、スクリプトの更新
  3. 03バージョン情報の更新
  4. 04クリーン再インストールによるロールバック
  5. 05アップグレード時のトラブルシューティング

活用シーン

  1. 01Kokoro TTS環境の更新
  2. 02アップグレード後の音声合成確認
  3. 03失敗または非互換な更新からの復旧

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/terrylica/cc-skills --skill upgrade

インストール後、Claude Code で/upgradeを入力して読み込まれたか確認します。

詳細

Kokoro TTS をアップグレードする

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

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

ワークフロー

ステップ 1：アップグレード前のヘルスチェック
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --health
cat ~/.local/share/kokoro/version.json
ステップ 2：アップグレードを実行する
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --upgrade

次の項目がアップグレードされます：

  • Python パッケージ：mlx-audio、soundfile、numpy
  • モデルの重み：mlx-community/Kokoro-82M-bf16 から再ダウンロード
  • 同梱スクリプト：プラグインから kokoro_common.py と tts_generate.py を再コピー
  • version.json：新しいバージョンで書き換え
ステップ 3：アップグレード後の検証
PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/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 が動作しなくなった場合は、クリーンインストールを実行してください：

PLUGIN_DIR="${CLAUDE_PLUGIN_ROOT:-$HOME/.claude/plugins/marketplaces/cc-skills/plugins/kokoro-tts}"
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --uninstall
bash "$PLUGIN_DIR/scripts/kokoro-install.sh" --install

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

トラブルシューティング

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

実行後の振り返り

このスキルの実行が完了したら、タスクを終了する前に振り返ってください：

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

先送りしないでください。次回の実行では、ここに残した状態が引き継がれます。

コメント

Markdown 対応