用途：为编码代理提供反馈音效，安装、配置并排查 @citedy/game-sounds。适用于 Claude Code 插件、全局 npm CLI 或克隆的插件目录。注意它面向开发者代理的反馈音效，而非游戏运行时音频系统。
主要能力：捕获运行模式（宿主、操作、平台播放器、音量与事件开关）；安装前用 bash .agent-skills/game-sounds/scripts/setup.sh --check 检查，支持 --npm 或 --clone 路径；安装插件或修改钩子后需重启 Claude Code。配置含 volume、active_pack、pack_rotation、enabled_events 四个字段，可用 python3 .agent-skills/game-sounds/scripts/validate_config.py /path/to/config.json 校验，要求音量在 [0.0,1.0]、包名安全、轮换列表唯一、事件开关为布尔值。
使用方式：优先使用上游 CLI 而非直接改 JSON，例如 game-sounds status、list、switch starcraft、rotation add zelda、volume 0.3、test task-complete。钩子映射为 SessionStart→session-start、UserPromptSubmit→task-acknowledge、Stop→task-complete、PostToolUseFailure→error、Notification→permission。静音时依次检查配置发现、事件启用、包/类别文件、可执行权限和平台音频播放器（macOS 用 afplay，Linux 用 paplay、pw-play 或 ffplay）。
适用场景与限制：自定义包需按事件类别建子目录，仅使用自有或获授权音频；软件为 MIT，但内置音效与可识别游戏/媒体资产可能有独立权利，需保留上游署名。状态命令仅证明配置，需显式运行 game-sounds test <category> 确认可听输出；无音频设备的环境应如实报告配置通过但未验证播放。共享或无障碍敏感环境须经用户同意再安装或播放。