前言¶
企業客服熱線往往要錄一整套 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。
