前言¶
做 Demo、短視頻配樂或原型驗證時，經常需要一段能直接用的歌，而不是純伴奏。自己搭 Suno 相關流程要查文檔、管密鑰、對齊調用方式，和日常在 Cursor 或 Claude Code 裏寫代碼的節奏不一致。SkillHub 上的社區 Skill suno music（座標 @user_f95f21b8/dlazy-suno-music，當前版本 1.0.9）把能力封裝成 Agent 可讀的 SKILL.md 格式：你用文字描述歌詞或風格，由 Agent 按 Skill 指引調用 Suno AI，產出帶人聲和伴奏的完整歌曲。
這是什麼¶
suno music 的定位可以用官方簡介概括：
Automatically create complete songs with vocals and accompaniment based on lyrics or style descriptions using Suno AI.
來源爲 SkillHub community 條目，發佈者爲 user_f95f21b8，分類爲 design-media。頁面標註 requires_api_key=true，即使用前需要自行準備 Suno 相關 API 密鑰；密鑰的具體環境變量名或配置字段以安裝後 Skill 包內的 SKILL.md 爲準，本文不臆造配置項。
SkillHub 展示頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-suno-music
安裝座標 API：https://api.skillhub.cn/user_f95f21b8/dlazy-suno-music
核心功能¶
結合官方簡介與 SkillHub 標籤，可覈實的能力如下：
- 輸入方式：支持基於歌詞，或基於風格描述發起創作，不要求你先具備編曲工程文件。
- 輸出形態：目標是 complete songs——同時包含 vocals（人聲） 與 accompaniment（伴奏），而不是僅生成器樂或單軌素材。
- 後端能力：生成邏輯依賴 Suno AI；Skill 本身負責在 Agent 會話中規範何時、如何觸發這類能力。
- 前置條件：SkillHub 標籤標明需要 API Key；未配置密鑰時，Agent 無法完成實際生成，需你先完成密鑰配置。
SkillHub 當前統計（以頁面抓取爲準）：評分 100000，下載 1062 次，安裝記錄 1 次。這些數字只反映商店側曝光，不代表生成質量或 SLA。
安裝與啓用¶
下面介紹在常見 Agent 環境中安裝本 Skill 的步驟。安裝規範以 SkillHub 官方文檔爲準。
1、確認 skillhub CLI¶
先檢查本機是否已有 CLI：
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
文檔地址：https://skillhub.cn/install/skillhub.md
2、安裝 suno music¶
SkillHub 技能頁給出的安裝座標爲 @user_f95f21b8/dlazy-suno-music。安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄，否則默認會裝到 ./skills/，Agent 可能識別不到。
skillhub install @user_f95f21b8/dlazy-suno-music --dir <你的 skills 目錄>
各客戶端常用路徑（摘自 SkillHub 安裝文檔，按你本機環境選用）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
也可將下面提示交給 Agent，讓其按安裝文檔拉取同一座標（與技能頁文案一致）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_f95f21b8/dlazy-suno-music`。
3、API Key 與啓用¶
Skill 標註 requires_api_key=true。安裝完成後，打開技能目錄中的 SKILL.md，按其中說明配置 Suno API 密鑰並重啓或重新加載 Agent（若你的客戶端需要）。在密鑰與 Skill 均就緒後，才能在對話裏觸發音樂生成。
典型用法¶
官方公開資料未附帶逐條複製的 CLI 示例；用法本質是：在已啓用該 Skill 的 Agent 對話中，用自然語言提供歌詞或風格描述，由 Agent 按 SKILL.md 調用 Suno AI。
可復現的交互模式如下（表述需與你本地 Skill 文檔一致，此處僅說明輸入類型）：
- 歌詞驅動：提供完整或分段歌詞，並補充流派、情緒、速度等約束（若 Skill 文檔支持）。
- 風格驅動：不提供完整歌詞，用文字描述曲風、樂器、人聲類型、場景（如「80 年代合成器流行，女聲，適合片頭」）。
- 結果：由 Suno 返回完整歌曲產物；具體文件格式、下載方式以 Skill 執行時的輸出爲準。
若安裝後 Agent 未按預期調用 Suno，先覈對 skills 目錄、--dir 是否指向正確路徑，以及 API Key 是否已按 SKILL.md 配置。
適用場景與注意¶
適合誰
- 需要在開發或內容流程裏快速試歌、試風格，又不想單獨維護 Suno 調用腳本的開發者或創作者。
- 已使用 Cursor、Claude Code、Codex 等支持 Skills 的客戶端，希望把「寫詞 / 寫風格 → 成歌」收進同一對話鏈路的人。
限制與注意
- 社區來源：
source: community，維護節奏與官方 Skill 可能不同，升級前留意 SkillHub 上的版本號（當前 1.0.9）。 - 密鑰與費用：依賴 Suno AI 與有效 API Key，用量與計費以 Suno 及你賬號策略爲準。
- 合規：生成音樂的版權與使用範圍須符合 Suno 服務條款及你所在場景（商用、平臺分發等）的要求。
- 資料邊界：本文未讀取技能包內
SKILL.md全文；高級參數、錯誤碼、速率限制等以安裝後的 Skill 文檔爲準。
結尾¶
suno music 把「歌詞或風格描述 → Suno AI → 帶人聲與伴奏的完整歌曲」收斂成 Agent Skill，適合在 SkillHub 生態裏一鍵安裝到 Cursor 等環境的 skills 目錄。使用前準備好 API Key，並按 https://skillhub.cn/install/skillhub.md 安裝 @user_f95f21b8/dlazy-suno-music。技能主頁：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-suno-music 。
