前言¶
品牌片和活动物料里，广告歌、主题曲和声音 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
