peon-ping 配置管理
通过修改配置文件，轻松调整 peon-ping 的音量、音效包切换、分类开关等所有设置。
技能仅指导读取和编辑 config.json，不执行网络请求或命令，权限最小化。但缺少回滚机制、用户确认流程不明确（仅要求确认，但未强制）、且未说明敏感数据流。发布者未经验证，但未作为扣分依据。扣分理由：权限方面较安全，但回滚、明确确认和数据流透明度不足。
路径和配置字段描述清晰，但未提供测试覆盖本技能关键路径。仓库有测试，但针对 OpenCode 适配器和 Antigravity 监视器，与 config 技能无关。静态评审限制可靠性上限为10，但存在共享测试和 CI 工作流，可作为部分证据。扣分理由：无直接测试，错误处理（如 JSON 损坏）未说明。
技能明确定义了使用场景（修改配置）和触发条件，但未声明非适用场景（如配置不存在时）。环境适配：描述为英文，无中文支持声明；核心功能依赖本地配置，不依赖海外服务，但未提及大陆可访问性。扣分理由：无明确边界和非适用场景，中文支持未声明。
文档结构清晰，提供了设置列表和示例，但缺少版本、更新日志和维护责任声明。未提供常见问题或故障排查。有许可证，发布者未验证但维护通过 GitHub Actions 体现。扣分理由：无版本信息、更新日志和明显的维护责任声明。
技能能完成修改配置的核心任务，但未展示代表性输出验证。无用户报告或测试证明实际效果。静态评审限制上限为7，但仓库有 CI 和测试可作为部分证据，但未覆盖本技能。扣分理由：未验证输出，边际价值低于 CLI 命令（ CLI 有更多验证）。
仓库有 CI 工作流（release、test-opencode-adapter）和测试文件，但未覆盖本技能路径。静态评审限制上限为5。扣分理由：缺少本技能直接验证，功能依赖仓库其他模块验证。
- 技能未提供配置回滚机制，修改前应备份原配置文件。
- 用户确认未被强制，建议在修改高影响设置（如禁用通知）时明确要求确认。
- 未声明对中文用户的支持，描述为英文，可能影响中文用户使用。
- 未提供故障排查或错误处理说明（如配置文件缺失、损坏的 JSON）。
这个 Skill 能做什么，适合哪些场景？
该技能用于更新 peon-ping 的配置文件，即 `~/.claude/hooks/peon-ping/config.json`。它允许你调整音量、启用或禁用音效包轮换、切换声音分类、设置活跃音效包，以及管理其他各项设置。适用于希望在 Claude Code 等 AI 编码代理工作时自定义声音提醒体验的用户。该技能提供清晰的配置项说明和常见用例示例，并推荐使用 CLI 命令作为替代方案。
读取并修改位于 ${CLAUDE_CONFIG_DIR:-$HOME/.claude}/hooks/peon-ping/config.json 的配置文件。具体操作包括：设置音量（0.0-1.0）、切换默认音效包、启用/禁用主开关、配置音效包轮换列表和轮换模式（随机、循环、会话覆盖）、开关各类 CESP 声音分类（如 session.start、task.complete 等）、通过文件名禁用特定声音、设置触发 user.spam 的阈值和时间窗口、设置静默窗口、过期时间、桌面通知开关、音频输出设备选项，以及管理路径规则（path_rules）以按目录绑定音效包。
- 用户希望将音量调低至 30% 时，技能会设置 `volume: 0.3`。
- 用户想启用轮换模式，在 peon 和 glados 音效包之间循环，技能会设置 `pack_rotation` 和 `pack_rotation_mode`。
- 用户希望关闭桌面通知但保留声音，技能会设置 `desktop_notifications: false`。
- 用户希望为特定目录永久绑定一个音效包（如 glados），技能会修改 `path_rules` 配置。
- 用户希望禁用某个分类下的特定声音文件（如 session.start 的 Hello1.wav），技能会更新 `disabled_sounds` 配置。
这个 Skill 有哪些优点和局限？
- 覆盖了所有配置项，从音量到高级轮换规则。
- 提供了常见用例的具体示例，方便快速操作。
- 推荐使用 CLI 命令，简化操作并减少错误。
- 技能本身不修改声音文件，仅配置。
- 配置修改需依赖 peon-ping 已安装且配置文件存在。
- 高级功能（如 session_override）可能需要额外理解。
如何安装这个 Skill？
该技能随 peon-ping 仓库一并提供，位于 skills/peon-ping-config/SKILL.md。安装 peon-ping 后，将技能文件夹放置到你的 Claude Code 技能目录（如 ~/.claude/skills/）中即可。
如何使用这个 Skill？
在 Claude Code 中，直接向 Claude 提出需求，例如“将音量设为 30%”或“启用轮换模式”。技能会读取配置文件，编辑相应字段，并确认更改。也可以使用 CLI 命令（如 peon volume 0.3、peon notifications off）作为替代。