By name: mascot-run description: マスコットアプリとCOEIROINKの起動（セットアップ済み前提） user_invocable: true
/mascot-run - マスコットアプリ起動
セットアップ済みのマスコットアプリを起動する。
/tsukuyomi-setup が完了済みであることが前提。未セットアップの場合は /tsukuyomi-setup を案内する。
Usage
/mascot-run # マスコットを起動
/mascot-run --no-tts # COEIROINK チェックをスキップして起動
プラットフォーム判定
case "$(uname -s)" in
MINGW*|MSYS*|CYGWIN*) echo "WINDOWS" ;;
Darwin*) echo "MACOS" ;;
*) echo "LINUX" ;;
esac
実行手順
Step 1: マスコットが既に起動しているか確認
macOS / Linux:
pgrep -f "utsutsu_code" && echo "ALREADY_RUNNING" || echo "NOT_RUNNING"
Windows:
powershell -c "if (Get-Process mascot -ErrorAction SilentlyContinue) { 'ALREADY_RUNNING' } else { 'NOT_RUNNING' }"
ALREADY_RUNNING の場合 → 「マスコットは既に起動しています」と伝えて終了。再起動したい場合は /tsukuyomi-cleanup process で停止してから再実行を案内する。
Step 2: COEIROINK v2 の起動確認
--no-tts 引数がある場合はこのステップをスキップする。
curl -s --connect-timeout 2 http://localhost:50032/v1/speakers > /dev/null 2>&1 \
&& echo "COEIROINK_RUNNING" || echo "COEIROINK_NOT_RUNNING"
COEIROINK_NOT_RUNNING の場合:
macOS:
# アプリがインストールされているか確認
ls /Applications/COEIROINKv2.app > /dev/null 2>&1 && echo "INSTALLED" || echo "NOT_INSTALLED"
- インストール済み → 「COEIROINK v2 を起動してください」と案内。起動後に再度このスキルを実行するよう伝える
- 未インストール → 「COEIROINK v2 がインストールされていません。
/tsukuyomi-setupでセットアップしてください」と案内
Windows: ポートチェックのみ。未起動なら「COEIROINK v2 を起動してください」と案内。
COEIROINK なしでもマスコット自体は動作する（口パク・感情表現は動くが音声なし）。ユーザーが「音声なしでいい」と言った場合は次のステップに進む。
Step 3: セットアップ状態の簡易チェック
macOS / Linux:
# モデルまたはフォールバック画像があるか
(ls mascot/assets/models/blend_shape/*.inp 2>/dev/null || \
ls mascot/assets/models/parts/*.inp 2>/dev/null || \
ls mascot/assets/fallback/mouth_open.png 2>/dev/null) \
&& echo "ASSETS_OK" || echo "NO_ASSETS"
NO_ASSETS の場合 → 「モデルとフォールバック画像がありません。/tsukuyomi-setup を先に実行してください」と案内して終了。
Windows: リリース exe にアセットがバンドル済みのため、このチェックはスキップ。
Step 4: マスコットアプリを起動
macOS:
バックグラウンドで flutter run を実行する。ターミナルをブロックしないように & で起動:
cd mascot && flutter run -d macos &
起動メッセージを待ち、アプリウィンドウが表示されたことを確認する。
Windows:
リリース exe を使う。Flutter ビルド環境は不要。
- exe の場所を確認する:
# よくある配置先
ls ~/Desktop/utsutsu-code-windows/utsutsu_code.exe 2>/dev/null || \
ls ~/Downloads/utsutsu-code-windows/utsutsu_code.exe 2>/dev/null || \
echo "EXE_NOT_FOUND"
EXE_NOT_FOUNDの場合 → GitHub Releases からのダウンロードを案内:
python3 .claude/skills/tsukuyomi-setup/setup_helper.py check-release
リリースページ URL をブラウザで開く: start <URL>
- exe が見つかった場合 → 起動:
# パスは実際の場所に置き換える
start "" "<exe_path>"
Linux:
cd mascot && flutter run -d linux &
Step 5: 起動確認
マスコットが画面に表示されるまで数秒待つ。
macOS / Linux:
sleep 5 && pgrep -f "utsutsu_code" && echo "LAUNCH_OK" || echo "LAUNCH_FAILED"
Windows:
powershell -c "Start-Sleep 5; if (Get-Process mascot -ErrorAction SilentlyContinue) { 'LAUNCH_OK' } else { 'LAUNCH_FAILED' }"
LAUNCH_OK の場合 → 「マスコットが起動しました」と報告して終了。テストは行わない（テストしたい場合は /mascot-test を案内）。
LAUNCH_FAILED の場合 → トラブルシューティングを案内:
- 「
/tts-debugでTTSエンジンの状態を確認してください」 - 「
flutter doctorでFlutter環境を確認してください」（macOS/Linux）
関連スキル
/tsukuyomi-setup— フルセットアップ（初回）/tsukuyomi-cleanup— プロセス停止・リソース削除/mascot-test— 口パク・感情のテスト（TTS不要）/tts-debug— TTS問題の診断