前言¶
做视频、播客或独立项目时，经常需要一段可商用的 BGM，或一首带歌词的完整歌曲。自己作曲门槛高，只在 Suno 网页里来回切界面，又很难和写脚本、写文案的 AI 工作流连在一起。若你希望在 Cursor、Claude Code 等环境里，用中文描述主题、贴歌词或指定风格，直接拿到可试听、可下载的音频，并把作品留在统一账号里继续管理，可以了解 SkillHub 上的社区 Skill「Suno AI音乐生成」（@user_87b8e34f/suno-ai-music，当前版本 1.3.2）。
这是什么¶
「Suno AI音乐生成」是 SkillHub 分类 design-media 下的社区 Skill，由发布者 user_87b8e34f 维护。它面向想用中文完成 Suno AI 音乐、AI 写歌、中文 Suno 或同类替代方案的创作者。
实际生成能力由 Suno 提供；Skill 的作用是把这类需求接到 AI 助手侧：你在对话里说明歌曲主题、歌词、风格、BGM 场景或参考音频，助手按 Skill 指引调用能力，产出可试听、可下载的音乐。生成结果会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 网页继续管理。
Skill 带有 requires_api_key=true 标签，使用前需按 Skill 说明配置相应 API 密钥（具体字段以安装后的 Skill 文档为准）。
核心功能¶
以下能力均来自 SkillHub 官方简介，安装后行为以 Skill 包内说明为准。
- 主题与歌词驱动成曲：用自然语言描述歌曲主题，或直接提供歌词，生成完整音乐作品。
- 风格与场景：可指定音乐风格；也可按 BGM 使用场景描述需求，便于配乐类产出。
- 参考音频：支持以参考音频为输入进行改编或延续（具体参数以 Skill 内指引为准）。
- 交付与同步：生成结果可试听、可下载；并同步到海绵音乐账号，便于在小程序与网页端统一管理。
当你在对话里提到 suno、Suno AI 音乐、中文 suno、suno 替代、suno 音乐生成等意图时，Agent 可加载本 Skill 处理上述需求。
安装与启用¶
安装流程遵循 SkillHub 通用文档 SkillHub 安装与优先源配置。下面先做环境检查，再把 Skill 装到当前 Agent 实际使用的 skills 目录（装错目录会导致助手识别不到，必要时需重启客户端）。
1、检查是否已安装 skillhub CLI
command -v skillhub && skillhub --version
若未安装，可按官方文档执行完整安装（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、安装本 Skill
官方页面给出的坐标为 @user_87b8e34f/suno-ai-music。安装时必须用 --dir 指向当前环境的 skills 目录，例如：
skillhub install @user_87b8e34f/suno-ai-music --dir ~/.cursor/skills/
其他常见路径（同样来自 SkillHub 安装文档，按你实际使用的客户端选择其一）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将官方安装说明发给 AI，让其按文档完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装
@user_87b8e34f/suno-ai-music。
3、API 密钥
Skill 标记为需要 API Key。安装后打开 Skill 包内的 SKILL.md 或配套说明，按发布者要求填写密钥与端点，再在新对话中验证能否正常生成。
典型用法¶
官方资料未给出固定 CLI 一键示例，典型路径是在已启用该 Skill 的 AI 助手中用中文描述需求。下面几类表述与官方能力描述一致，便于复现：
- AI 写歌：说明歌曲主题、情绪与风格，例如「写一首 90 秒、偏民谣的中文情歌，主题是小城夏天」。
- 歌词成曲：直接粘贴歌词，并补充人声/编曲风格，例如「用下面歌词生成一首流行摇滚，副歌要更饱满」。
- BGM：描述使用场景与节奏，例如「需要 2 分钟、无歌词的轻快 BGM，适合科技产品宣传片」。
- 参考音频：说明参考文件路径或上传参考音频，并写清希望保留或改变的元素（如节奏、情绪），由助手按 Skill 流程提交生成。
生成完成后，在对话中获取试听与下载链接，并到海绵音乐小程序或 lexuan.club 查看是否已同步到账号。
适用场景与注意¶
适合谁
- 习惯在 AI 编程/写作环境里一站式产出内容，又不想为每首歌单独打开 Suno 网页的创作者。
- 需要中文交互、并希望作品落在海绵音乐账号统一管理的用户。
需要注意
- 音乐能力依赖 Suno 与相关服务可用性；网络、配额与 API Key 失效会导致生成失败，需按 Skill 文档排查。
- 社区来源（
community）Skill，升级与兼容性以 SkillHub 上版本为准，当前页面标注为 v1.3.2。 - 参考音频、版权与商用范围请遵守 Suno、海绵音乐及你所在平台的服务条款，本文不替代法律意见。
结尾¶
「Suno AI音乐生成」把 Suno 的写歌、配乐与参考音频类需求接到 AI 助手工作流里，并和海绵音乐账号打通，适合中文创作者在对话中完成从描述到成曲的闭环。安装与详情见 SkillHub 官方页面：
