前言¶
視頻腳本、播客片頭、小遊戲配樂，常常卡在「有想法、沒成品」：自己不會作曲，外包週期長，通用素材庫又難貼合情緒。把需求交給網頁裏的音樂生成產品，往往還要單獨開站、導出再拖回工程。
下面介紹 SkillHub 上的 AI音樂創作（座標 @org-0bqts5ar/ai-music-creator-pro）。它以通用 SKILL.md 形式裝進本地 Agent，讓 Cursor、Claude Code 等客戶端在對話裏直接走寫歌、歌詞成曲、BGM 和參考音頻改編，並支持結果下載。
這是什麼¶
AI音樂創作 是面向創作者的 AI 音樂工具 Skill，當前版本 v1.3.3，分類爲 design-media，來源標註爲 enterprise，由 樂萱同行科技（深圳）有限公司 發佈。
一句話定位：無論手裏只有一句創作想法、完整歌詞、純器樂 BGM 需求，還是想基於一段參考音頻繼續改編，都可以通過已啓用該 Skill 的 AI 助手在本地會話裏生成作品並拿到可下載結果。
官方入口：
- SkillHub 展示頁：https://www.skillhub.cn/skills/org-0bqts5ar/ai-music-creator-pro
- API 座標頁：https://api.skillhub.cn/org-0bqts5ar/ai-music-creator-pro
頁面標籤標明 requires_api_key=true，使用前需按 Skill 說明準備對應 API 密鑰（具體字段名以安裝後的 SKILL.md 爲準）。
核心功能¶
以下能力均來自官方簡介，未在資料中出現的細節不展開：
- 寫歌：從創作意圖出發生成歌曲類內容。
- 歌詞成曲：在已有歌詞基礎上生成配套音樂。
- BGM：生成純音樂背景，用於視頻、播客、演示等場景。
- 參考音頻改編：上傳或指定參考音頻，在風格或結構上做延續性創作。
- 結果下載：生成完成後可將作品下載到本地，便於接入剪輯或發佈流程。
SkillHub 側統計（以抓取資料爲準）：評分 100000，下載 2756 次；安裝計數在抓取時爲 0（以頁面實時數據爲準）。
安裝與啓用¶
安裝流程遵循 SkillHub 通用文檔 skillhub.cn/install/skillhub.md。官方頁面給出的提示是：讓 AI 按該文檔安裝 @org-0bqts5ar/ai-music-creator-pro。
1、安裝 SkillHub CLI（若尚未安裝）¶
先確認本機是否已有 skillhub：
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
2、安裝本 Skill 到當前 Agent 的 skills 目錄¶
文檔要求安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 且可能不被加載。
skillhub install org-0bqts5ar/ai-music-creator-pro --dir <你的 skills 目錄>
常用客戶端路徑（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按所用客戶端說明重啓或刷新 Skill 列表，使 SKILL.md 被 Agent 讀取。
3、API 密鑰¶
Skill 標記爲需要 API Key。在對話中首次使用前，按安裝包內 SKILL.md 的說明配置密鑰；未在公開頁面列出的環境變量名或配置文件路徑，此處不臆造。
典型用法¶
公開頁面未附帶逐條複製的 CLI 示例，實際用法是：在已啓用 Skill 的會話裏用自然語言說明創作類型與素材，由助手按 Skill 流程調用後端能力。
可按官方簡介中的幾類輸入組織需求（表述可自定，不必拘泥措辭）：
- 只有想法：說明風格、情緒、用途（例如片頭、15 秒預告），請求生成歌曲或 BGM。
- 已有歌詞：粘貼歌詞，說明曲風、速度、是否需要人聲，請求「歌詞成曲」。
- 純 BGM：強調無人聲、時長與情緒，用於配樂場景。
- 參考音頻：提供參考文件或鏈接（以 Skill 支持的方式爲準），說明保留或改編的方向。
- 交付：生成結束後，按助手提示執行結果下載，將音頻納入後續剪輯或發佈。
若助手未自動選用該 Skill，可明確提到 Skill 名稱「AI音樂創作」或座標 @org-0bqts5ar/ai-music-creator-pro，並確認 API Key 已配置。
適用場景與注意¶
適合誰
- 需要 AI 音樂、AI 音樂生成、AI 寫歌、AI 作曲或檢索 ai music creator 類能力的創作者。
- 已在 Cursor、Claude Code、Codex 等環境使用 Skills，希望音樂能力留在同一對話與工程上下文中的人。
限制與注意
- 企業來源 Skill（
enterprise），使用條款與配額以發佈方與 SkillHub 說明爲準。 - 必須配置 API Key；無密鑰時無法完成生成。
- 安裝目錄錯誤是常見坑：務必
skillhub install ... --dir <正確路徑>，否則 Agent 讀不到 Skill。 - 參考音頻改編涉及版權與授權，上傳或引用第三方音頻前請自行確認合規。
- 生成質量、時長、格式等以 Skill 當前版本（1.3.3）實際行爲爲準，本文不列舉未公開的接口參數。
結尾¶
AI音樂創作 把寫歌、歌詞成曲、BGM、參考改編和下載串進本地 AI 助手，減少在多個網站之間切換。若你正在 SkillHub 上找 design-media 類音樂能力，可從官方頁查看說明並安裝：
https://www.skillhub.cn/skills/org-0bqts5ar/ai-music-creator-pro
