前言¶
在对话式开发环境里，用户常会希望 Agent「读出来」或「用语音回答」，而不是只返回一段文字。若每次都要自己接第三方 TTS 服务、写脚本生成音频再播放，流程会打断对话节奏。Edge TTS 是 SkillHub 上的一条社区 Skill，把「文字转语音」封装成 Agent 可识别的能力：在合适意图下由 Agent 加载 Skill 指引完成合成与播放相关操作，且标注为不需要 API Key（requires_api_key=false）。
这是什么¶
Edge TTS 的定位是 Edge TTS 语音合成工具。坐标为 @user_c9d52b8e/edge-tts-mf，版本 1.0.0，来源 community，分类 design-media，发布者为 user_c9d52b8e。官方 SkillHub 页面：Edge TTS；线索中的 API 地址为 https://api.skillhub.cn/user_c9d52b8e/edge-tts-mf。
它解决的是：在支持 Skills 的 Agent 中，用统一触发条件把「读出来、播放音频、配置 TTS」等需求交给 Skill 处理，而不是在每次对话里临时拼凑方案。
核心功能¶
以下能力均来自 SkillHub 页面与已抓取简介，未展开 Skill 包内具体命令或配置项。
- 文字转语音：面向 Edge TTS 路线的语音合成场景。
- 意图触发：当用户要求文字转语音、用 Edge TTS 说话、播放音频、配置 TTS、安装语音合成，或提到「读出来」「语音回答」时，Agent 应触发本 Skill。
- 免 API Key：标签标明
requires_api_key=false，不依赖用户另行配置 API Key（具体依赖仍以 Skill 内SKILL.md为准）。
SkillHub 侧统计（抓取时）：评分 100000，下载 1388，安装 1。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。安装前需能使用 SkillHub CLI；若尚未安装，可先按官方安装文档检查环境。
1、安装 SkillHub CLI¶
command -v skillhub && skillhub --version
未安装时，可用官方脚本完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明与权限要求见：SkillHub 安装与优先源配置。
2、安装 Edge TTS Skill¶
安装技能时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
skillhub install @user_c9d52b8e/edge-tts-mf --dir <skills 目录>
也可将下面提示交给 AI，让其按安装文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c9d52b8e/edge-tts-mf`。
3、各客户端 skills 目录（节选）¶
官方安装文档列出的常见路径如下，请按你实际使用的客户端选择 <skills 目录>：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后若 Agent 未立即识别新 Skill，需按你所用客户端的说明重启或刷新 Skills 目录。
典型用法¶
公开页面未提供可逐条复制的合成命令或配置字段；典型用法应理解为 在对话中表达明确意图，由 Agent 加载本 Skill 后执行。与官方简介一致的触发表述包括：
- 「把这段话读出来」「用语音回答」
- 「用文字转语音 / 用 Edge TTS 说话」
- 「播放这段内容的音频」「帮我配置 TTS / 安装语音合成」
经过上面的步骤安装到正确 skills 目录后，用上述自然语言发起请求即可；具体调用 edge-tts 或播放流程以 Skill 包内 SKILL.md 为准，本文不臆造未公开的脚本参数。
适用场景与注意¶
适合谁：需要在 Cursor、Claude Code、Codex 等支持 Skills 的环境里，偶尔或经常做 TTS、听读回复的开发者；希望不配置 API Key 即可尝试社区方案的用户（以 Skill 标签为准）。
注意：
- 社区来源（
community），升级与维护节奏取决于发布者，使用前可在 SkillHub 查看版本 1.0.0 与页面说明。 - 安装路径错误是常见坑：务必
skillhub install ... --dir指向当前 Agent 的 skills 目录。 - 沙箱或限网环境下安装 CLI、拉取 Skill 可能需要允许联网的权限。
- 语音效果、音色、离线能力等细节未在公开简介中列出，以实际 Skill 文档与运行环境为准。
结尾¶
Edge TTS 把「读出来、播放、TTS 配置」等意图收敛到一条 design-media 类 Skill，便于在 Agent 对话中按需触发，并标明无需 API Key。需要安装或查看元数据时，可打开 SkillHub 页面：https://www.skillhub.cn/skills/user_c9d52b8e/edge-tts-mf 。
