peon-ping-toggle 是 peon-ping 技能集中的一个开关类技能，主要用于切换 peon-ping 声音通知的开启与关闭状态，也处理任何 peon-ping 配置变更的入口。
【用途】 当用户希望在 Claude Code 会话期间静音、取消静音、暂停或恢复 peon 声音时使用该技能。它对应的是 peon-ping 的主音频开关（enabled 配置项）。
【主要能力】 切换声音开关：执行后命令会打印两种结果之一：
- peon-ping: sounds paused — sounds are now muted
- peon-ping: sounds resumed — sounds are now active
使用户能够快速在“静音”和“恢复声音”两种状态间切换。
【使用方式】 在 Unix 系统上，使用 Bash 工具运行以下命令：
bash "${CLAUDE_CONFIG_DIR:-$HOME/.claude}"/hooks/peon-ping/peon.sh toggle
在 Windows 系统上，使用 PowerShell 工具运行：
$claudeDir = $env:CLAUDE_CONFIG_DIR if (-not $claudeDir -or $claudeDir -eq "") { $claudeDir = Join-Path $HOME ".claude" } & (Join-Path $claudeDir "hooks/peon-ping/peon.ps1") toggle
执行后将命令输出报告给用户。
【切换影响】 该命令切换的是主音频开关（enabled 配置）。当它被禁用时：
- 声音停止播放；
- 桌面通知也会停止（桌面通知需要声音处于启用状态）；
- 移动通知也会停止。
【通知与声音的区分控制】 如果只想控制通知而不影响声音，可使用 /peon-ping-config 将 desktop_notifications 设为 false。这样声音仍会播放，但桌面弹窗会被抑制。
示例：
- “完全静音 peon-ping” → 设置 enabled: false
- “只关闭弹窗但保留声音” → 设置 desktop_notifications: false（应改用 /peon-ping-config）
【其他配置变更】 若需要修改 peon-ping 的其他设置（音量、音效包轮换、分类、当前激活音效包等），应使用 peon-ping-config 技能。
【适用场景】 适用于 Claude Code 会话中需要临时静音或恢复 peon 声音提醒的场合，以及需要快速切换声音总开关的场景。
【限制】 该技能仅负责切换主音频开关及引导其他配置变更，本身不提供音量、音效包、分类等细粒度设置的修改能力；这些需通过 peon-ping-config 技能完成。以上未提及的具体参数、平台兼容范围与更多细节，资料中暂未提供。