开发与工程 sound-notificationsproductivityaudio-alertstoggle

Peon 音效切换

一键静音或恢复 Claude Code 会话中的 Peon 音效与通知。

FollowSkills 评估 · FSRS-2.0
不推荐
56/ 100 五分制 2.8 / 5
1 2 3 4 5 6
1信任安全20 / 25 · 4.0/5

该技能仅执行一个简单的切换命令,只读取/写入本地配置文件,无敏感数据的传输或外部网络副作用。命令采用用户明确的触发方式(在Claude Code中由用户请求),且符合最小权限原则。但未提供明确的回滚机制或对配置更改的确认提示。因此授予20分。

2可靠稳定8 / 20 · 2.0/5

技能说明清晰,提供了Unix和Windows的具体命令,但未包含对脚本错误或异常输入(如配置文件缺失)的处理说明。路径依赖正确(CLAUDE_CONFIG_DIR),但未提及测试。静态评估只能授予8分。

3适用触发8 / 15 · 2.7/5

技能目标明确(切换peon-ping声音),但未声明明确的能力边界或非适用场景。环境适配良好,支持Unix和Windows,但依赖本地安装的peon-ping钩子,未讨论大陆网络可达性(本地工具,不受影响)。评分8分。

4规范维护10 / 15 · 3.3/5

技能文件结构良好,包含描述、示例和配置说明,但缺少版本控制、变更日志或维护责任信息。许可证在仓库层面明确(MIT),但未在SKILL.md中提及。评分10分。

5有效结果7 / 15 · 2.3/5

核心功能(切换声音)合理且能完成,但未提供实际运行的验证。预期输出描述清楚,但静态评估不能确认实际效果。此维度最高7分,授予7分。

6证据核验3 / 10 · 1.5/5

仓库中有测试(如opencode适配器测试),但未涉及此技能路径的命令逻辑。无第三方执行的直接证据,因此授予3分。

证据充分度: 评估于 2026年8月7日 审查版本 fef63cfdb134
上游仓库在本次评估后已有新提交;当前评分仍对应所示审查版本,可能尚未覆盖最新改动。
使用前请注意
  • 该技能仅由用户明确调用时触发,但未提供配置更改的回滚或确认机制。
  • 技能依赖peon-ping钩子的正确安装,若未安装则命令可能失败,且技能未给出诊断提示。
  • 静态评估无法验证脚本的真实行为,建议实际测试后再使用。
评估证据 [1][2][3][4][5][6][7]
查看完整评分方法 →

这个 Skill 能做什么,适合哪些场景?

此技能用于控制 peon-ping 的音频通知开关。它通过一个命令瞬间切换声音和桌面通知的静音状态,适用于会议或专注场景。除开关外,它还处理音量、音色包轮换等配置变更,但配置修改需借助配套技能 /peon-ping-config 完成。它是从 Warframe 多技能仓库中单独提取出来的,专注于快速控制。

该技能运行 peon.sh 或 peon.ps1 脚本,带 toggle 参数,切换 peon-ping 的 master audio switch(即 enabled 配置项)。脚本输出 'peon-ping: sounds paused' 或 'peon-ping: sounds resumed',技能将结果报告给用户。它不执行其他操作,例如修改音色包、音量等,这些需由 /peon-ping-config 技能处理。

  1. 在会议或演示期间,用户想快速静音所有 Peon 音效和桌面通知,避免打扰他人。
  2. 用户想暂停音效但保留桌面通知,例如专注于某个任务但希望看到弹出提醒。
  3. 用户结束会议后想恢复音效,只需触发该技能即可。
  4. 在 Claude Code 会话中,用户需要通过语音指令而不是手动配置文件来快速控制声音。

这个 Skill 有哪些优点和局限?

优点
  • 快速便捷,一条命令完成静音/恢复。
  • 同时控制音效和桌面通知,符合用户预期。
  • 跨平台支持 Unix 和 Windows。
  • 安装简单,随 peon-ping 自动部署。
局限
  • 仅控制主开关,不支持细分控制(如只静音某类音效)。
  • 依赖 peon-ping 已安装,且需正确配置 Claude Code 的 hook。
  • 切换后状态不会自动恢复,需要用户主动再次触发。
  • 文档未提及任何测试,可能存在未覆盖的平台问题。

如何安装这个 Skill?

该技能作为 peon-ping 仓库的一部分安装。请先按照仓库 README 的说明安装 peon-ping(例如通过 Homebrew 或安装脚本),该过程会将技能文件复制到 Claude Code 的技能目录(通常为 ~/.claude/skills/)。本技能所需的脚本依赖 peon-ping 的安装,且需在已安装 peon-ping 的会话中使用。

如何使用这个 Skill?

在 Claude Code 会话中,直接对 Claude 说“静音 peon”或“恢复 peon 音效”,技能会自动调用相应的切换命令。该技能也支持作为斜杠命令 /peon-ping-toggle 使用。执行后,Claude 会报告当前状态。如果只希望关闭桌面通知而保留音效,请改用 /peon-ping-config 技能设置 desktop_notifications: false。

常见问题

该技能会修改我的配置文件吗?
不会,它只运行切换命令,不直接编辑配置文件。所有配置变更(如音量、音色包)需使用 /peon-ping-config 技能。
静音后,音效和通知都会停止吗?
是的,主开关 disabled 时,音效、桌面通知和移动通知都会停止。
我可以在 Windows 上使用吗?
可以,技能提供了 PowerShell 命令,适用于 Windows 环境。
切换后状态能自动恢复吗?
不能,切换后状态保持,直到你再次触发切换。若需自动根据 Focus 模式静音,请配置 focus_detect。

同仓库的其他 Skills

均来自 PeonPing/peon-ping

相关 Skills