# tsukuyomi-setup

> つくよみちゃんボイス(COEIROINK v2)セットアップ・テスト・口パク設定

- Author: sawarae
- Repository: sawarae/utsutsu-code
- Version: 20260209205323
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-09
- Source: https://github.com/sawarae/utsutsu-code
- Web: https://mule.run/skillshub/@@sawarae/utsutsu-code~tsukuyomi-setup:20260209205323

---

---
name: tsukuyomi-setup
description: つくよみちゃんボイス(COEIROINK v2)セットアップ・テスト・口パク設定
user_invocable: true
---

# /tsukuyomi-setup - つくよみちゃんボイスセットアップ

## 概要

COEIROINK v2 エンジンを使用したつくよみちゃんTTSのセットアップ、テスト、口パクマスコットとの連携設定を行う。

## 前提条件

- COEIROINK v2 (ポート50032)
- Python 3.x
- Flutter SDK (マスコットアプリ用)

## 実行手順

### Step 0: 前提条件チェック

各ツールがインストールされているか確認する。見つからないものがあれば、ユーザーに「インストールしていますか？」と確認してから次に進む。

**Python 3 チェック:**
```bash
python3 --version 2>/dev/null && echo "OK" || echo "NOT_FOUND"
```
見つからない場合 → ユーザーに「Python 3 がインストールされていないようです。インストールしていますか？」と聞く。

**Flutter チェック:**
```bash
which flutter 2>/dev/null && echo "OK" || echo "NOT_FOUND"
```
見つからない場合 → ユーザーに「Flutter SDK がインストールされていないようです。インストールしていますか？（マスコットアプリのビルドに必要です）」と聞く。
（注: `flutter --version` はSDK初期化で遅いため `which` で存在チェックのみ行う）

**COEIROINK v2 チェック:**

まずアプリの存在を確認し、次に起動状態を確認する（未インストール vs 未起動を区別）:
```bash
# 1. アプリがインストールされているか
ls /Applications/COEIROINKv2.app > /dev/null 2>&1 \
  && echo "INSTALLED" || echo "NOT_INSTALLED"

# 2. 起動しているか（インストール済みの場合のみ）
curl -s --connect-timeout 2 http://localhost:50032/v1/speakers > /dev/null 2>&1 \
  && echo "RUNNING" || echo "NOT_RUNNING"
```
- **未インストールの場合** → 「COEIROINK v2 がインストールされていないようです。https://coeiroink.com からダウンロードできます。インストールしていますか？」と聞く
- **インストール済みだが未起動の場合** → 「COEIROINK v2 がインストールされていますが起動していません。COEIROINKv2.app を起動してください」と案内する

**判定ルール:**
- Python 3 が無い場合: TTSもマスコットも動かないため、インストールを案内して中断
- Flutter が無い場合: マスコットアプリのビルド(Step 7)をスキップ可能。TTS部分のみセットアップを続行するか聞く
- COEIROINK v2 が未インストールの場合: https://coeiroink.com からダウンロードを案内
- COEIROINK v2 が未起動の場合: COEIROINKv2.app の起動を促す

すべての前提条件が揃っていることを確認してから Step 1 に進む。

### Step 1: COEIROINK v2 状態確認

```bash
curl -s --connect-timeout 2 http://localhost:50032/v1/speakers > /dev/null 2>&1 \
  && echo "COEIROINK v2 is running" \
  || echo "COEIROINK v2 is NOT running"
```

起動していない場合:
- macOS: COEIROINKv2.app を開く
- デフォルトポート 50032 で起動しているか確認

### Step 2: つくよみちゃんスピーカー確認

```bash
curl -s http://localhost:50032/v1/speakers | python3 -c "
import json, sys
speakers = json.load(sys.stdin)
found = False
for s in speakers:
    if 'つくよみ' in s.get('speakerName', ''):
        styles = ', '.join(f'{st[\"styleName\"]}(id={st[\"styleId\"]})' for st in s['styles'])
        print(f'Found: {s[\"speakerName\"]} (uuid={s[\"speakerUuid\"]})')
        print(f'  Styles: {styles}')
        found = True
if not found:
    print('つくよみちゃん not found. Install voice data in COEIROINK v2.')
    print('Available speakers:')
    for s in speakers:
        print(f'  {s[\"speakerName\"]}')
"
```

つくよみちゃんのデフォルトスタイル:
| スタイル | styleId |
|---------|---------|
| れいせい | 0 |

### Step 3: TTS config 設定

```bash
cat > .claude/hooks/tts_config.toml << 'TOML'
# Tsukuyomi via COEIROINK v2
engine = "coeiroink"
speaker_name = "つくよみ"
TOML
```

### Step 3.5: グローバルフックのデプロイ

`~/.claude/hooks/` にTTSスクリプトと設定を配置する。ユーザーに「シンボリックリンクとコピー、どちらにしますか？」と聞く。

**選択肢A: シンボリックリンク（推奨）**

リポジトリのファイルを直接参照するため、更新が自動反映される:
```bash
mkdir -p ~/.claude/hooks ~/.claude/skills
# フック
ln -sf "$(pwd)/.claude/hooks/mascot_tts.py" ~/.claude/hooks/mascot_tts.py
ln -sf "$(pwd)/.claude/hooks/tts_config.toml" ~/.claude/hooks/tts_config.toml 2>/dev/null || \
  cp .claude/hooks/tts_config.toml ~/.claude/hooks/tts_config.toml
# スキル
for skill in tsukuyomi-setup tsukuyomi-cleanup tts tts-debug; do
  ln -sf "$(pwd)/.claude/skills/$skill" ~/.claude/skills/$skill
done
```

**選択肢B: コピー**

リポジトリに依存しない独立したコピーを作成する（リポジトリを移動/削除しても動作する）:
```bash
mkdir -p ~/.claude/hooks
cp .claude/hooks/mascot_tts.py ~/.claude/hooks/mascot_tts.py
cp .claude/hooks/tts_config.toml ~/.claude/hooks/tts_config.toml 2>/dev/null || true
# スキルはコピー不要（プロジェクト内の .claude/skills/ がそのまま使われる）
```

**確認:**
```bash
python3 ~/.claude/hooks/mascot_tts.py --emotion Gentle "グローバルフックのテスト"
```

### Step 4: フォールバック画像のセットアップ

utsutsu2d モデル (.inp) が既にある場合はこのステップをスキップする:
```bash
ls mascot/assets/models/blend_shape/model.inp 2>/dev/null || ls mascot/assets/models/parts/model.inp 2>/dev/null
```

.inp が無い場合のみ、フォールバック用の口パク画像をダウンロードする:
```bash
cd mascot && make setup-fallback
```

これにより `mascot/assets/fallback/mouth_open.png` と `mouth_closed.png` がダウンロードされ、マスコットはこの2枚絵で口パクする。

### Step 5: モデルディレクトリのセットアップ

```bash
cd mascot && make setup-models
```

utsutsu2d モデルファイルがある場合:
```bash
cp /path/to/tsukuyomi_blend_shape.inp mascot/assets/models/blend_shape/model.inp
# または
cp /path/to/tsukuyomi_parts.inp mascot/assets/models/parts/model.inp
```

### Step 6: TTS テスト

```bash
# プロジェクトのディスパッチャ経由
python3 .claude/hooks/mascot_tts.py --emotion Gentle "つくよみちゃんのテストです"
python3 .claude/hooks/mascot_tts.py --emotion Joy "テスト成功だよ"
python3 .claude/hooks/mascot_tts.py --emotion Trouble "テスト失敗だよ"

# グローバルhook経由
python3 ~/.claude/hooks/mascot_tts.py --emotion Gentle "グローバルフックのテスト"
```

各テストで:
- 音声が再生されること
- シグナルファイル `~/.claude/utsutsu-code/mascot_speaking` が一時的に作成されること
- マスコットアプリが起動中なら口パクと吹き出しが表示されること

### Step 7: マスコットアプリ起動テスト

```bash
cd mascot && flutter run -d macos
```

アプリが起動したら、別ターミナルでTTSテスト:
```bash
python3 .claude/hooks/mascot_tts.py --emotion Joy "マスコット動いてるよ"
```

確認ポイント:
- 口パク（mouth_open/closed が150ms間隔で切り替わる）
- 吹き出しにメッセージが表示される
- 音声再生終了後に吹き出しがフェードアウトする

### Step 8: settings.json 確認

#### プロジェクト設定（`.claude/settings.json`）

セッション終了時に自動でTTSを発火するStop hookが設定されているか確認:
```bash
cat .claude/settings.json
```

期待される内容:
```json
{
  "hooks": {
    "Stop": [
      {
        "matcher": "",
        "hooks": [
          {
            "type": "command",
            "command": "python3 ~/.claude/hooks/mascot_tts.py --emotion Joy \"タスク完了しました\"",
            "timeout": 5000
          }
        ]
      }
    ]
  }
}
```

#### グローバル設定（`~/.claude/settings.json`）

他のプロジェクトでもTTS通知を使うために、グローバル設定にも同じhookを追加する:
```bash
cat ~/.claude/settings.json
```

`hooks.Stop` セクションが無い、または `osascript` のみの場合は、上記と同じStop hookを追加する。

**注意点:**
- コマンドのパスは必ず `~/.claude/hooks/mascot_tts.py` を使う（相対パスだとCWDによって壊れる）
- `timeout: 5000` を必ず設定する（TTSがClaude Codeをブロックしないように）
- タイムアウト内訳: 可用性チェック(1秒) + 音声合成(4秒)。再生はバックグラウンド

### Step 9: グローバル CLAUDE.md の設定

`~/.claude/CLAUDE.md` にTTS指示が無いと、Claude Codeが作業開始・完了時にマスコットを呼ばない。

確認:
```bash
grep -q "mascot_tts.py" ~/.claude/CLAUDE.md 2>/dev/null && echo "OK" || echo "NOT_FOUND"
```

無い場合、以下の内容を `~/.claude/CLAUDE.md` に追記するようユーザーに案内する:

```
+ 作業開始時と作業完了時に `python3 ~/.claude/hooks/mascot_tts.py --emotion KEY "要約(30文字以内)"` でつくよみちゃんに読み上げさせる。感情キーは `mascot/emotions.toml` を参照（Gentle=通常, Joy=成功, Blush=照れ, Trouble=エラー, Singing=お祝い）。例: 開始時 `python3 ~/.claude/hooks/mascot_tts.py --emotion Gentle "透過の修正を始めます"` 、完了時 `python3 ~/.claude/hooks/mascot_tts.py --emotion Joy "コミット完了しました"` 。COEIROINK v2未起動時はosascript通知にフォールバック。要約にアルファベットは使わず、日本語かカタカナ英語で書く（例: commit→コミット、README→リードミー）
```

**重要:** `~/.claude/CLAUDE.md` はユーザーのプライベート設定なので、勝手に書き換えず「この内容を追記してください」と案内する。

## トラブルシューティング

1. **COEIROINK v2 が起動していない**
   - COEIROINKv2.app を起動する
   - ポート確認: `lsof -i :50032`

2. **つくよみちゃんが見つからない**
   - COEIROINK v2 でボイスデータをインストール
   - Step 2 でスピーカー一覧を確認

3. **音声が再生されない**
   - macOS の音量設定を確認
   - `which afplay` で afplay が使えるか確認

4. **マスコットが口パクしない**
   - シグナルディレクトリ確認: `ls ~/.claude/utsutsu-code/`
   - マスコットのポーリング間隔は100ms
   - ログ確認: `cat ~/.claude/logs/mascot_tts.log`

5. **フォールバック画像が表示されない**
   - `ls mascot/assets/fallback/` で画像があるか確認
   - なければ `cd mascot && make setup-fallback` を実行

## ファイル配置

正のソースはリポジトリ内。`~/.claude/` にはシンボリックリンクを置く。

### リポジトリ内（正のソース）

| ファイル | 説明 |
|---------|------|
| `.claude/hooks/mascot_tts.py` | 汎用TTSディスパッチャ |
| `.claude/hooks/tts_config.toml` | TTS設定（speaker_name等） |
| `.claude/hooks/tts_config.example.toml` | 設定例 |
| `mascot/emotions.toml` | 感情キー定義 |
| `mascot/config/examples/blend_shape.toml` | ブレンドシェイプモデル設定例 |
| `mascot/config/examples/parts.toml` | パーツモデル設定例 |
| `mascot/assets/fallback/` | フォールバック口パク画像 |
| `mascot/assets/models/` | utsutsu2dモデルディレクトリ |
| `.claude/skills/` | スキル定義（コミット対象） |

### グローバル（シンボリックリンク）

| リンク | リンク先 |
|--------|---------|
| `~/.claude/hooks/mascot_tts.py` | → `.claude/hooks/mascot_tts.py` |
| `~/.claude/hooks/tts_config.toml` | → `.claude/hooks/tts_config.toml` |
| `~/.claude/skills/*` | → `.claude/skills/*` |

### Makefile ターゲット

| ターゲット | 内容 |
|-----------|------|
| `make setup` | モデル + フォールバック画像のダウンロード |
| `make clean` | ビルド + シグナル削除（安全） |
| `make clean-assets` | モデル・画像を削除（要 `make setup` で再取得） |
| `make clean-hooks` | グローバルフックを削除（要 `/tsukuyomi-setup` で再作成） |

## 関連スキル

- `/tsukuyomi-cleanup` — クリーンアップ
- `/tts-debug` — TTS問題の診断
- `/tts` — TTS手動実行

## クレジット

COEIROINK v2: つくよみちゃん