前言¶
做 Demo、短视频配乐或原型验证时，经常需要一段能直接用的歌，而不是纯伴奏。自己搭 Suno 相关流程要查文档、管密钥、对齐调用方式，和日常在 Cursor 或 Claude Code 里写代码的节奏不一致。SkillHub 上的社区 Skill suno music（坐标 @user_f95f21b8/dlazy-suno-music，当前版本 1.0.9）把能力封装成 Agent 可读的 SKILL.md 格式：你用文字描述歌词或风格，由 Agent 按 Skill 指引调用 Suno AI，产出带人声和伴奏的完整歌曲。
这是什么¶
suno music 的定位可以用官方简介概括：
Automatically create complete songs with vocals and accompaniment based on lyrics or style descriptions using Suno AI.
来源为 SkillHub community 条目，发布者为 user_f95f21b8，分类为 design-media。页面标注 requires_api_key=true，即使用前需要自行准备 Suno 相关 API 密钥；密钥的具体环境变量名或配置字段以安装后 Skill 包内的 SKILL.md 为准，本文不臆造配置项。
SkillHub 展示页：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-suno-music
安装坐标 API：https://api.skillhub.cn/user_f95f21b8/dlazy-suno-music
核心功能¶
结合官方简介与 SkillHub 标签，可核实的能力如下：
- 输入方式：支持基于歌词，或基于风格描述发起创作，不要求你先具备编曲工程文件。
- 输出形态：目标是 complete songs——同时包含 vocals（人声） 与 accompaniment（伴奏），而不是仅生成器乐或单轨素材。
- 后端能力：生成逻辑依赖 Suno AI；Skill 本身负责在 Agent 会话中规范何时、如何触发这类能力。
- 前置条件：SkillHub 标签标明需要 API Key；未配置密钥时，Agent 无法完成实际生成，需你先完成密钥配置。
SkillHub 当前统计（以页面抓取为准）：评分 100000，下载 1062 次，安装记录 1 次。这些数字只反映商店侧曝光，不代表生成质量或 SLA。
安装与启用¶
下面介绍在常见 Agent 环境中安装本 Skill 的步骤。安装规范以 SkillHub 官方文档为准。
1、确认 skillhub CLI¶
先检查本机是否已有 CLI：
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
文档地址：https://skillhub.cn/install/skillhub.md
2、安装 suno music¶
SkillHub 技能页给出的安装坐标为 @user_f95f21b8/dlazy-suno-music。安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认会装到 ./skills/，Agent 可能识别不到。
skillhub install @user_f95f21b8/dlazy-suno-music --dir <你的 skills 目录>
各客户端常用路径（摘自 SkillHub 安装文档，按你本机环境选用）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
也可将下面提示交给 Agent，让其按安装文档拉取同一坐标（与技能页文案一致）：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_f95f21b8/dlazy-suno-music`。
3、API Key 与启用¶
Skill 标注 requires_api_key=true。安装完成后，打开技能目录中的 SKILL.md，按其中说明配置 Suno API 密钥并重启或重新加载 Agent（若你的客户端需要）。在密钥与 Skill 均就绪后，才能在对话里触发音乐生成。
典型用法¶
官方公开资料未附带逐条复制的 CLI 示例；用法本质是：在已启用该 Skill 的 Agent 对话中，用自然语言提供歌词或风格描述，由 Agent 按 SKILL.md 调用 Suno AI。
可复现的交互模式如下（表述需与你本地 Skill 文档一致，此处仅说明输入类型）：
- 歌词驱动：提供完整或分段歌词，并补充流派、情绪、速度等约束（若 Skill 文档支持）。
- 风格驱动：不提供完整歌词，用文字描述曲风、乐器、人声类型、场景（如「80 年代合成器流行，女声，适合片头」）。
- 结果：由 Suno 返回完整歌曲产物；具体文件格式、下载方式以 Skill 执行时的输出为准。
若安装后 Agent 未按预期调用 Suno，先核对 skills 目录、--dir 是否指向正确路径，以及 API Key 是否已按 SKILL.md 配置。
适用场景与注意¶
适合谁
- 需要在开发或内容流程里快速试歌、试风格，又不想单独维护 Suno 调用脚本的开发者或创作者。
- 已使用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，希望把「写词 / 写风格 → 成歌」收进同一对话链路的人。
限制与注意
- 社区来源：
source: community，维护节奏与官方 Skill 可能不同，升级前留意 SkillHub 上的版本号（当前 1.0.9）。 - 密钥与费用：依赖 Suno AI 与有效 API Key，用量与计费以 Suno 及你账号策略为准。
- 合规：生成音乐的版权与使用范围须符合 Suno 服务条款及你所在场景（商用、平台分发等）的要求。
- 资料边界：本文未读取技能包内
SKILL.md全文；高级参数、错误码、速率限制等以安装后的 Skill 文档为准。
结尾¶
suno music 把「歌词或风格描述 → Suno AI → 带人声与伴奏的完整歌曲」收敛成 Agent Skill，适合在 SkillHub 生态里一键安装到 Cursor 等环境的 skills 目录。使用前准备好 API Key，并按 https://skillhub.cn/install/skillhub.md 安装 @user_f95f21b8/dlazy-suno-music。技能主页：https://www.skillhub.cn/skills/user_f95f21b8/dlazy-suno-music 。
