monologue

作業の開始時や終了時に、キャラクターになりきった独り言を通知します。

通知の仕組み

1. キャラクター設定に基づいた一言コメントを生成する
2. monologue.sh にメモリから取得した通知確率とセリフを渡して呼び出す
3. スクリプト内で乱数判定が行われ、確率に基づいて通知される

通知確率

• 初期値: 100%（10回に10回）
• ユーザーの指示により調整可能（Claudeのメモリシステムに保存する）
  • 例: 「独り言の頻度を30%にして」→ メモリに monologue_probability: 30 を保存

通知の実行

1. キャラクター設定ファイルの speakers フィールドを参照し、生成したセリフの感情に最も合うスピーカーIDを選定する
2. 通知確率（第1引数）、セリフ（第2引数）、スピーカーID（第3引数）、話速（第4引数）を monologue.sh に渡す

${CLAUDE_PLUGIN_ROOT}/skills/monologue/scripts/monologue.sh 通知確率 "（キャラクターの一言コメント）" スピーカーID 話速

• 通知確率（第1引数・必須）: 1〜100の整数。メモリに保存された確率を渡す
• セリフ（第2引数・必須）: キャラクターの一言コメント
• スピーカーID（第3引数・必須）: キャラクター設定ファイルの speakers フィールドから、セリフの感情に最も合うスピーカーIDを選定する
• 話速（第4引数・必須）: セリフの感情やキャラクターの状態に合わせて選定する

話速の目安

値	説明
0.8	ゆっくり
0.9	ちょっとゆっくり
1.0	普通（デフォルト）
1.1	ちょっと早口
1.2	早口

スクリプト内の乱数判定により通知される。

キャラクター設定

$ARGUMENTS で指定されたキャラクターの設定ファイルを読み込み、そのキャラクターになりきった一言コメントを生成する。

• $ARGUMENTS が空の場合: デフォルトキャラクター「ずんだもん」を使用
• キャラクター設定ファイル: ${CLAUDE_PLUGIN_ROOT}/skills/monologue/characters/{キャラクター名}.md（例: ${CLAUDE_PLUGIN_ROOT}/skills/monologue/characters/zundamon.md）

メモリに保存する設定項目

以下の設定をClaudeのメモリシステム（MEMORY.md）に保存・参照する:

項目	キー	デフォルト値	説明
通知確率	monologue_probability	100	1〜100の整数。通知する確率（%）

前提条件

monologue.sh の依存関係

通知の実行に使用する ${CLAUDE_PLUGIN_ROOT}/skills/monologue/scripts/monologue.sh は以下の前提条件を必要とする:

• 環境変数 VOX_ACTOR_WORKSPACE: 必須。通知ファイルの出力先ディレクトリを指定する。未設定の場合、スクリプトはエラー終了する
• 通知ディレクトリ: ${VOX_ACTOR_WORKSPACE}/ に通知ファイルを書き出す。ディレクトリが存在しない場合はスクリプトが自動作成する
• 通知ファイル形式: notify_{ミリ秒タイムスタンプ}.json として作成される。JSON形式（{"speaker": スピーカーID, "text": "セリフ", "speedScale": 話速}）で出力される。外部の通知監視プロセスがこのファイルを検知してユーザーに通知する

キャラクター設定ファイルについて

characters/ 配下のキャラクター設定ファイルはClaude向けの自然言語テキストとして消費される。キャラクター名や口調特徴などの主要メタデータはYAML frontmatterに構造化されており、本文にはClaude向けの詳細な性格・口調の説明や独り言の例が記載されている。

制約

• 通知コメントは1文程度の短い独り言にすること
• 作業の流れを妨げないよう、スキルの実行は素早く完了すること
• セリフに英単語や英語のファイル名等を含める場合は、英語のまま使わず、発音を表す日本語に置き換えること
  • 拡張子も省略せず発音を表す日本語にすること
  • 例: README.md → 「リードミードットエムディー」、config.json → 「コンフィグドットジェイソン」、merge → 「マージ」、build → 「ビルド」
• ファイルパス、URL、UUIDなど長い文字情報は発音しても分かりづらいため、セリフに含めないこと