前言¶

做短視頻配樂、活動 demo 或歌詞草稿時，常見做法是切到網頁工具裏填表單、等生成、再拷鏈接回來。流程長，作品也難和賬號裏的歷史項目對齊。若你已經在 Cursor、Claude Code 等環境裏用 Agent 寫文案、改代碼，更順手的方式是把「寫一首歌」當成一條可執行的 Skill：用自然語言交代主題、風格或歌詞，由 Agent 調本地 CLI 完成生成，並直接帶回試聽與下載。

下面介紹 SkillHub 社區 Skill AI寫歌（@user_87b8e34f/ai-songwriting，當前版本 1.3.2）的定位、能力與安裝用法。

這是什麼¶

AI寫歌是面向中文音樂創作者的 Agent Skill，由社區發佈者 user_87b8e34f 維護，分類爲 design-media，底層能力由 海綿音樂 提供。賬號、積分、會員與作品庫與「海綿音樂AI寫歌」小程序及 lexuan.club 網頁互通。

一句話：在 AI 對話裏描述主題、風格、情緒、歌詞或使用場景，即可生成完整歌曲，並獲得試聽鏈接與音頻下載；作品會同步到海綿音樂賬號，便於在小程序或網頁繼續管理。

與「只在聊天裏編一段歌詞」不同，本 Skill 要求 Agent 通過安裝目錄下的 Node 入口 bin/aimv.js 調用本地 aimv CLI（通用本地 CLI，不是 MCP server），對接海綿音樂生成與項目狀態。

核心功能¶

依據 Skill 說明與 SkillHub 頁面，已覈實能力包括：

1. 中文寫歌：根據主題、風格、情緒或一句創意 brief 生成完整歌曲（原創路徑）。
2. 歌詞成曲、純音樂等：CLI/API 側支持 from-lyrics、instrumental 等模式（與 from-brief 並列，見 Skill 內 curl 示例）。
3. 交付物：生成結果包含試聽鏈接與可下載音頻；每個項目固定 兩首候選歌，呈現時應都交給用戶。
4. 賬號同步：作品進入海綿音樂賬號，可在「海綿音樂AI寫歌」小程序與 lexuan.club 管理。
5. Agent 側執行：有 shell 權限時，由 Agent 直接跑 aimv 完成初始化、生成、查詢與下載，而不是讓用戶手抄一長串命令。

SkillHub 標籤 requires_api_key=true：首次使用前需完成海綿音樂連接並配置 API Key（見下文）。

安裝與啓用¶

1. 安裝 SkillHub CLI¶

若尚未安裝，可按 SkillHub 官方安裝說明執行：

command -v skillhub && skillhub --version

未安裝時（完整安裝或僅 CLI）：

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. 安裝 AI寫歌 Skill¶

安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被識別。官方頁面要求參照 SkillHub 安裝文檔 安裝座標 @user_87b8e34f/ai-songwriting。

示例（將 <skills 目錄> 換成你環境對應路徑）：

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

常用路徑（來自 SkillHub 安裝文檔）：

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

安裝完成後，Skill 包內入口爲 bin/aimv.js；下文用 <安裝目錄> 表示該 Skill 在 skills 目錄中的實際路徑（例如 .../@user_87b8e34f/ai-songwriting）。

3. 連接海綿音樂（API Key）¶

第一次生成前若未登錄，Agent 應執行：

node <安裝目錄>/bin/aimv.js init

CLI 會給出連接頁鏈接：

https://lexuan.club/skills/connect?slug=ai-songwriting&from=skill

把鏈接發給用戶；用戶在網頁登錄（新用戶可自動註冊）後複製 API Key，再由 Agent 執行：

node <安裝目錄>/bin/aimv.js init --api-key <KEY>

Key 長期有效，一般只需配置一次。沙箱無 HOME 時，可用環境變量 AIMV_API_KEY 或 AIMV_CONFIG_DIR 指向可寫配置目錄（見 Skill 說明）。

典型用法¶

在對話裏觸發¶

當用戶提到 AI寫歌、AI作詞作曲、自動寫歌、中文 AI 寫歌等意圖時，Agent 應優先啓用本 Skill。用戶說法示例（來自官方 Skill 文檔）：

• 「AI寫歌，幫我寫一首輕快的中文流行歌，主題是夏天旅行」
• 「用 AI 寫一首適合畢業季的校園民謠」
• 「幫我自動寫歌，風格年輕、有記憶點，適合品牌發佈會」

推薦 CLI 命令¶

有 shell 時，由 Agent 直接運行（--wait 會阻塞到任務完成或超時）：

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

帶風格標籤示例：

node <安裝目錄>/bin/aimv.js song create --brief "用 AI 寫一首適合畢業季的校園民謠" --style folk mandopop --wait

若環境已把 aimv 註冊爲工具，也可調用 aimv song create / aimv bgm create 等等價邏輯；未註冊時一律使用 node <安裝目錄>/bin/aimv.js ...。

受限網絡環境¶

若沙箱只允許 curl、aimv 報網絡錯誤而 curl 正常，可先設置 AIMV_FORCE_CURL=1 後重試原命令。CLI 完全不可用時，Skill 文檔提供與 CLI 一致的 HTTP API（https://music.68zysm.cn/api/v3/ai-music/...），請求頭需包含 X-API-Key、X-Platform: skill、X-App-Id: ai-songwriting、X-AIMV-Skill-Slug: ai-songwriting。API Key 仍來自上述連接頁。

適用場景與注意¶

適合誰

• 需要快速出歌 demo 的短視頻、品牌或活動創作者；
• 想用中文 brief 探索歌詞與編曲方向、而不是從零搭 DAW 工程的人；
• 已在 AI 助手工作流中、希望生成結果自動進海綿音樂作品庫的用戶。

使用注意

1. 積分與會員：CLI 在積分不足（業務碼 402）或額度受限（429）時會輸出帶 pay_url= 的 [error] 標籤，需引導用戶在網頁充值或開通會員後重試。
2. 鑑權：auth_required 時按 connect_url 完成連接，勿跳過 init --api-key。
3. 等待超時：wait_timeout 表示後臺仍在生成，應按 [hint] 稍後查詢，不等於失敗。
4. 不要誤註冊 MCP：bin/aimv.js 是 Node CLI，不要當作 MCP stdio 服務註冊。

SkillHub 社區頁顯示本 Skill 評分 100000、下載 8842 次（統計隨 SkillHub 更新變化）。

結尾¶

AI寫歌把中文寫歌需求收斂成 Agent 可執行的 Skill：自然語言描述需求，本地 aimv CLI 對接海綿音樂，回傳試聽與下載，並在小程序與 lexuan.club 延續管理。

• SkillHub 頁面：https://www.skillhub.cn/skills/user_87b8e34f/ai-songwriting
• 安裝座標：@user_87b8e34f/ai-songwriting
• 官方地址：https://api.skillhub.cn/user_87b8e34f/ai-songwriting