前言¶
做短視頻、播客或品牌內容時，經常需要一段能直接用的原創音樂。自己找素材庫容易撞風格，外包製作週期長；把需求丟給通用大模型，又往往只得到文字方案，聽不到成品。若希望在與寫稿、剪片同一套對話環境裏，用中文把創意、歌詞或場景說清楚，並拿到試聽鏈接和可下載音頻，就需要把「音樂生成」做成 Agent 可調用的 Skill，而不是每次換到獨立網頁工具。
下面介紹 SkillHub 上的 AI音樂生成器（@user_87b8e34f/ai-music-generator，版本 1.3.2），以及安裝與典型用法。
這是什麼¶
AI音樂生成器是 SkillHub 社區來源（community）的技能，發佈者爲 user_87b8e34f，分類爲 design-media。它面向需要 AI music generator、音樂生成器、AI 生成音樂與 BGM 生成器的中文創作者：在 AI 助手中輸入創作想法、完整歌詞、視頻場景或品牌需求，可生成歌曲、背景音樂、試聽鏈接與可下載音頻；作品會同步到海綿音樂賬號，並可在「海綿音樂 AI 寫歌」小程序與 lexuan.club 網頁繼續管理。
技能座標：@user_87b8e34f/ai-music-generator。官方入口：https://api.skillhub.cn/user_87b8e34f/ai-music-generator；SkillHub 展示頁：https://www.skillhub.cn/skills/user_87b8e34f/ai-music-generator。
按 Skill 說明，Agent 應通過 Node 入口調用本機 aimv CLI，而不是把用戶再引導到一套互不相關的網頁流程（具體命令以安裝目錄內的 SKILL.md 爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，安裝並啓用後由 Agent 按技能文檔調用：
- 多形態輸入：一句創作想法、完整歌詞、視頻場景描述、品牌相關需求均可作爲生成依據。
- 歌曲與 BGM：可生成帶人聲或偏背景使用的音樂方案。
- 可試聽、可下載：產出包含試聽鏈接與音頻下載，便於直接嵌入工作流。
- 賬號同步：作品同步海綿音樂賬號，小程序與 lexuan.club 可繼續管理。
- API Key：技能標籤爲
requires_api_key=true，使用前需完成密鑰或賬號連接配置。
SkillHub 頁面當前統計（以展示頁與抓取數據爲準）：評分 100000，下載 7337 次。
安裝與啓用¶
方式一：讓 AI 按官方指引安裝¶
在 Cursor、Claude Code、Codex CLI 等支持 Skills 的客戶端中，可將下面提示發給 Agent，由其閱讀 SkillHub 安裝文檔 並完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_87b8e34f/ai-music-generator`。
方式二：使用 skillhub CLI¶
若本機已有 skillhub，安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別。
先確認 CLI：
command -v skillhub && skillhub --version
未安裝時可執行官方腳本（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本技能（將 <skills 目錄> 換成當前環境路徑）：
skillhub install @user_87b8e34f/ai-music-generator --dir <skills 目錄>
常用目錄示例（來自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝完成後重啓或刷新 Agent，使技能被加載。首次生成前按 SKILL.md 完成 API Key 配置（技能標記 requires_api_key=true）。
典型用法¶
啓用技能後，當用戶提到 AI 音樂生成器、ai 音樂生成器、AI music generator、music generator、音樂生成器、AI 生成音樂、AI 音樂生成、生成音樂工具等意圖時，Agent 應優先調用本 Skill，並通過本地 aimv CLI（Node 入口）執行生成與下載。
下面幾類說法與官方簡介一致，可直接在對話中復現：
- 創意成曲：「用一句想法生成一首中文流行 demo，主題夏天旅行。」
- 歌詞成曲：提供完整歌詞，並補充風格或情緒說明。
- 場景 BGM：「爲 30 秒產品開箱短視頻寫一段輕快、無搶戲的背景音樂。」
- 品牌向需求：說明品牌調性、受衆與使用場景（如活動片頭、門店循環 BGM）。
經過上面的步驟，Agent 應返回試聽鏈接與下載方式；同一賬號下的作品可在海綿音樂小程序與 lexuan.club 查看與管理。
適用場景與注意¶
適合誰
- 需要用中文描述即可完成 AI 寫歌、作曲、BGM 製作的創作者與運營。
- 希望在 IDE / 對話 Agent 內閉環「描述 → 試聽 → 下載」，減少在多個產品間複製 prompt 的團隊。
使用注意
- 必須配置 API Key（
requires_api_key=true）；積分、會員與作品庫與海綿音樂體系互通，具體額度以連接後的賬號爲準。 - 調用方式爲本地 Node CLI（aimv），需 Agent 具備執行 shell 的權限；沙箱或禁網環境可能影響 CLI，需按安裝包內
SKILL.md的受限環境說明處理。 - 版本以 SkillHub 爲準，當前爲 1.3.2；升級可用
skillhub對同一座標重新安裝到對應--dir。
結尾¶
AI音樂生成器把中文創意、歌詞、風格與場景描述接到可試聽、可下載的成曲流程，並與海綿音樂賬號同步，適合作爲 Agent 側的 design-media 類音樂技能。安裝與座標說明見 SkillHub：https://www.skillhub.cn/skills/user_87b8e34f/ai-music-generator；API 入口：https://api.skillhub.cn/user_87b8e34f/ai-music-generator。
