让 Claude Code 开口说话主动汇报的skills——任务完成、出错、Agent 报到,全程语音播报,保持开发心流。
快速开始 · English · 核心特性 · Agent 团队 · 官网
你在等 Claude Code 跑任务时可以去倒杯水、刷手机——它会主动开口告诉你完成了,不用盯着屏幕。
老板,全员报到完毕,团队就绪,等待您的指令! ← Agent 全员报到
嗯... 出现了错误,请检查 ← 出错安抚提醒
太棒了!任务执行完毕,部署已完成! ← 大任务完成庆祝
已完成 3 项,共 7 项,加油! ← 进度实时播报
这么晚啊,所有任务执行完毕 ← 深夜时段感知
零依赖:只用 macOS 内置的 say 和 afplay,安装即用,无需任何 API Key。
git clone https://github.com/Jayden72Huang/cotify.git ~/.claude/skills/voice-notify或在 Claude Code 中直接粘贴:
帮我安装 Cotify 语音提醒 skill:https://github.com/Jayden72Huang/cotify
bash ~/.claude/skills/voice-notify/scripts/setup.sh脚本会自动检测环境,并引导你下载最接近 Siri 中文音色的 莉莉 (Premium)。
手动路径:
系统设置 → 辅助功能 → 朗读内容 → 管理语音 → 中文(中国大陆)→ 莉莉 (Premium) ⬇
你:帮我开启语音提醒
Claude:好的,请问你希望哪种模式?
· milestone(默认)— 任务完成、错误、成就时播报
· full — 每个步骤都播报
· completion — 只在最终完成时播报
不同场景自动调节语速和语气词,听起来更像人在说话:
| Preset | 语速 | 语气 | 适用场景 |
|---|---|---|---|
celebrate |
200 | 哇!太棒了!冲! | 构建通过、任务完成 |
comfort |
165 | 嗯...没事的,会好的 | 出错、失败 |
encourage |
210 | 加油!冲冲冲!稳住! | 进度播报 |
alert |
210 | 注意,警告! | 严重错误 |
normal |
200 | 自然平和 | 通用通知 |
bash voice.sh "构建通过" --preset=celebrate
bash voice.sh "出现错误,请检查" --preset=comfort--vibe=chill # 极简,无语气词,纯播报
--vibe=normal # 默认,60% 概率随机加语气词
--vibe=hype # 全力输出,必定有语气词bash voice.sh "任务完成" --time-aware
# 凌晨 → "这么晚啊,任务完成"
# 早上 → "早啊,任务完成"
# 傍晚 → "傍晚了,任务完成"# 10 秒内同类事件只播一次
bash voice.sh "进度更新" --debounce=10
# 多条消息排队顺序播出,不互相打断
bash voice.sh "第一条" --queue
bash voice.sh "第二条" --queue多个 Agent 协作时,每个角色有专属声音:
| Agent | 声音 |
|---|---|
| PM | Lili (Premium) |
| DEV | Yue (Premium) |
| Designer | Sinji |
| Researcher | Meijia (Enhanced) |
| QA | Meijia |
全员报到示例:
# 每个 Agent 到达时
bash sfx.sh checkin
bash voice.sh "老板,PM 已上线,向您报到!" "Lili (Premium)" --preset=normal --queue
# 全员就绪
bash sfx.sh celebrate
bash voice.sh "全员报到完毕,等待老板指令!" --preset=celebrate --queue| 命令 | 音效 | 时机 |
|---|---|---|
sfx.sh celebrate |
Hero | 大任务完成 |
sfx.sh success |
Glass | 构建/测试通过 |
sfx.sh error |
Sosumi | 严重错误 |
sfx.sh levelup |
Purr | 成就解锁 |
sfx.sh coin |
Pop | 小胜利、提交 |
sfx.sh checkin |
Morse | Agent 报到 |
sfx.sh warning |
Basso | 非严重警告 |
开发过程中随时切换语音模式,不用中断 Claude Code:
vn quiet # 🔈 安静模式:只播完成+严重错误
vn normal # 🔊 正常模式(默认)
vn mute # 🔇 完全静音
vn hype # 📢 全开:每步都播,语气词拉满
vn status # 查看当前模式支持缩写:vn q / vn n / vn m / vn h / vn s
运行
bash setup.sh会自动安装vn别名到你的 shell 配置中。
| 项目 | 要求 |
|---|---|
| 系统 | macOS 12 Monterey 及以上 |
| 依赖 | 无(使用系统内置 say + afplay) |
| 推荐语音 | 莉莉 Premium(需在系统设置中下载) |
关于 Siri 音色: macOS 的
say命令与 Siri 使用独立的语音引擎,无法直接调用 Siri 声音。莉莉 (Premium)是目前最接近 Siri 中文音色的系统语音。
voice.sh "<消息>" [语音名] [语速] [flags...]
Flags:
--preset=celebrate|comfort|encourage|alert|normal
--vibe=chill|normal|hype
--time-aware 时段感知前缀
--queue 排队顺序播报
--debounce=<秒> 防抖,N 秒内只播一次
--no-filler 禁用语气词
voice-notify/
├── SKILL.md # Claude Code skill 配置
├── README.md # 中文文档
├── README_EN.md # English docs
├── LICENSE # MIT License
└── scripts/
├── voice.sh # TTS 播报核心脚本
├── sfx.sh # 系统音效脚本
├── vn.sh # 模式快捷切换
├── setup.sh # 首次环境检测与引导
└── demo.sh # 功能演示
Q: 播报的声音不是中文?
A: 运行 bash setup.sh 检查推荐语音是否已下载。
Q: 完全没有声音? A: 检查系统音量,以及 macOS 是否有「请勿打扰」开启。
Q: 能用在 Linux 上吗? A: 目前仅支持 macOS。Linux 版本(基于 espeak)正在规划中。
Q: 会消耗 Claude API Token 吗? A: 不会。所有播报均在本地运行,不调用任何 AI API。
MIT © 2025
如果这个 skill 让你的 vibe coding 更爽了,欢迎 ⭐ Star 支持一下!