mcpField
G
game-sounds

game-sounds

github.com/akillnessAgent 工作流5356 次安装4 天前更新
代码仓库

关于 game-sounds

game-sounds 技能指导配置和排查开发 Agent 的事件反馈音效，涵盖安装、音效包轮换、音量及事件开关。它面向使用 Claude Code 集成或独立 CLI 的开发者，不用于游戏运行时音频。

主要功能

  1. 01安装与配置指引
  2. 02音效包切换及轮换
  3. 03音量和事件类别设置
  4. 04静音故障排查
  5. 05本地自定义音效包

适用场景

  1. 01安装或验证 game-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 钩子集成之间的区别。

游戏制作中的 SFX 设计或素材生成应转交给 rfxgen、game-vfx 或特定引擎的音频技能。此技能用于开发者 Agent 的反馈音效，不适用于游戏运行时音频系统。

说明

第 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。

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

要求音量处于 [0.0, 1.0] 范围内，音效包名称安全，轮换列表由不重复的字符串组成，且所有事件开关均为布尔值。优先使用上游 CLI，而非直接编辑 JSON：

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 步：谨慎添加自定义音效包

创建一个包含事件类别子目录的音效包目录。仅使用用户拥有或获得授权可分发的音频。上游仓库的软件采用 MIT 许可证，但捆绑音效以及可识别的游戏／媒体相关内容可能受单独权利约束；请保留上游署名，不要声称该音频目录可在任何情况下自由再分发。

第 6 步：验证实际播放

状态命令只能证明配置正确。运行一次明确的 game-sounds test <category>，并与用户确认听到了声音。如果环境为无头环境或没有音频设备，请说明配置验证已通过，但播放尚未验证。

示例

设置一组安静的轮换音效
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. 配置后明确测试一个事件。
  3. 保持较低音量，并允许禁用事件类别。
  4. 在共享环境或对无障碍有特殊要求的环境中，未经用户同意，不要安装或播放音效。
  5. 区分软件许可与捆绑音频素材及商标的权利。

参考资料

  • references/upstream.md — 当前上游软件包、命令、钩子映射和平台说明。
  • Citedy/game-sounds

评论

支持 Markdown