前言¶
做短視頻 BGM、活動主題曲或 Demo 時，常見路徑是：在 Suno 網頁裏反覆試 prompt，再把音頻拷回本地。若你已經在 Cursor、Claude Code 等環境裏用對話推進創作，更希望用同一套交互把「寫詞、定風格、出歌、試聽」串起來，而不是在多個產品之間切換。
下面介紹 SkillHub 上的 Suno AI寫歌（座標 @org-0bqts5ar/suno-ai-songwriting）。它把 Suno 的音樂生成能力接到 AI 助手側：你在對話裏提供主題、歌詞、標題、風格或參考音頻，由助手按 Skill 指引調用能力，產出可試聽、可下載的完整歌曲及候選版本。音樂生成本身由 Suno 提供，Skill 負責在助手裏的安裝與使用流程。
這是什麼¶
Suno AI寫歌 是 SkillHub 分類 design-media 下的企業來源 Skill，當前版本 1.3.3，發佈者爲樂萱同行科技（深圳）有限公司。
一句話定位：面向常搜「suno ai寫歌」「suno寫歌」「Suno AI song」「suno歌曲生成」「中文 Suno」的創作者，在 AI 助手內完成 Suno 側的歌曲生成與結果獲取。SkillHub 頁面標註標籤 requires_api_key=true，使用前需準備相應 API 密鑰（具體變量名與申請方式以安裝後 Skill 包內 SKILL.md 爲準）。
官方入口：
- API 文檔頁：https://api.skillhub.cn/org-0bqts5ar/suno-ai-songwriting
- SkillHub 展示頁：https://www.skillhub.cn/skills/org-0bqts5ar/suno-ai-songwriting
核心功能¶
以下能力均來自 SkillHub 簡介與頁面說明，未單獨列出的細節不展開。
- 多形態輸入：支持歌曲主題、完整或片段歌詞、曲名、風格方向，以及參考音頻，便於從「一句話想法」或「已有草稿」起步。
- 完整歌曲輸出：生成可試聽的完整曲目，而非僅 MIDI 或分軌佔位。
- 候選版本：可得到多個候選版本，便於在助手對話裏對比再選定。
- 下載：生成結果支持下載到本地，方便接入剪輯、發佈流程。
- 能力歸屬：實際音樂生成由 Suno 提供；Skill 解決的是「在 AI 助手裏怎麼描述需求、怎麼拿結果」。
安裝與啓用¶
SkillHub 推薦兩種方式：讓 AI 按安裝文檔操作，或本機用 skillhub CLI 安裝到當前 Agent 的 skills 目錄。
方式一：提示詞安裝¶
將下面意圖發給已支持 Skill 的 AI（安裝說明原文見 SkillHub 技能頁）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 @org-0bqts5ar/suno-ai-songwriting。
Agent 會按文檔檢查 CLI、選擇 skills 目錄並執行安裝。
方式二：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
安裝本 Skill 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認裝到 ./skills/ 可能不會被識別：
skillhub install @org-0bqts5ar/suno-ai-songwriting --dir <skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔，按你實際環境選用）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或項目下 .windsurf/skills/ |
裝到對應目錄後，按你所用客戶端要求刷新或重啓 Agent，使 Skill 被加載。API 密鑰配置請遵循 Skill 包內說明（SkillHub 已標記需要 API Key）。
典型用法¶
官方資料未提供固定對話腳本，但輸入輸出邊界明確。可在助手啓用該 Skill 後，用自然語言組合下列要素，讓 Agent 按 SKILL.md 調用 Suno：
- 只給方向：說明主題與風格（例如節日氛圍、電子流行、慢板抒情），並可選曲名；由助手補全歌詞與編曲方向後生成。
- 自帶歌詞：粘貼歌詞，補充 BPM、人聲性別、語言與參考藝人風格（表述方式以 Suno 支持爲準），生成對應編曲版本。
- 參考音頻：提供參考曲或哼唱片段的路徑或鏈接（若 Skill 支持），說明希望保留的節奏或情緒。
- 多版本對比：明確要求生成多個候選版本，試聽後在對話中指定保留某一版並下載。
經過上面的步驟，你應能在對話裏拿到試聽鏈接或本地文件路徑；具體字段名、輪詢方式以安裝後的 Skill 文檔爲準。
適用場景與注意¶
適合誰
- 內容創作者、獨立開發者、小團隊，需要在助手工作流裏快速出歌、改歌。
- 已使用或計劃使用 Suno，希望減少在網頁與本地工具之間來回切換的人。
使用注意
- API Key：SkillHub 標註
requires_api_key=true，未配置密鑰時無法完成生成；費用與配額以 Suno 及 Skill 提供方說明爲準。 - 合規與版權：生成音樂用於商用或平臺發佈前，請自行確認 Suno 服務條款及目標平臺對 AI 生成內容的規則。
- 版本：本文依據 SkillHub 頁面 v1.3.3；升級可用
skillhub在相同--dir下更新，或讓 AI 按 skillhub.md 操作。 - 數據口徑：SkillHub 展示頁會變動評分與下載量；撰寫時頁面可見爲企業 Skill、高評分條目，具體數字以打開頁面時爲準。
結尾¶
Suno AI寫歌 把 Suno 的歌曲生成接到 AI 助手：用主題、歌詞、風格或參考音頻驅動，得到可試聽、可下載的完整曲與候選版本。若你已在 Cursor 或 Claude Code 裏用 Skill 擴展能力，可按上文安裝座標 @org-0bqts5ar/suno-ai-songwriting，從 SkillHub 官方頁獲取最新說明：
https://www.skillhub.cn/skills/org-0bqts5ar/suno-ai-songwriting
