前言¶
做內容、做遊戲或做短視頻時，經常需要一段能直接用的 BGM 或完整歌曲。自己找素材要碰版權，臨時外包又慢。Suno 一類 AI 音樂能力已經成熟，但多數入口是英文界面或獨立網頁，和日常用的 Cursor、Claude Code 等助手不在一條對話裏。
下面介紹 SkillHub 上的 Suno AI音樂（座標 @user_87b8e34f/suno-ai-pro）。裝好後，你可以在中文對話裏描述主題、歌詞、風格或參考音頻，由助手按 Skill 規範調用能力，生成可試聽、可下載的作品，並同步到海綿音樂賬號繼續管理。
這是什麼¶
Suno AI音樂 是 SkillHub 社區來源（community）的 Agent Skill，當前版本 1.3.2，分類爲 design-media，發佈者爲 user_87b8e34f。
一句話定位：面向中文創作者的 Suno 音樂生成 Skill。實際生成能力由 Suno 提供；Skill 負責在 AI 助手側組織輸入（寫歌、歌詞成曲、BGM、參考音頻改編等場景）並銜接後續作品管理。官方頁面標註 requires_api_key=true，使用前需要配置相應 API 密鑰。
作品會同步到海綿音樂賬號，可在「海綿音樂AI寫歌」小程序和 lexuan.club 網頁繼續管理。
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在頁面單獨列出的細節不展開：
- AI 寫歌：用歌曲主題、風格等自然語言描述，生成完整音樂作品。
- 歌詞成曲：提供歌詞（可含風格說明），生成對應曲目。
- BGM：按場景描述生成背景音樂類作品。
- 參考音頻改編：以參考音頻爲輸入方向之一進行生成或改編（具體參數以 Skill 內說明與助手執行爲準）。
- 試聽與下載：生成結果可試聽、可下載。
- 賬號同步：作品同步至海綿音樂，便於在小程序與網頁端統一管理。
當你在對話裏提到 Suno、Suno AI、Suno AI Pro、suno 音樂等需求時，助手應匹配並啓用本 Skill（以各客戶端的 Skill 發現規則爲準）。
安裝與啓用¶
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查本機是否已有 skillhub：
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、安裝 Suno AI音樂¶
官方頁面要求：依據 SkillHub 安裝說明，安裝座標 @user_87b8e34f/suno-ai-pro。
安裝技能時必須用 --dir 指向當前 Agent 正在使用的 skills 目錄，否則默認會裝到 ./skills/，客戶端可能識別不到。常用路徑示例（來自安裝文檔）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
在對應目錄下執行（將 <skills 目錄> 換成你的實際路徑）：
skillhub install @user_87b8e34f/suno-ai-pro --dir <skills 目錄>
也可讓 AI 助手讀取 https://skillhub.cn/install/skillhub.md 後代爲安裝同一座標。
3、API 密鑰與重啓¶
Skill 標籤爲 requires_api_key=true。按 Skill 包內 SKILL.md 與發佈方說明配置 API Key；未配置時生成類操作通常會失敗。安裝到正確目錄後，按你所用客戶端要求重啓或刷新 Skill 列表。
本 Skill 基於通用 SKILL.md 格式；具體執行鏈路（例如通過 Node 入口調用本地工具）以安裝包內文檔爲準，本文不臆造命令行參數。
典型用法¶
經過上面的步驟啓用後，在已配置 API Key 的助手對話中，用中文直接說明需求即可。下列示例與官方簡介一致，便於復現意圖（實際文件名、時長以生成結果爲準）：
寫一首歌
用 Suno 寫一首中文流行歌，主題是「城市夜跑」，情緒輕快，要有副歌。
歌詞成曲
把下面歌詞做成一首民謠，男聲爲主：[粘貼歌詞]
BGM
生成一段 60 秒左右的輕鬆 BGM，適合科技產品介紹視頻，不要人聲。
參考音頻
參考我提供的這段音頻的節奏和氛圍，做一首同風格但旋律不同的曲子。（若客戶端支持上傳附件，附上參考音頻。）
生成完成後，在對話中試聽或下載；同時可在海綿音樂小程序或 lexuan.club 查看同步作品。
適用場景與注意¶
適合誰
- 需要用中文在 AI 助手內完成 Suno / suno 音樂 / AI 寫歌，而不想單獨切換英文站點的創作者。
- 需要 BGM、成曲與後續在海綿音樂側統一管理的個人或小團隊。
需要注意
- 依賴 Suno 能力與有效 API Key；網絡與配額限制以服務商與 Skill 配置爲準。
- 社區來源 Skill，升級前可用
skillhub查看版本（當前公開版本爲 1.3.2）。 - 參考音頻、版權與商用合規需自行把握；生成物是否可商用以 Suno 及你方授權條款爲準。
- SkillHub 頁面統計（截至抓取）：評分 100000，下載 9936；安裝數在頁面上顯示爲 0，可能與統計口徑有關，不影響本地
skillhub install使用。
結尾¶
Suno AI音樂把 Suno 的寫歌、成曲、BGM 與參考音頻類需求收斂到中文 Agent 對話裏，並接上海綿音樂的試聽、下載與多端管理。若你正在 Cursor 等環境做內容生產，可按本文安裝 @user_87b8e34f/suno-ai-pro 並配置 API Key 後直接使用。
