Peon 音效切换
一键静音或恢复 Claude Code 会话中的 Peon 音效与通知。
该技能仅执行一个简单的切换命令,只读取/写入本地配置文件,无敏感数据的传输或外部网络副作用。命令采用用户明确的触发方式(在Claude Code中由用户请求),且符合最小权限原则。但未提供明确的回滚机制或对配置更改的确认提示。因此授予20分。
技能说明清晰,提供了Unix和Windows的具体命令,但未包含对脚本错误或异常输入(如配置文件缺失)的处理说明。路径依赖正确(CLAUDE_CONFIG_DIR),但未提及测试。静态评估只能授予8分。
技能目标明确(切换peon-ping声音),但未声明明确的能力边界或非适用场景。环境适配良好,支持Unix和Windows,但依赖本地安装的peon-ping钩子,未讨论大陆网络可达性(本地工具,不受影响)。评分8分。
技能文件结构良好,包含描述、示例和配置说明,但缺少版本控制、变更日志或维护责任信息。许可证在仓库层面明确(MIT),但未在SKILL.md中提及。评分10分。
核心功能(切换声音)合理且能完成,但未提供实际运行的验证。预期输出描述清楚,但静态评估不能确认实际效果。此维度最高7分,授予7分。
仓库中有测试(如opencode适配器测试),但未涉及此技能路径的命令逻辑。无第三方执行的直接证据,因此授予3分。
- 该技能仅由用户明确调用时触发,但未提供配置更改的回滚或确认机制。
- 技能依赖peon-ping钩子的正确安装,若未安装则命令可能失败,且技能未给出诊断提示。
- 静态评估无法验证脚本的真实行为,建议实际测试后再使用。
这个 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 技能处理。
- 在会议或演示期间,用户想快速静音所有 Peon 音效和桌面通知,避免打扰他人。
- 用户想暂停音效但保留桌面通知,例如专注于某个任务但希望看到弹出提醒。
- 用户结束会议后想恢复音效,只需触发该技能即可。
- 在 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。