前言¶
在 IM、客服或私人助理类 Agent 里接入语音，常见卡点不是「模型能不能听懂」，而是 ASR、TTS 与通道格式没对齐：用户发来语音条、附件里是 audio/...，或明确要求「用语音回复」「转写成文字」，Agent 往往只能回复「当前不支持」。这类问题需要按环境逐项查密钥、端点与触发条件，而不是一句搪塞。
下面介绍 SkillHub 社区 Skill ASR+TTS语音聊天配置助手（@user_5777f071/voice-process-helper，当前页面版本 v1.0.7）。它的定位是：在出现任何与语音相关的未满足需求时，要求 Agent 完整遵循该 Skill，引导完成语音服务配置，而不是直接说 not supported。
这是什么¶
ASR+TTS语音聊天配置助手 是面向 ai-agent 场景的配置型 Skill，由社区发布者 user_5777f071 维护，来源标注为 community。官方简介将其定义为 Voice service configuration assistant（语音服务配置助手），侧重 inbound/outbound 语音链路的配置引导，而非替代具体 ASR/TTS 厂商 SDK。
SkillHub 页面标签包含 requires_api_key=true，表示落地语音能力时通常需要自行准备并配置 API Key；具体字段与服务商名称以安装后 Agent 读取的 SKILL.md 为准，本文不展开未在公开页面出现的配置项。
核心功能¶
以下能力均来自 SkillHub 公开简介，可与页面原文对照。
自动触发条件¶
在下列任一情况出现时，Agent 应加载并遵循本 Skill：
- 收到语音消息（voice message）。
- 用户要求用语音回复（voice reply）。
- 收到音频附件，包括
[media attached: audio/...]形式或音频文件。 - 用户请求语音识别或转写（speech recognition / transcription）。
行为约束¶
当 inbound 或 outbound 的语音相关需求尚未满足时，Agent 必须按该 Skill 全文走完配置指引流程；官方明确要求：不得仅用「不支持」结束对话（never just say ‘not supported’）。
安装与启用¶
SkillHub 提供两种常见安装方式：把安装提示交给 AI，或使用 skillhub CLI。安装时须把技能装进当前 Agent 实际读取的 skills 目录，否则不会生效。
方式一：提示词交给 AI¶
将下面提示发给正在使用的编码 Agent（Cursor、Claude Code、Codex 等均可），让其按官方安装文档操作：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_5777f071/voice-process-helper`。
方式二：SkillHub CLI¶
先确认本机是否已安装 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行推荐的一键安装（完整包含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本 Skill 时，必须用 --dir 指向当前环境的 skills 目录。文档给出的常用路径示例：
| 环境 | skills 目录（示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
安装命令形式如下（将 <skills 目录> 换成上表对应路径）：
skillhub install user_5777f071/voice-process-helper --dir <skills 目录>
坐标写法也可使用 @user_5777f071/voice-process-helper，与 SkillHub 页面一致。
安装或更新 skills 后，按你所用客户端的要求重启或重新加载 Agent，确保新 Skill 被索引。
典型用法¶
本 Skill 没有单独的「业务 API 调用示例」；典型用法是在真实语音交互场景中由 Agent 自动介入。
- 用户在对话中发送语音条或上传音频文件。
- Agent 识别到上述触发条件之一，加载 ASR+TTS语音聊天配置助手。
- Agent 按 Skill 内步骤检查：是否已配置语音服务、API Key 是否就绪、当前通道是否支持 inbound/outbound。
- 配置未完成时，Agent 输出可执行的配置清单与下一步操作；配置完成后，再处理转写、语音回复等用户请求。
若你本地 skillhub install 因网络或索引原因失败，仍可采用「方式一」让 Agent 根据 skillhub.md 拉取或手动放置 Skill 包，原则同样是：文件落在正确的 skills 目录并被 Agent 加载。
适用场景与注意¶
适合谁
- 正在把语音消息、音频附件或 TTS 回复接到 OpenClaw 系或支持通用
SKILL.md的 Agent 上的开发者。 - 希望 Agent 在语音能力缺失时主动引导配置，而不是终止对话的团队。
限制与注意
- 标签
requires_api_key=true：需要自行申请并保管语音相关服务的密钥，勿把密钥写进公开仓库。 - 本文为介绍性说明，不包含 Skill 包内部的逐步配置字段；以安装后
SKILL.md及 SkillHub 页面为准。 - SkillHub 抓取数据（截至编写时）：分类 ai-agent，评分 100000，下载 728，安装 12；页面版本 v1.0.7。统计会随社区更新变化。
结尾¶
ASR+TTS语音聊天配置助手 解决的是 Agent 在语音场景下「只会说不支持」的问题：用明确的触发条件与强制遵循的配置流程，把 ASR、TTS 与附件格式对齐到可落地状态。若你在做语音聊天或转写能力，可从 SkillHub 页面查看说明并安装。
- SkillHub 页面：https://www.skillhub.cn/skills/user_5777f071/voice-process-helper
- API 条目：https://api.skillhub.cn/user_5777f071/voice-process-helper
- 坐标：
@user_5777f071/voice-process-helper
