前言¶
企业客服热线往往要录一整套 IVR：欢迎语、按键菜单、排队等待、转接提示、非工作时间说明，以及按键错误或系统异常时的兜底话术。常见做法是找配音、按条导出音频，再手工对照交换机或软交换的语音菜单格式整理文件名与标签，改一版话术就要重录、重命名、重导入。
下面介绍 SkillHub 上的 客服语音·IVR语音包（@beatra-ai/ivr-voice-pack）。它面向「带标签的客服语音包」这一交付形态：按 IVR 常见节点组织录制与标注，并产出可导入交换机的语音菜单，减轻口播脚本与运维侧文件结构之间的手工对齐。
这是什么¶
客服语音·IVR语音包 是 SkillHub 企业源（enterprise）中的一款 business-ops 类 Skill，当前版本 0.1.9，由发布者 beatra 维护。页面标注 requires_api_key=false，安装与使用不依赖额外 API Key 配置。
一句话定位：把热线话术做成带标签的客服语音包；配套的 IVR 语音包与电话树语音能力，会按欢迎、菜单、等待、转接、非工作时间和错误提示等节点完成录制，并交付可导入交换机的语音菜单。适用场景包括 IVR 语音、客服热线口播和分机引导音频。
- SkillHub 页面：https://www.skillhub.cn/skills/beatra-ai/ivr-voice-pack
- API 条目：https://api.skillhub.cn/beatra-ai/ivr-voice-pack
核心功能¶
以下能力均来自官方简介，未在页面单独展开的接口或字段不在此列举。
- 话术结构化：将热线文案组织为带标签的客服语音包，便于与电话树节点一一对应。
- 按 IVR 节点录制：覆盖欢迎、菜单、等待、转接、非工作时间和错误提示等典型热线语音类型。
- 电话树语音交付：产出与电话树结构匹配的语音素材，而不仅是零散单条 MP3。
- 交换机可导入：交付物面向「可导入交换机的语音菜单」，便于运维侧挂到现有 PBX / 软交换流程。
- 场景覆盖：IVR 主流程语音、客服热线口播、分机引导类音频均可纳入同一套打包思路。
安装与启用¶
SkillHub 官方建议：让 Agent 按安装文档操作，或在本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。装错目录时，Skill 可能落在默认 ./skills/ 而不会被当前客户端识别。
1、确认 CLI¶
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（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
2、安装本 Skill¶
将 @beatra-ai/ivr-voice-pack 安装到当前环境的 skills 目录，--dir 必须指向该目录：
skillhub install @beatra-ai/ivr-voice-pack --dir <skills 目录>
常见客户端 skills 路径（以 SkillHub 安装文档为准）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
也可向 AI 发送官方提示词，让其读取安装说明后完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@beatra-ai/ivr-voice-pack`。
安装后若客户端需要重启或重新加载 skills，按所用产品的惯例操作即可；SkillHub 文档强调 --dir 与识别路径一致。
典型用法¶
公开页面未附带逐步复制的对话示例或 SKILL.md 全文。结合简介，可复现的工作流如下（具体交互以安装后的 Skill 指引为准）：
- 整理话术：按欢迎、菜单、等待、转接、非工作时间、错误提示等节点列出文案，并标明各条在电话树中的用途（标签与节点名建议与交换机侧命名一致，减少导入后改名）。
- 启用 Skill：在已安装
@beatra-ai/ivr-voice-pack的 Agent 中说明目标（例如「生成可导入交换机的 IVR 语音包」），并提供完整话术或现有脚本草稿。 - 按节点生成语音包：由 Skill 按 IVR 语音包 / 电话树语音的逻辑完成录制与打包，输出带标签的客服语音包及可导入的语音菜单结构。
- 导入交换机：将交付物按贵司 PBX 或软交换的语音菜单导入规范上传；导入前在测试分机或沙箱环境试听各节点，重点核对菜单按键与错误提示是否齐全。
若需检索或核对坐标，可在 CLI 中搜索：
skillhub search ivr-voice-pack
适用场景与注意¶
适合谁
- 需要上线或改版客服热线 IVR，且希望话术、标签与交换机语音菜单一次对齐的团队。
- 负责运维或实施的同事，希望减少「配音文件一堆、菜单映射靠表格」的协作成本。
- 同时要维护分机引导、口播提示等与主 IVR 同源话术的场景。
限制与注意
- 页面未声明具体支持的交换机品牌、音频编码或采样率；导入前务必对照设备文档做格式校验。
- 非工作时间、错误提示等边界话术容易在改版时被漏录，建议在话术清单里用检查表逐项勾选。
- SkillHub 抓取元数据显示评分为 100000、下载 4871、安装 0；安装数为 0 只反映统计口径，不代表 Skill 不可用，以你本机安装与 Agent 加载结果为准。
- 不涉及 API Key 并不等于无需审核合规：热线口播内容、录音授权与对外公示仍须按企业制度处理。
结尾¶
客服语音·IVR语音包 把 IVR 常见节点（欢迎、菜单、等待、转接、非工作时间、错误提示）和「带标签语音包 + 可导入语音菜单」绑在一起，适合从话术到交换机落地的一条龙协作。安装坐标为 @beatra-ai/ivr-voice-pack（v0.1.9），官方入口：https://www.skillhub.cn/skills/beatra-ai/ivr-voice-pack。
