前言¶
做内容、做游戏或做短视频时，经常需要一段能直接用的 BGM 或完整歌曲。自己找素材要碰版权，临时外包又慢。Suno 一类 AI 音乐能力已经成熟，但多数入口是英文界面或独立网页，和日常用的 Cursor、Claude Code 等助手不在一条对话里。
下面介绍 SkillHub 上的 Suno AI音乐（坐标 @user_87b8e34f/suno-ai-pro）。装好后，你可以在中文对话里描述主题、歌词、风格或参考音频，由助手按 Skill 规范调用能力，生成可试听、可下载的作品，并同步到海绵音乐账号继续管理。
这是什么¶
Suno AI音乐 是 SkillHub 社区来源（community）的 Agent Skill，当前版本 1.3.2，分类为 design-media，发布者为 user_87b8e34f。
一句话定位：面向中文创作者的 Suno 音乐生成 Skill。实际生成能力由 Suno 提供；Skill 负责在 AI 助手侧组织输入（写歌、歌词成曲、BGM、参考音频改编等场景）并衔接后续作品管理。官方页面标注 requires_api_key=true，使用前需要配置相应 API 密钥。
作品会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 网页继续管理。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独列出的细节不展开：
- AI 写歌：用歌曲主题、风格等自然语言描述，生成完整音乐作品。
- 歌词成曲：提供歌词（可含风格说明），生成对应曲目。
- BGM：按场景描述生成背景音乐类作品。
- 参考音频改编：以参考音频为输入方向之一进行生成或改编（具体参数以 Skill 内说明与助手执行为准）。
- 试听与下载：生成结果可试听、可下载。
- 账号同步：作品同步至海绵音乐，便于在小程序与网页端统一管理。
当你在对话里提到 Suno、Suno AI、Suno AI Pro、suno 音乐等需求时，助手应匹配并启用本 Skill（以各客户端的 Skill 发现规则为准）。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（CLI + 默认 Skill）：
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、安装 Suno AI音乐¶
官方页面要求：依据 SkillHub 安装说明，安装坐标 @user_87b8e34f/suno-ai-pro。
安装技能时必须用 --dir 指向当前 Agent 正在使用的 skills 目录，否则默认会装到 ./skills/，客户端可能识别不到。常用路径示例（来自安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
在对应目录下执行（将 <skills 目录> 换成你的实际路径）：
skillhub install @user_87b8e34f/suno-ai-pro --dir <skills 目录>
也可让 AI 助手读取 https://skillhub.cn/install/skillhub.md 后代为安装同一坐标。
3、API 密钥与重启¶
Skill 标签为 requires_api_key=true。按 Skill 包内 SKILL.md 与发布方说明配置 API Key；未配置时生成类操作通常会失败。安装到正确目录后，按你所用客户端要求重启或刷新 Skill 列表。
本 Skill 基于通用 SKILL.md 格式；具体执行链路（例如通过 Node 入口调用本地工具）以安装包内文档为准，本文不臆造命令行参数。
典型用法¶
经过上面的步骤启用后，在已配置 API Key 的助手对话中，用中文直接说明需求即可。下列示例与官方简介一致，便于复现意图（实际文件名、时长以生成结果为准）：
写一首歌
用 Suno 写一首中文流行歌，主题是「城市夜跑」，情绪轻快，要有副歌。
歌词成曲
把下面歌词做成一首民谣，男声为主：[粘贴歌词]
BGM
生成一段 60 秒左右的轻松 BGM，适合科技产品介绍视频，不要人声。
参考音频
参考我提供的这段音频的节奏和氛围，做一首同风格但旋律不同的曲子。（若客户端支持上传附件，附上参考音频。）
生成完成后，在对话中试听或下载；同时可在海绵音乐小程序或 lexuan.club 查看同步作品。
适用场景与注意¶
适合谁
- 需要用中文在 AI 助手内完成 Suno / suno 音乐 / AI 写歌，而不想单独切换英文站点的创作者。
- 需要 BGM、成曲与后续在海绵音乐侧统一管理的个人或小团队。
需要注意
- 依赖 Suno 能力与有效 API Key；网络与配额限制以服务商与 Skill 配置为准。
- 社区来源 Skill，升级前可用
skillhub查看版本（当前公开版本为 1.3.2）。 - 参考音频、版权与商用合规需自行把握；生成物是否可商用以 Suno 及你方授权条款为准。
- SkillHub 页面统计（截至抓取）：评分 100000，下载 9936；安装数在页面上显示为 0，可能与统计口径有关，不影响本地
skillhub install使用。
结尾¶
Suno AI音乐把 Suno 的写歌、成曲、BGM 与参考音频类需求收敛到中文 Agent 对话里，并接上海绵音乐的试听、下载与多端管理。若你正在 Cursor 等环境做内容生产，可按本文安装 @user_87b8e34f/suno-ai-pro 并配置 API Key 后直接使用。
