前言¶
做視頻、播客或獨立項目時，經常需要一段可商用的 BGM，或一首帶歌詞的完整歌曲。自己作曲門檻高，只在 Suno 網頁裏來回切界面，又很難和寫腳本、寫文案的 AI 工作流連在一起。若你希望在 Cursor、Claude Code 等環境裏，用中文描述主題、貼歌詞或指定風格，直接拿到可試聽、可下載的音頻，並把作品留在統一賬號裏繼續管理，可以瞭解 SkillHub 上的社區 Skill「Suno AI音樂生成」（@user_87b8e34f/suno-ai-music，當前版本 1.3.2）。
這是什麼¶
「Suno AI音樂生成」是 SkillHub 分類 design-media 下的社區 Skill，由發佈者 user_87b8e34f 維護。它面向想用中文完成 Suno AI 音樂、AI 寫歌、中文 Suno 或同類替代方案的創作者。
實際生成能力由 Suno 提供；Skill 的作用是把這類需求接到 AI 助手側：你在對話裏說明歌曲主題、歌詞、風格、BGM 場景或參考音頻，助手按 Skill 指引調用能力，產出可試聽、可下載的音樂。生成結果會同步到海綿音樂賬號，可在「海綿音樂AI寫歌」小程序和 lexuan.club 網頁繼續管理。
Skill 帶有 requires_api_key=true 標籤，使用前需按 Skill 說明配置相應 API 密鑰（具體字段以安裝後的 Skill 文檔爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，安裝後行爲以 Skill 包內說明爲準。
- 主題與歌詞驅動成曲：用自然語言描述歌曲主題，或直接提供歌詞，生成完整音樂作品。
- 風格與場景：可指定音樂風格；也可按 BGM 使用場景描述需求，便於配樂類產出。
- 參考音頻：支持以參考音頻爲輸入進行改編或延續（具體參數以 Skill 內指引爲準）。
- 交付與同步：生成結果可試聽、可下載；並同步到海綿音樂賬號，便於在小程序與網頁端統一管理。
當你在對話裏提到 suno、Suno AI 音樂、中文 suno、suno 替代、suno 音樂生成等意圖時，Agent 可加載本 Skill 處理上述需求。
安裝與啓用¶
安裝流程遵循 SkillHub 通用文檔 SkillHub 安裝與優先源配置。下面先做環境檢查，再把 Skill 裝到當前 Agent 實際使用的 skills 目錄（裝錯目錄會導致助手識別不到，必要時需重啓客戶端）。
1、檢查是否已安裝 skillhub CLI
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
官方頁面給出的座標爲 @user_87b8e34f/suno-ai-music。安裝時必須用 --dir 指向當前環境的 skills 目錄，例如：
skillhub install @user_87b8e34f/suno-ai-music --dir ~/.cursor/skills/
其他常見路徑（同樣來自 SkillHub 安裝文檔，按你實際使用的客戶端選擇其一）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可將官方安裝說明發給 AI，讓其按文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝
@user_87b8e34f/suno-ai-music。
3、API 密鑰
Skill 標記爲需要 API Key。安裝後打開 Skill 包內的 SKILL.md 或配套說明，按發佈者要求填寫密鑰與端點，再在新對話中驗證能否正常生成。
典型用法¶
官方資料未給出固定 CLI 一鍵示例，典型路徑是在已啓用該 Skill 的 AI 助手中用中文描述需求。下面幾類表述與官方能力描述一致，便於復現：
- AI 寫歌：說明歌曲主題、情緒與風格，例如「寫一首 90 秒、偏民謠的中文情歌，主題是小城夏天」。
- 歌詞成曲：直接粘貼歌詞，並補充人聲/編曲風格，例如「用下面歌詞生成一首流行搖滾，副歌要更飽滿」。
- BGM：描述使用場景與節奏，例如「需要 2 分鐘、無歌詞的輕快 BGM，適合科技產品宣傳片」。
- 參考音頻：說明參考文件路徑或上傳參考音頻，並寫清希望保留或改變的元素（如節奏、情緒），由助手按 Skill 流程提交生成。
生成完成後，在對話中獲取試聽與下載鏈接，併到海綿音樂小程序或 lexuan.club 查看是否已同步到賬號。
適用場景與注意¶
適合誰
- 習慣在 AI 編程/寫作環境裏一站式產出內容，又不想爲每首歌單獨打開 Suno 網頁的創作者。
- 需要中文交互、並希望作品落在海綿音樂賬號統一管理的用戶。
需要注意
- 音樂能力依賴 Suno 與相關服務可用性；網絡、配額與 API Key 失效會導致生成失敗，需按 Skill 文檔排查。
- 社區來源（
community）Skill，升級與兼容性以 SkillHub 上版本爲準，當前頁面標註爲 v1.3.2。 - 參考音頻、版權與商用範圍請遵守 Suno、海綿音樂及你所在平臺的服務條款，本文不替代法律意見。
結尾¶
「Suno AI音樂生成」把 Suno 的寫歌、配樂與參考音頻類需求接到 AI 助手工作流裏，並和海綿音樂賬號打通，適合中文創作者在對話中完成從描述到成曲的閉環。安裝與詳情見 SkillHub 官方頁面：
