claude-voice-notify: Instructions file for Claude Code

claude-voice-notify

音声コマンド

NOTIFY="/Users/kubouchiyuya/Projects/claude-voice-notify/notify.sh"

# 読み上げ
$NOTIFY "メッセージ"                          # デフォルトキャラで読み上げ
$NOTIFY "メッセージ" complete 3 1.2           # タイプ/スピーカーID/速度指定

# キャラ管理
$NOTIFY list                                  # VOICEVOXキャラ一覧（★=現在）
$NOTIFY set-speaker 8                         # デフォルトキャラ変更（例: 春日部つむぎ）
$NOTIFY set-speed 1.2                         # デフォルト速度変更
$NOTIFY set-volume 0.5                        # デフォルト音量変更（0.0〜1.0）

# プロバイダー切り替え
$NOTIFY set-provider voicevox                 # VOICEVOX（デフォルト）
$NOTIFY set-provider google                   # Google Cloud TTS
$NOTIFY set-google-key <API_KEY>              # Google APIキー設定
$NOTIFY set-google-voice ja-JP-Neural2-B      # Google音声名変更

# オン/オフ
$NOTIFY on / off / status

# 設定パネル（キャラ・速度・音量・方言・エンジン）
/Users/kubouchiyuya/Projects/claude-voice-notify/settings.sh

VS Code からの設定アクセス

• Cmd+Shift+P → 「Tasks: Run Task」→「⚙️ VB設定パネル」
• または settings.sh を直接実行

絶対に音声で通知する場面（必須・スキップ不可）

以下の場面では、音声通知がONである限り必ずnotify.shを呼ぶこと。

1. タスク開始時 — 指示を受けたら、作業前に「これから何をするか」を宣言する
2. 作業が止まる時 — ユーザーの入力・判断待ちで開発が停止する全ての場面
3. 承認・許可を求める時 — ファイル削除、デプロイ、破壊的変更の前
4. 選択肢を提示する時 — 複数のアプローチからユーザーに選んでもらう時
5. タスク完了時 — 一連の作業が終わった時（必ず完了報告する）
6. エラー発生時 — ビルドエラー、実行エラー、接続エラー等

# タスク開始時（必須）
notify.sh "了解しました。これからログイン機能を実装します"
notify.sh "バグの調査を開始します。まずエラーログを確認します"

# 作業が止まる時（必須）
notify.sh "作業が止まっています。APIキーが必要です。設定してもらえますか？" confirm
notify.sh "質問があります。テストデータはどのような形式にしますか？" confirm

# 承認を求める時（必須）
notify.sh "確認です。本番環境にデプロイしますか？この操作は取り消せません" confirm

# 完了報告（必須）
notify.sh "ログイン機能の実装が完了しました。JWT認証を使っています"

# 選択肢がある時（必須）
notify.sh "2つの方法があります。どちらにしますか？" confirm

音声通知ルール

タスク完了時 — 具体的に何をしたか説明する

notify.sh "ログイン機能の実装が完了しました。JWT認証を使っています"  # 良い
notify.sh "タスクが完了しました"  # ← 禁止。汎用メッセージは使わない

確認・質問時 — 何を確認したいか明確に

notify.sh "確認です。データベースのテーブルを削除してよいですか？" confirm

エラー時 — 原因と対処を説明

notify.sh "ビルドエラーです。型エラーが3件あります" error