mcpField
G
game-sounds

game-sounds

github.com/akillnessエージェントワークフロー5356 回インストール4 日前に更新
リポジトリ

game-sounds について

game-sounds は、開発エージェント向けのイベント音を設定・トラブルシューティングするスキルです。Claude Code のフックと単体 CLI を扱い、ゲーム実行時の音声ではなく開発時のフィードバックを対象とします。

主な機能

  1. 01インストールと設定の案内
  2. 02サウンドパックの切り替えとローテーション
  3. 03音量とイベントカテゴリの設定
  4. 04無音フックのトラブルシューティング
  5. 05ローカルサウンドパックの作成

活用シーン

  1. 01game-sounds のインストールや確認
  2. 02パック、ローテーション、音量の変更
  3. 03無音フックの原因調査
  4. 04ローカルサウンドパックの作成

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/akillness/jeo-skills --skill game-sounds

インストール後、Claude Code で/game-soundsを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
references/
upstream.md
scripts/
setup.sh
validate_config.py

詳細

ゲームサウンド

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

  • @citedy/game-sounds をインストールまたは検証するとき。
  • サウンドパックの切り替え、ローテーションの管理、音量の設定、イベントカテゴリーの有効・無効を切り替えるとき。
  • 無音のフックを診断する、またはカスタムローカルパックを作成するとき。
  • スタンドアロン CLI と Claude Code フック統合の違いを説明するとき。

ゲーム制作向けの効果音の設計やアセット生成は、rfxgen、game-vfx、またはエンジン固有のオーディオスキルに案内してください。このスキルは開発者エージェントのフィードバックサウンド向けであり、ゲームのランタイムオーディオシステム向けではありません。

手順

ステップ 1：動作モードを把握する

次の項目を特定します。

  • ホスト：Claude Code プラグイン、グローバル npm CLI、またはクローンしたプラグインディレクトリ。
  • 操作：インストール、ステータス確認、設定、テスト、またはカスタムパック。
  • プラットフォームのプレーヤー：macOS では afplay、Linux では paplay、pw-play、または ffplay。
  • 許容されるオーディオ動作：音量、有効なイベント、ランダムローテーションが必要かどうか。
ステップ 2：インストール前に確認する
bash .agent-skills/game-sounds/scripts/setup.sh --check

ユーザーが Claude Code を使用している場合は、公式の Claude マーケットプレイス経由の方法を優先してください。グローバルな game-sounds CLI には npm を使用し、ローカルのプラグインディレクトリを明示的に希望する場合に限りクローンしてください。

bash .agent-skills/game-sounds/scripts/setup.sh --npm
bash .agent-skills/game-sounds/scripts/setup.sh --clone

プラグインのインストール後、またはフックの変更後は、Claude Code を再起動してください。

ステップ 3：設定を編集する前に検証する

アップストリームの設定には、volume、active_pack、pack_rotation、enabled_events の 4 つのフィールドがあります。

python3 .agent-skills/game-sounds/scripts/validate_config.py /path/to/config.json

音量が [0.0, 1.0] の範囲内であること、安全なパック名が使われていること、ローテーションリストが重複のない文字列リストであること、すべてのイベント切り替えがブール値であることを確認してください。JSON を直接編集するより、アップストリームの CLI を優先してください。

game-sounds status
game-sounds list
game-sounds switch starcraft
game-sounds rotation add zelda
game-sounds volume 0.3
game-sounds test task-complete
ステップ 4：フックを確認可能なイベントに対応付ける

確認したアップストリームのフック対応は次のとおりです。

  • SessionStart → session-start
  • UserPromptSubmit → task-acknowledge
  • Stop → task-complete
  • PostToolUseFailure → error
  • Notification → permission

フックが無音の場合は、設定の検出、イベントの有効化、パック／カテゴリーのファイル、実行権限、プラットフォームのオーディオプレーヤーの順に確認してください。

ステップ 5：カスタムパックは慎重に追加する

イベントカテゴリーのサブディレクトリを含むパックディレクトリを 1 つ作成します。ユーザーが所有する、または配布ライセンスを持つオーディオのみを使用してください。アップストリームリポジトリのソフトウェアは MIT ライセンスですが、同梱サウンドや、認識可能なゲーム／メディアのプロパティには別個の権利が適用される場合があります。アップストリームのクレジットを保持し、オーディオカタログがあらゆる場合に再配布可能であるかのように表示しないでください。

ステップ 6：実際の再生を検証する

ステータスコマンドで確認できるのは設定のみです。game-sounds test <category> を明示的に 1 回実行し、ユーザーに音が聞こえることを確認してください。環境がヘッドレス、またはオーディオデバイスがない場合は、設定は正常に通過したものの、再生は検証できなかったと報告してください。

例

音量を抑えた 2 つのサウンドのローテーションを設定する
game-sounds rotation clear
game-sounds rotation add mario
game-sounds rotation add zelda
game-sounds volume 0.2
game-sounds status
クローンしたプラグインの設定を検証する
python3 .agent-skills/game-sounds/scripts/validate_config.py \
  "$HOME/.claude/plugins/game-sounds/config.json" --json

ベストプラクティス

  1. 変更には CLI を使用し、診断にはバリデーターを使用します。
  2. 設定後に、イベントを 1 つ明示的にテストします。
  3. 音量を低く保ち、イベントカテゴリーを無効にできるようにします。
  4. 共有環境やアクセシビリティに配慮が必要な環境では、ユーザーの同意なくサウンドをインストールまたは再生しないでください。
  5. ソフトウェアのライセンスと、同梱オーディオアセットおよび商標に関する権利を分けて考えてください。

参考資料

  • references/upstream.md — 最新のアップストリームパッケージ、コマンド、フック対応、プラットフォームに関する注意事項。
  • Citedy/game-sounds

コメント

Markdown 対応