settings-and-tuning

設定と調整

TTS エンジン、Telegram ボット、サポートインフラストラクチャのすべての調整可能なパラメーターを設定します。設定はすべて mise.toml を単一の信頼できる情報源（SSoT）として一元管理しています。

プラットフォーム：macOS（Apple Silicon）

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

このスキルを使用するタイミング

• TTS 音声（英語、中国語、または macOS の say 音声）を変更する
• 読み上げ速度を調整する
• TTS のタイムアウトまたはキューの深さを調整する
• 通知のレート制限またはサーキットブレーカーを設定する
• プロンプト実行のスロットリングを調整する
• セッションピッカーの上限を変更する
• 監査ログの保持期間を変更する

---

要件

コンポーネント	必須	インストール
mise	はい	brew install mise（環境変数の読み込み用）
ボットの実行	推奨	TTS／キューの設定変更にはボットの再起動が必要です

---

ワークフローのフェーズ

フェーズ 0：現在の設定を読み込む

現在の mise.toml を読み込み、有効な設定をすべて確認します。

cat ~/.claude/automation/claude-telegram-sync/mise.toml

設定可能な値はすべて [env] セクションにあります。このファイルはスタック全体の信頼できる唯一の情報源です。

フェーズ 1：変更内容を特定する

AskUserQuestion を使って、設定グループをユーザーに提示します。設定グループは次のとおりです。

グループ	設定	説明
TTS 音声	TTS_VOICE_EN、TTS_VOICE_ZH、TTS_VOICE_SAY_EN、TTS_VOICE_SAY_ZH	言語ごとの音声選択
TTS 速度	TTS_SPEED	読み上げ速度の倍率
TTS タイムアウト	TTS_GENERATE_TIMEOUT_MS、TTS_SAY_TIMEOUT_MS	生成と再生のタイムアウト
TTS キュー	TTS_MAX_QUEUE_DEPTH、TTS_STALE_TTL_MS、TTS_MAX_TEXT_LEN	キューの上限と古さ
TTS シグナル	TTS_SIGNAL_SOUND	シグナル音のパス（無効にする場合は空欄）
レート制限	NOTIFICATION_MIN_INTERVAL_MS、SUMMARIZER_*	通知と要約機能のスロットリング
プロンプト実行	PROMPT_*	プロンプト実行のスロットリングとサーキットブレーカー
セッションピッカー	SESSION_*	セッションのスキャンと表示の上限
監査	AUDIT_RETENTION_DAYS	ログの保持期間
モデル	HAIKU_MODEL	Agent SDK 呼び出し用の Claude モデル

フェーズ 2：設定を編集する

~/.claude/automation/claude-telegram-sync/mise.toml の該当する行を編集します。Edit ツールを使い、特定の値を正確に変更してください。

フェーズ 3：検証して適用する

1. 編集した値が有効な範囲内であることを確認します（設定リファレンスを参照）
2. TTS、キュー、またはレート制限の設定を変更した場合は、ボットを再起動します。

# Option A: If using mise tasks
cd ~/.claude/automation/claude-telegram-sync && mise run bot:restart

# Option B: Manual restart
pkill -f "bun.*main.ts" && cd ~/.claude/automation/claude-telegram-sync && bun --watch run src/main.ts

1. ボットのログを確認するか、該当する機能をテストして、新しい設定が有効になっていることを確認します

---

TodoWrite タスクテンプレート

テンプレート：設定の調整

1. [Read] Read current mise.toml configuration
2. [Identify] Present config groups to user via AskUserQuestion
3. [Select] User selects setting category to modify
4. [Edit] Update mise.toml with new values
5. [Validate] Verify values are in valid range
6. [Apply] Restart bot to apply changes (if TTS or queue settings changed)
7. [Verify] Confirm new settings are active

---

変更後のチェックリスト

このスキルを変更した後：

1. SKILL.md のすべての設定グループが、現在の mise.toml と一致していることを確認します
2. 新しい環境変数を追加した場合は、config-reference.md を更新します
3. ボットの再起動後に、変更した設定が反映されることをテストします
4. 変更内容を references/evolution-log.md に記録します

トラブルシューティング

問題	原因	解決策
設定が反映されない	ボットが再起動されていない	mise.toml を変更した後、ボットを再起動します
mise.toml の解析エラー	TOML の構文が無効	引用符の不足やエスケープされていない文字がないか確認します
音声が見つからない	音声名が無効	音声カタログを確認します（Kokoro の音声名では大文字と小文字が区別されます）
速度が速すぎる／遅すぎる	値が範囲外	TTS_SPEED には 0.5 から 2.0 の範囲を使用します
サーキットブレーカーが開いたまま	障害が多すぎる	ブレーカーのタイムアウトを待つか、ボットを再起動します
タイムアウトが短すぎる	初回実行時の TTS 生成が遅い	モデルのウォームアップには時間がかかります。タイムアウトを延長します

---

参考ドキュメント

• 設定リファレンス - すべての環境変数、デフォルト値、有効範囲、コンポーネントの所有権を含む完全なリファレンステーブル
• mise.toml リファレンス - ハブ／スポークの mise アーキテクチャ、シークレットの読み込み、タスクファイルの構造
• 進化ログ - このスキルの変更履歴

実行後の振り返り

このスキルが完了した後、タスクを終了する前に振り返ります。

0. 自分の場所を特定します。 — 編集する前に、この SKILL.md の正式なパスを確認します（このスキル名で Glob を実行します）。修正の対象はこのファイルとその兄弟ファイルである references/ だけです。他のドキュメントは対象にしません。
1. 何が失敗しましたか？ — 原因となった指示を修正します。再発する可能性がある場合は、アンチパターンとして追加します。
2. 予想以上にうまくいったことは何ですか？ — 推奨プラクティスとして取り入れます。その理由も記録します。
3. 何が現状とずれていましたか？ — 現状と一致しなくなったスクリプト、リファレンス、外部依存関係は、ここで修正します。
4. 記録します。 — すべての変更について、きっかけ、修正内容、根拠を含む進化ログの項目を追加します。

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

---

---