前言¶
做短視頻、播客或產品 Demo 時，經常需要一段貼合情緒的配樂或完整歌曲。自己作曲門檻高，去素材站挑又難對上文案和節奏。若希望直接在 Cursor、Claude Code 等帶 Skills 的 AI 客戶端裏，用自然語言描述需求並拿到可試聽、可下載的音頻，可以把 SkillHub 上的 AI音樂（@user_87b8e34f/ai-music）裝進當前 Agent 的 skills 目錄，在對話中完成創作與導出。
這是什麼¶
AI音樂 是 SkillHub 社區來源（community）的 design-media 類 Skill，當前版本 1.3.2，由發佈者 user_87b8e34f 維護。它面向需要 AI 音樂生成、AI 音樂創作、AI 作曲、AI 寫歌 等能力的中文創作者：你在助手裏說明主題、風格、情緒、歌詞或使用場景，即可生成歌曲或 BGM；生成結果可試聽、可下載，並會同步到海綿音樂賬號，便於在「海綿音樂 AI 寫歌」小程序與 lexuan.club 網頁繼續管理。
Skill 標籤標明 requires_api_key=true，使用前需按 Skill 包內說明配置 API 密鑰，具體字段名以安裝後的 SKILL.md 爲準。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在頁面單獨展開的能力不寫入本文。
- 文本驅動創作：用主題、風格、情緒、歌詞或使用場景描述需求，由助手調用 Skill 完成生成。
- 歌曲與 BGM：輸出可試聽、可下載的完整歌曲或背景音樂。
- 賬號同步：作品同步到海綿音樂賬號，可在小程序與 lexuan.club 側繼續管理。
當你在對話裏提到 AI 音樂、ai 音樂、AI 音樂創作、AI 音樂生成、AI 作曲、AI 寫歌、AI 歌曲或生成音樂等意圖時，Agent 應匹配並啓用該 Skill（以各客戶端 Skills 機制爲準）。
安裝與啓用¶
官方頁面要求：依據 SkillHub 安裝文檔，安裝座標 @user_87b8e34f/ai-music。下面介紹通用 CLI 流程；不同客戶端的差異主要在 skills 目錄路徑。
1、檢查或安裝 skillhub CLI¶
先確認本機是否已有 CLI：
command -v skillhub && skillhub --version
若未安裝，可按官方腳本安裝（完整包含 CLI 與默認 Skill；僅需 CLI 時加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安裝 AI音樂 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前環境會被識別的 skills 目錄；裝到錯誤位置（例如默認的 ./skills/）可能導致 Agent 讀不到，需重啓後仍無效。
skillhub install user_87b8e34f/ai-music --dir <你的 skills 目錄>
常用路徑示例（以 官方安裝文檔 爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
Cursor 用戶可寫成：
skillhub install user_87b8e34f/ai-music --dir ~/.cursor/skills/
安裝完成後，按 Skill 包內 SKILL.md 配置 API Key，並重啓或刷新 Agent 使 Skills 生效。
典型用法¶
官方未提供固定命令行示例；典型流程是在已啓用 Skill 的對話中直接描述需求。可參考下列表述方式（需替換爲你的實際主題與約束）：
- 說明體裁與用途，例如：「生成一段 30 秒左右的輕快 BGM，用於產品功能介紹短視頻。」
- 補充風格與情緒，例如：「獨立民謠、略帶懷舊，人聲爲主，中文歌詞。」
- 若已有歌詞，可粘貼全文並說明希望成曲或僅伴奏。
- 生成完成後在對話中試聽鏈接或下載路徑，併到海綿音樂賬號或 lexuan.club 覈對同步結果。
具體參數、輪次與輸出格式以安裝包內 SKILL.md 及助手執行日誌爲準。
適用場景與注意¶
適合誰：需要在中文工作流裏快速試曲、寫歌或配 BGM，且希望作品落在海綿音樂生態裏統一管理的創作者與開發者。
使用注意：
- 必須配置 API Key（
requires_api_key=true）；未配置時 Skill 無法正常調用後端。 - 安裝目錄務必對應當前 AI 客戶端，避免裝到未被加載的路徑。
- 評分、下載量等商店數據會變動；查閱時以 SkillHub 頁面實時展示爲準（例如 SkillHub 詳情頁）。
結尾¶
AI音樂 把「描述需求 → 生成可下載音頻 → 海綿音樂側管理」串進 AI 助手對話，適合把配樂和寫歌從單獨開網頁、切工具的流程裏收攏回來。安裝與座標說明見官方地址：https://api.skillhub.cn/user_87b8e34f/ai-music，頁面展示與安裝指引亦可訪問 https://www.skillhub.cn/skills/user_87b8e34f/ai-music。
