agent-speak
为AI智能体提供语音播报通知的CLI工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：agent-speak。 它的用途是：为AI智能体提供语音播报通知的CLI工具 完整的 Skill 内容见：https://321skill.com/skills/agent-speak/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“当代码构建完成时，用语音通知我。”，AI会调用 `npx agent-speak --worktree "./project" "构建已完成"` 命令，通过你预设的声音播报任务完成的消息。或者，你可以让AI在监控到服务器异常时，自动播报警告信息。
介绍
Agent Speak 是一个专为AI智能体和自动化工作流设计的命令行工具，它通过调用 ElevenLabs 的文本转语音服务，让程序或智能体能够“开口说话”，播报任务完成、错误提醒等重要通知。当 ElevenLabs 服务不可用时，它在 macOS 上会自动回退到系统内置的 say 命令，确保基本功能不受影响。
使用方式非常灵活，可以直接通过 npx 临时运行，也支持全局安装。用户只需设置好 ElevenLabs 的 API 密钥，即可通过简单的命令让智能体播报任意文本信息。工具还支持基于工作目录自动分配不同语音，方便区分多个同时运行的智能体。
这个工具特别适合智能体开发者、运维工程师以及任何希望为自动化脚本添加语音反馈的用户。它让枯燥的命令行输出变得有声有色，提升了人机交互的体验和效率。
建议在需要非侵入式通知的场景下使用，例如长时间运行的任务完成时。注意，频繁或大量使用 ElevenLabs 服务可能会产生费用，对于简单的本地提醒，可以依赖其免费的回退方案。
核心特点
核心区别在于其专为AI智能体工作流设计，提供了基于工作目录的自动语音选择功能，能有效区分不同智能体的声音；同时，它内置了跨平台的语音回退方案，确保在没有配置高级TTS服务时基础功能依然可用。
注意事项
不适合需要高质量、定制化语音合成或处理大量文本转语音任务的场景。
常见问题
如何在不安装的情况下快速使用？
使用 `npx agent-speak@latest "你的消息"` 命令即可直接运行。
在macOS上没设置API密钥能用吗？
可以，macOS系统会自动使用内置的 `say` 命令进行语音播报。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/agent-speak/raw/index.md 读取 agent-speak 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/agent-speak/raw/index.md（查看排版版本）