前言¶
做短視頻 BGM、活動主題曲或產品 demo 時，常見路徑是：自己寫詞、找編曲、再進 DAW 混一版。流程長，且「先有一首能聽的完整歌」往往比精修更重要。若你已經在 Cursor、Claude Code 等環境裏用 Agent 處理文案和素材，把「寫歌」也交給同一套對話流程，可以減少在多個工具之間切換的成本。
下面介紹 SkillHub 上的 AI寫歌生成器（@org-0bqts5ar/ai-write-song）：在對話裏輸入主題、歌詞或風格方向，由 AI 助手調用該 Skill 生成可試聽、可下載的完整歌曲，並附帶項目鏈接與兩首候選版本。
這是什麼¶
AI寫歌生成器 是面向 design-media 分類的 Agent Skill，座標 @org-0bqts5ar/ai-write-song，當前版本 1.3.3，來源爲 enterprise，由 樂萱同行科技（深圳）有限公司 發佈。
它解決的是：在 Agent 對話中，用自然語言描述創作意圖（從一句主題到完整歌詞、標題和風格），快速得到完整歌曲輸出，而不是隻生成文字歌詞或 MIDI 說明。官方簡介明確支持檢索場景如 AI寫歌、寫歌AI、自動寫歌、write song AI、AI歌曲生成器等需求。
SkillHub 頁面統計（以抓取資料爲準）：評分 100000，下載 1451 次。技能標籤包含 requires_api_key=true，使用前需按 Skill 說明配置 API 密鑰。
核心功能¶
以下能力均來自官方簡介與 SkillHub 頁面，未單獨覈實的接口細節不展開。
- 多種輸入粒度：可只給一句主題；也可提供完整歌詞，並補充標題與風格方向。
- 完整歌曲產出：生成可試聽、可下載的完整歌曲（非僅文本歌詞）。
- 雙候選版本：一次流程返回 兩首候選歌，便於對比選版。
- 項目鏈接：結果中包含 項目鏈接，便於後續打開或管理生成內容。
安裝與啓用¶
官方安裝指引爲：根據 SkillHub 安裝文檔 安裝 @org-0bqts5ar/ai-write-song。也可在 SkillHub 技能頁將安裝提示詞發給當前 AI，讓其按同一文檔完成安裝。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查本機是否已有 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 到當前 Agent 的 skills 目錄¶
安裝技能時必須用 --dir 指向當前 Agent 識別的 skills 目錄；文檔說明默認裝到 ./skills/ 可能不會被 Agent 加載，且安裝後通常需要重啓 Agent。
搜索與安裝示例（將座標替換爲本技能）：
skillhub search ai-write-song
skillhub install org-0bqts5ar/ai-write-song --dir <skills 目錄>
常用客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
3、API Key¶
標籤 requires_api_key=true 表示該 Skill 依賴外部服務密鑰。具體環境變量名、申請入口與填寫方式以安裝後技能包內的 SKILL.md 及發佈方說明爲準；未在公開頁面寫明的內容此處不臆測。
典型用法¶
公開頁面未提供固定 CLI 子命令或 JSON 請求體示例，典型用法即 在已啓用該 Skill 的 Agent 對話中描述創作需求，由 Agent 按 SKILL.md 調用能力。下面三類輸入與官方簡介一致，可直接復現交互方式。
僅主題（最小輸入）
在對話中說明要寫歌，並給出一句主題，例如要求生成一首關於「城市夜景」的歌曲，請返回可試聽鏈接與兩首候選。
主題 + 風格
補充風格方向（如流行、民謠、電子等，以你實際支持的描述爲準），讓 Agent 在生成時約束曲風。
完整歌詞 + 標題 + 風格
粘貼已寫好的歌詞，並給出曲名與風格說明，由 Skill 生成完整歌曲、項目鏈接及兩首候選版本。
經過上面的步驟，你應能在回覆中獲得：完整歌曲（可試聽、可下載）、項目鏈接、兩首候選歌。
適用場景與注意¶
適合誰
- 需要快速出「能聽的完整歌」的內容創作者、運營或產品經理，且已在使用支持 Skill 的 AI 客戶端。
- 正在搜索 AI寫歌、寫歌AI、自動寫歌、write song AI、AI歌曲生成器等方案，希望把能力掛在 Agent 工作流裏的開發者。
需要注意
- API Key：
requires_api_key=true，未配置密鑰時 Skill 可能無法調用後端生成服務。 - 安裝路徑：務必
skillhub install ... --dir指向正確目錄，並按要求重啓 Agent。 - 版本與來源：當前爲 v1.3.3、enterprise 來源；升級與變更以 SkillHub 頁面爲準。
- 版權與商用：生成音樂的授權、商用範圍以發佈方服務條款爲準，使用前請自行確認。
結尾¶
AI寫歌生成器 把「主題 / 歌詞 / 風格 → 完整歌曲 + 雙候選 + 項目鏈接」收斂到 Agent 對話裏，適合把寫歌從獨立工具鏈裏拆出來、交給助手編排的場景。
- SkillHub 技能頁：https://www.skillhub.cn/skills/org-0bqts5ar/ai-write-song
- 官方地址：https://api.skillhub.cn/org-0bqts5ar/ai-write-song
- 安裝說明：https://skillhub.cn/install/skillhub.md
