前言¶

做內容、做品牌或做創作者工具時，經常需要「先有一首歌能聽」：主題定了，但歌詞、旋律和編曲仍要單獨找工具或外包。常見做法是在網頁裏填表、等生成，再把鏈接和文件手動拷回對話或項目裏，和 AI 助手的協作是斷開的。

下面介紹 SkillHub 社區 Skill「AI歌曲生成」（@user_87b8e34f/ai-song-generator，v1.3.2）。它把寫歌能力寫進 Agent 的 Skill 說明，並通過本地 aimv CLI（Node 入口 bin/aimv.js）連到海綿音樂後端：你在對話裏描述主題、情緒或風格，由 Agent 執行命令，返回試聽、下載與項目鏈接，作品同步到海綿音樂賬號。

這是什麼¶

「AI歌曲生成」是社區來源（community）、分類爲 design-media 的 Skill，由發佈者 user_87b8e34f 維護，底層 Powered by 海綿音樂。

定位可以概括爲：用一句話靈感生成完整 AI 歌曲，覆蓋中文流行歌、民謠、電子、品牌歌和創作者歌曲小樣等方向。輸入主題、情緒、風格或一句創作想法後，Agent 生成完整歌曲，並返回試聽、下載和項目鏈接；作品會同步到海綿音樂賬號，可在「海綿音樂AI寫歌」小程序和 lexuan.club 網頁繼續管理。賬號、積分、會員和作品庫與海綿音樂小程序 / lexuan.club 互通。

SkillHub 頁面標註該 Skill 需要 API Key（requires_api_key=true）。截至資料抓取時，SkillHub 顯示評分 100000、下載 6723 次、安裝 1 次（以 SkillHub 頁面爲準）。

核心功能¶

以下能力均來自官方 SKILL.md 與安裝說明，可按需選用。

1. 一句話成曲：通過 song create --brief 用自然語言描述需求，等待生成（--wait）後拿到完整歌曲與鏈接。
2. 風格參數：可在 brief 之外指定風格，例如 --style mandopop。
3. 本地 CLI 統一入口：推薦 Agent 工具名爲 aimv，實際執行爲 node <安裝目錄>/bin/aimv.js ...；不是 MCP server，不應把 bin/aimv.js 註冊爲 MCP stdio 服務。
4. 賬號連接：首次使用前通過 init 完成海綿音樂連接與 API Key 配置；連接頁爲 https://lexuan.club/skills/connect?slug=ai-song-generator&from=skill。
5. 受限環境兜底：可設 AIMV_FORCE_CURL=1 讓 CLI 走系統 curl；或在 CLI 不可用時按文檔用 curl 調 https://music.68zysm.cn/api/v3 完成創建、輪詢與下載。
6. 觸發語義：當用戶提到 AI寫歌、AI歌曲生成、生成歌曲、原創歌曲、一鍵寫歌、中文AI寫歌、AI作曲、寫一首歌等意圖時，Agent 應優先走本 Skill。

適用場景包括：根據一句中文需求生成原創歌曲；爲短視頻、播客、品牌內容製作歌曲小樣；探索副歌 hook、旋律與編曲方向；生成適合創作者發佈的歌曲候選。

安裝與啓用¶

1. 安裝 SkillHub CLI（若尚未安裝）¶

先檢查是否已有 CLI：

command -v skillhub && skillhub --version

未安裝時，可按 SkillHub 官方安裝文檔執行完整安裝或僅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

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/ 可能無法被加載。官方安裝說明示例：

skillhub install @user_87b8e34f/ai-song-generator --dir <skills 目錄>

常見路徑（以你實際使用的客戶端爲準）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

也可讓 Agent 根據 SkillHub 安裝文檔 安裝座標 @user_87b8e34f/ai-song-generator。

發佈包爲已打好的 Node CLI（版本 1.3.2），內含運行代碼，無需再執行 pnpm install 或 pnpm build。最低 Node 版本爲 >=18。

3. 初始化 API Key¶

進入 Skill 安裝目錄後，首次連接海綿音樂賬號：

node ./bin/aimv.js init

CLI 會輸出連接頁鏈接；用戶在網頁登錄（新用戶可自動註冊）後複製 API Key，由 Agent 執行：

node ./bin/aimv.js init --api-key <KEY>

非交互方式也可使用：

node ./bin/aimv.js config set-api-key --stdin

4. 各客戶端差異（僅寫官方已說明部分）¶

Codex：將發佈包內 SKILL.md 複製到 Codex skills 目錄後重啓；執行時用 node <安裝目錄>/bin/aimv.js。不要用 codex mcp add 註冊 aimv。

macOS / Linux 示例：

CODEX_SKILL_DIR="$HOME/.codex/skills/ai-song-generator"
mkdir -p "$CODEX_SKILL_DIR"
cp ./SKILL.md "$CODEX_SKILL_DIR/SKILL.md"

Claude / Claude Code：按當前客戶端支持，將 SKILL.md 放入本地 Skills 目錄，或將工具配置爲 command: node、args 指向 bin/aimv.js；若只接受 MCP，需額外 wrapper，因爲 aimv 本身不是 MCP server。

Cursor：將 Skill 安裝到 ~/.cursor/skills/（或項目約定目錄），確保 Agent 能讀取 SKILL.md 並執行 shell 中的 node .../bin/aimv.js。

OpenClaw 等支持本地工具註冊的 Agent：可按安裝說明註冊名爲 aimv 的工具，command 爲 node，args 爲 bin/aimv.js 的絕對路徑。

典型用法¶

Agent 若能執行 shell，應直接運行 CLI，而不是讓用戶手動複製命令（除非環境禁止執行命令）。

推薦生成命令¶

node <安裝目錄>/bin/aimv.js song create --brief "幫我寫一首輕快的中文流行歌，主題是夏天旅行" --wait

node <安裝目錄>/bin/aimv.js song create --brief "寫一首溫暖的中文抒情歌，主題是想念" --style mandopop --wait

安裝說明中的驗證步驟還包括：

node ./bin/aimv.js config show

對話側示例說法¶

• 幫我寫一首輕快的中文流行歌，主題是夏天旅行
• 寫一首溫暖的中文抒情歌，主題是想念
• 給一個生活方式品牌生成一首抓耳的主題歌

生成完成後，應向用戶呈現試聽、下載與項目鏈接；每個項目固定兩首候選歌，文檔要求兩首都呈現給用戶。

curl 兜底（沙箱僅放行 curl 時）¶

curl -sS -X POST "https://music.68zysm.cn/api/v3/ai-music/generations/from-brief" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: ai-song-generator" -H "X-AIMV-Skill-Slug: ai-song-generator" \
  -H "Content-Type: application/json" -d '{"brief":"輕快的夏日流行歌"}'

隨後按 project_id 輪詢項目狀態，再從 data.songs[] 取 audio_url 下載。HOME 不可用的沙箱可用環境變量 AIMV_CONFIG_DIR、AIMV_API_KEY 替代本地配置。

適用場景與注意¶

適合誰：需要在 Agent 對話裏完成 AI 寫歌、快速出原創小樣、並把作品留在海綿音樂賬號體系中繼續管理的創作者、運營與開發者。

使用前提：

• 需要海綿音樂 API Key（requires_api_key=true），積分與會員規則與海綿音樂一致。
• 依賴 Node >=18 與可執行本地命令的能力；aimv 是 CLI，不是 MCP server。
• 默認 API Base URL 爲 https://music.68zysm.cn/api/v3，一般無需改；特殊環境可用 config set-base-url。

常見錯誤碼（CLI 會帶 [error] / [hint]）：

• auth_required：把 connect_url 發給用戶完成登錄與 Key 配置後重試。
• insufficient_points（402）、quota_limited（429）：按提示把 pay_url 發給用戶，充值或開通會員後重試。
• wait_timeout：任務可能仍在後臺生成，稍後查詢狀態。
• not_found：優先用 aimv session tail 查最近項目。

結尾¶

「AI歌曲生成」把「描述靈感 → 出歌 → 拿鏈接與文件」收斂到 Agent 可調用的 Skill 與 aimv CLI，並與海綿音樂賬號、小程序和 lexuan.club 打通。若你要在 Cursor、Codex 或 Claude Code 裏接 AI 寫歌，可從 SkillHub 安裝 @user_87b8e34f/ai-song-generator，完成 init 後直接用 song create 驗證。

官方地址：https://api.skillhub.cn/user_87b8e34f/ai-song-generator
SkillHub 頁面：https://www.skillhub.cn/skills/user_87b8e34f/ai-song-generator