前言¶
品牌片和活動物料裏，廣告歌、主題曲和聲音 logo 往往要反覆對齊 brief，還要在多個平臺留檔試聽。單靠通用對話模型很難直接給出可下載的成曲，營銷同事又常常要在小程序、網頁和本地文件之間來回倒騰。下面介紹 SkillHub 上的「廣告歌生成AI」：把它裝進 Cursor 等支持 Skills 的 Agent 後，用自然語言描述品牌與場景，由助手通過本地 aimv CLI 調用海綿音樂能力，生成可試聽、可下載的方案，並同步到賬號側繼續管理。
這是什麼¶
「廣告歌生成AI」是社區 Skill，座標 @user_87b8e34f/commercial-jingle-maker，當前版本 1.3.2，分類爲 design-media，由發佈者 user_87b8e34f 維護。Skill 標籤包含 requires_api_key=true，首次使用需完成海綿音樂賬號連接。
一句話定位：爲品牌、廣告、活動和商業內容生成廣告歌、品牌歌、宣傳歌、活動主題曲與聲音 logo 方向；輸入品牌定位、受衆、賣點和傳播場景後，助手生成可試聽、可下載的音樂方案，作品同步到海綿音樂賬號，可在「海綿音樂AI寫歌」小程序和 lexuan.club 網頁繼續管理。底層由海綿音樂提供，賬號、積分、會員與作品庫與小程序 / 網頁互通。
官方頁面：
- SkillHub：https://www.skillhub.cn/skills/user_87b8e34f/commercial-jingle-maker
- API 入口：https://api.skillhub.cn/user_87b8e34f/commercial-jingle-maker
核心功能¶
根據 Skill 說明與 SKILL.md，已覈實能力包括：
- 廣告與品牌向成曲：根據品牌 brief 生成廣告歌、品牌歌 demo、活動主題曲候選。
- 商業配樂與聲音方向：支持宣傳歌、商業配樂，以及聲音 logo 等短記憶點探索。
- Agent 側閉環：支持初始化登錄、創建生成任務、查詢狀態、下載音頻；推薦通過 Node 入口
bin/aimv.js調用本地 CLI，而非把該腳本註冊爲 MCP stdio 服務。 - 賬號同步：生成結果進入海綿音樂作品庫，便於在小程序與 lexuan.club 後續編輯與管理。
- 受限環境兜底：沙箱僅放行
curl時，可設AIMV_FORCE_CURL=1重試 CLI，或按文檔用 REST API 完成創建、輪詢與下載。
觸發語義覆蓋：廣告歌、廣告歌生成、品牌歌、商業配樂、品牌音樂、宣傳歌、活動主題曲、聲音 logo，以及英文表述如 commercial jingle、brand song 等。
安裝與啓用¶
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
僅 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、安裝本 Skill 到當前 Agent 的 skills 目錄¶
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄，否則默認落在 ./skills/ 可能無法被加載。
skillhub install @user_87b8e34f/commercial-jingle-maker --dir <你的 skills 目錄>
常用路徑示例（以 SkillHub 文檔爲準）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
也可讓 Agent 根據 https://skillhub.cn/install/skillhub.md 安裝 @user_87b8e34f/commercial-jingle-maker。
3、完成 API Key 連接¶
首次生成前需連接海綿音樂賬號。Agent 應運行（<安裝目錄> 爲 Skill 安裝後的實際路徑）：
node <安裝目錄>/bin/aimv.js init
CLI 會輸出連接頁：https://lexuan.club/skills/connect?slug=commercial-jingle-maker&from=skill。用戶網頁登錄（新用戶可自動註冊）後複製 API Key，再由 Agent 執行：
node <安裝目錄>/bin/aimv.js init --api-key <KEY>
Key 長期有效，一般只需配置一次。環境變量 AIMV_API_KEY 可在無 HOME 的沙箱中替代本地配置；AIMV_CONFIG_DIR 可重定向配置目錄。
典型用法¶
對話側 brief¶
在 Agent 對話中直接描述品牌與傳播需求即可，例如 Skill 文檔中的典型說法：
- 給一個運動飲料品牌寫一首年輕、有記憶點的廣告歌
- 給新咖啡品牌做一首明亮、好記的廣告歌
- 爲金融科技 App 生成一個簡短聲音 logo 方向
助手應優先在本 Skill 下調用 shell 或已註冊的 aimv 工具，而不是讓用戶自行拼網頁流程。
推薦 CLI 命令¶
將 <安裝目錄> 替換爲安裝路徑（如 ~/.cursor/skills/@user_87b8e34f/commercial-jingle-maker）：
node <安裝目錄>/bin/aimv.js song create --brief "給新咖啡品牌做一首明亮、好記的廣告歌" --wait
node <安裝目錄>/bin/aimv.js song create --brief "年輕、有記憶點的運動飲料廣告歌" --style pop energetic --wait
--wait 會阻塞直到任務結束或超時；若出現 code=wait_timeout，任務可能仍在後臺生成，需按 CLI 的 [hint] 稍後查詢。
錯誤與額度¶
CLI 以 [error] / [hint] 結構化輸出，常見情況：
auth_required：把connect_url發給用戶完成登錄與 Key 配置後重試。insufficient_points（402）或quota_limited（429）：把pay_url發給用戶在網頁充值或開通會員後重試。not_found：優先用aimv session tail查看最近項目與歌曲。
每個生成項目固定返回兩首候選，呈現時應一併給出試聽與下載信息。
適用場景與注意¶
適合誰：品牌方、營銷團隊、商業內容創作者，需要在方案階段快速產出廣告歌、品牌歌或活動曲方向，並希望在海綿音樂側長期留存作品。
使用注意：
- 依賴 Node 環境與網絡；沙箱限網時需以允許聯網的方式執行 CLI 或 curl 兜底。
- 生成消耗海綿音樂積分 / 會員額度，遇 402、429 需按文檔引導用戶處理，而非重複盲試。
- SkillHub 社區來源（
community），安裝前可在 SkillHub 頁面查看版本與說明；截至資料記錄，評分爲 100000，下載約 6892 次（以 SkillHub 頁面實時數據爲準）。 - 與同發佈者的「AI寫歌」等 Skill 共用
aimv工具名與海綿音樂賬號體系，但 slug 與X-App-Id爲commercial-jingle-maker，勿混用連接頁 slug。
結尾¶
「廣告歌生成AI」把品牌 brief 與 Agent 編排結合起來：在對話裏說清楚受衆與賣點，由助手通過 aimv CLI 拉取可試聽、可下載的商業音樂候選，並同步到海綿音樂賬號。需要安裝或查閱更新時，以 SkillHub 官方地址爲準：https://www.skillhub.cn/skills/user_87b8e34f/commercial-jingle-maker
