前言¶
做短视频、播客或产品 Demo 时，经常需要一段贴合情绪的配乐或完整歌曲。自己作曲门槛高，去素材站挑又难对上文案和节奏。若希望直接在 Cursor、Claude Code 等带 Skills 的 AI 客户端里，用自然语言描述需求并拿到可试听、可下载的音频，可以把 SkillHub 上的 AI音乐（@user_87b8e34f/ai-music）装进当前 Agent 的 skills 目录，在对话中完成创作与导出。
这是什么¶
AI音乐 是 SkillHub 社区来源（community）的 design-media 类 Skill，当前版本 1.3.2，由发布者 user_87b8e34f 维护。它面向需要 AI 音乐生成、AI 音乐创作、AI 作曲、AI 写歌 等能力的中文创作者：你在助手里说明主题、风格、情绪、歌词或使用场景，即可生成歌曲或 BGM；生成结果可试听、可下载，并会同步到海绵音乐账号，便于在「海绵音乐 AI 写歌」小程序与 lexuan.club 网页继续管理。
Skill 标签标明 requires_api_key=true，使用前需按 Skill 包内说明配置 API 密钥，具体字段名以安装后的 SKILL.md 为准。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开的能力不写入本文。
- 文本驱动创作：用主题、风格、情绪、歌词或使用场景描述需求，由助手调用 Skill 完成生成。
- 歌曲与 BGM：输出可试听、可下载的完整歌曲或背景音乐。
- 账号同步：作品同步到海绵音乐账号，可在小程序与 lexuan.club 侧继续管理。
当你在对话里提到 AI 音乐、ai 音乐、AI 音乐创作、AI 音乐生成、AI 作曲、AI 写歌、AI 歌曲或生成音乐等意图时，Agent 应匹配并启用该 Skill（以各客户端 Skills 机制为准）。
安装与启用¶
官方页面要求：依据 SkillHub 安装文档，安装坐标 @user_87b8e34f/ai-music。下面介绍通用 CLI 流程；不同客户端的差异主要在 skills 目录路径。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可按官方脚本安装（完整包含 CLI 与默认 Skill；仅需 CLI 时加 --cli-only）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
2、安装 AI音乐 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前环境会被识别的 skills 目录；装到错误位置（例如默认的 ./skills/）可能导致 Agent 读不到，需重启后仍无效。
skillhub install user_87b8e34f/ai-music --dir <你的 skills 目录>
常用路径示例（以 官方安装文档 为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
Cursor 用户可写成：
skillhub install user_87b8e34f/ai-music --dir ~/.cursor/skills/
安装完成后，按 Skill 包内 SKILL.md 配置 API Key，并重启或刷新 Agent 使 Skills 生效。
典型用法¶
官方未提供固定命令行示例；典型流程是在已启用 Skill 的对话中直接描述需求。可参考下列表述方式（需替换为你的实际主题与约束）：
- 说明体裁与用途，例如：「生成一段 30 秒左右的轻快 BGM，用于产品功能介绍短视频。」
- 补充风格与情绪，例如：「独立民谣、略带怀旧，人声为主，中文歌词。」
- 若已有歌词，可粘贴全文并说明希望成曲或仅伴奏。
- 生成完成后在对话中试听链接或下载路径，并到海绵音乐账号或 lexuan.club 核对同步结果。
具体参数、轮次与输出格式以安装包内 SKILL.md 及助手执行日志为准。
适用场景与注意¶
适合谁：需要在中文工作流里快速试曲、写歌或配 BGM，且希望作品落在海绵音乐生态里统一管理的创作者与开发者。
使用注意：
- 必须配置 API Key（
requires_api_key=true）；未配置时 Skill 无法正常调用后端。 - 安装目录务必对应当前 AI 客户端，避免装到未被加载的路径。
- 评分、下载量等商店数据会变动；查阅时以 SkillHub 页面实时展示为准（例如 SkillHub 详情页）。
结尾¶
AI音乐 把「描述需求 → 生成可下载音频 → 海绵音乐侧管理」串进 AI 助手对话，适合把配乐和写歌从单独开网页、切工具的流程里收拢回来。安装与坐标说明见官方地址：https://api.skillhub.cn/user_87b8e34f/ai-music，页面展示与安装指引亦可访问 https://www.skillhub.cn/skills/user_87b8e34f/ai-music。
