前言¶
做短视频、播客或品牌内容时，经常需要一段能直接用的原创音乐。自己找素材库容易撞风格，外包制作周期长；把需求丢给通用大模型，又往往只得到文字方案，听不到成品。若希望在与写稿、剪片同一套对话环境里，用中文把创意、歌词或场景说清楚，并拿到试听链接和可下载音频，就需要把「音乐生成」做成 Agent 可调用的 Skill，而不是每次换到独立网页工具。
下面介绍 SkillHub 上的 AI音乐生成器（@user_87b8e34f/ai-music-generator，版本 1.3.2），以及安装与典型用法。
这是什么¶
AI音乐生成器是 SkillHub 社区来源（community）的技能，发布者为 user_87b8e34f，分类为 design-media。它面向需要 AI music generator、音乐生成器、AI 生成音乐与 BGM 生成器的中文创作者：在 AI 助手中输入创作想法、完整歌词、视频场景或品牌需求，可生成歌曲、背景音乐、试听链接与可下载音频；作品会同步到海绵音乐账号，并可在「海绵音乐 AI 写歌」小程序与 lexuan.club 网页继续管理。
技能坐标：@user_87b8e34f/ai-music-generator。官方入口：https://api.skillhub.cn/user_87b8e34f/ai-music-generator；SkillHub 展示页：https://www.skillhub.cn/skills/user_87b8e34f/ai-music-generator。
按 Skill 说明，Agent 应通过 Node 入口调用本机 aimv CLI，而不是把用户再引导到一套互不相关的网页流程（具体命令以安装目录内的 SKILL.md 为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装并启用后由 Agent 按技能文档调用：
- 多形态输入：一句创作想法、完整歌词、视频场景描述、品牌相关需求均可作为生成依据。
- 歌曲与 BGM：可生成带人声或偏背景使用的音乐方案。
- 可试听、可下载：产出包含试听链接与音频下载，便于直接嵌入工作流。
- 账号同步：作品同步海绵音乐账号，小程序与 lexuan.club 可继续管理。
- API Key：技能标签为
requires_api_key=true，使用前需完成密钥或账号连接配置。
SkillHub 页面当前统计（以展示页与抓取数据为准）：评分 100000，下载 7337 次。
安装与启用¶
方式一：让 AI 按官方指引安装¶
在 Cursor、Claude Code、Codex CLI 等支持 Skills 的客户端中，可将下面提示发给 Agent，由其阅读 SkillHub 安装文档 并完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_87b8e34f/ai-music-generator`。
方式二：使用 skillhub CLI¶
若本机已有 skillhub，安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
先确认 CLI：
command -v skillhub && skillhub --version
未安装时可执行官方脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装本技能（将 <skills 目录> 换成当前环境路径）：
skillhub install @user_87b8e34f/ai-music-generator --dir <skills 目录>
常用目录示例（来自 SkillHub 安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装完成后重启或刷新 Agent，使技能被加载。首次生成前按 SKILL.md 完成 API Key 配置（技能标记 requires_api_key=true）。
典型用法¶
启用技能后，当用户提到 AI 音乐生成器、ai 音乐生成器、AI music generator、music generator、音乐生成器、AI 生成音乐、AI 音乐生成、生成音乐工具等意图时，Agent 应优先调用本 Skill，并通过本地 aimv CLI（Node 入口）执行生成与下载。
下面几类说法与官方简介一致，可直接在对话中复现：
- 创意成曲：「用一句想法生成一首中文流行 demo，主题夏天旅行。」
- 歌词成曲：提供完整歌词，并补充风格或情绪说明。
- 场景 BGM：「为 30 秒产品开箱短视频写一段轻快、无抢戏的背景音乐。」
- 品牌向需求：说明品牌调性、受众与使用场景（如活动片头、门店循环 BGM）。
经过上面的步骤，Agent 应返回试听链接与下载方式；同一账号下的作品可在海绵音乐小程序与 lexuan.club 查看与管理。
适用场景与注意¶
适合谁
- 需要用中文描述即可完成 AI 写歌、作曲、BGM 制作的创作者与运营。
- 希望在 IDE / 对话 Agent 内闭环「描述 → 试听 → 下载」，减少在多个产品间复制 prompt 的团队。
使用注意
- 必须配置 API Key（
requires_api_key=true）；积分、会员与作品库与海绵音乐体系互通，具体额度以连接后的账号为准。 - 调用方式为本地 Node CLI（aimv），需 Agent 具备执行 shell 的权限；沙箱或禁网环境可能影响 CLI，需按安装包内
SKILL.md的受限环境说明处理。 - 版本以 SkillHub 为准，当前为 1.3.2；升级可用
skillhub对同一坐标重新安装到对应--dir。
结尾¶
AI音乐生成器把中文创意、歌词、风格与场景描述接到可试听、可下载的成曲流程，并与海绵音乐账号同步，适合作为 Agent 侧的 design-media 类音乐技能。安装与坐标说明见 SkillHub：https://www.skillhub.cn/skills/user_87b8e34f/ai-music-generator；API 入口：https://api.skillhub.cn/user_87b8e34f/ai-music-generator。
