前言¶
做短视频 BGM、活动主题曲或 Demo 时，常见路径是：在 Suno 网页里反复试 prompt，再把音频拷回本地。若你已经在 Cursor、Claude Code 等环境里用对话推进创作，更希望用同一套交互把「写词、定风格、出歌、试听」串起来，而不是在多个产品之间切换。
下面介绍 SkillHub 上的 Suno AI写歌（坐标 @org-0bqts5ar/suno-ai-songwriting）。它把 Suno 的音乐生成能力接到 AI 助手侧：你在对话里提供主题、歌词、标题、风格或参考音频，由助手按 Skill 指引调用能力，产出可试听、可下载的完整歌曲及候选版本。音乐生成本身由 Suno 提供，Skill 负责在助手里的安装与使用流程。
这是什么¶
Suno AI写歌 是 SkillHub 分类 design-media 下的企业来源 Skill，当前版本 1.3.3，发布者为乐萱同行科技（深圳）有限公司。
一句话定位：面向常搜「suno ai写歌」「suno写歌」「Suno AI song」「suno歌曲生成」「中文 Suno」的创作者，在 AI 助手内完成 Suno 侧的歌曲生成与结果获取。SkillHub 页面标注标签 requires_api_key=true，使用前需准备相应 API 密钥（具体变量名与申请方式以安装后 Skill 包内 SKILL.md 为准）。
官方入口：
- API 文档页：https://api.skillhub.cn/org-0bqts5ar/suno-ai-songwriting
- SkillHub 展示页：https://www.skillhub.cn/skills/org-0bqts5ar/suno-ai-songwriting
核心功能¶
以下能力均来自 SkillHub 简介与页面说明，未单独列出的细节不展开。
- 多形态输入：支持歌曲主题、完整或片段歌词、曲名、风格方向，以及参考音频，便于从「一句话想法」或「已有草稿」起步。
- 完整歌曲输出：生成可试听的完整曲目，而非仅 MIDI 或分轨占位。
- 候选版本：可得到多个候选版本，便于在助手对话里对比再选定。
- 下载：生成结果支持下载到本地，方便接入剪辑、发布流程。
- 能力归属：实际音乐生成由 Suno 提供；Skill 解决的是「在 AI 助手里怎么描述需求、怎么拿结果」。
安装与启用¶
SkillHub 推荐两种方式：让 AI 按安装文档操作，或本机用 skillhub CLI 安装到当前 Agent 的 skills 目录。
方式一：提示词安装¶
将下面意图发给已支持 Skill 的 AI（安装说明原文见 SkillHub 技能页）：
请根据 https://skillhub.cn/install/skillhub.md，安装 @org-0bqts5ar/suno-ai-songwriting。
Agent 会按文档检查 CLI、选择 skills 目录并执行安装。
方式二：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
安装本 Skill 时，必须用 --dir 指向当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别：
skillhub install @org-0bqts5ar/suno-ai-songwriting --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，按你实际环境选用）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下 .windsurf/skills/ |
装到对应目录后，按你所用客户端要求刷新或重启 Agent，使 Skill 被加载。API 密钥配置请遵循 Skill 包内说明（SkillHub 已标记需要 API Key）。
典型用法¶
官方资料未提供固定对话脚本，但输入输出边界明确。可在助手启用该 Skill 后，用自然语言组合下列要素，让 Agent 按 SKILL.md 调用 Suno：
- 只给方向：说明主题与风格（例如节日氛围、电子流行、慢板抒情），并可选曲名；由助手补全歌词与编曲方向后生成。
- 自带歌词：粘贴歌词，补充 BPM、人声性别、语言与参考艺人风格（表述方式以 Suno 支持为准），生成对应编曲版本。
- 参考音频：提供参考曲或哼唱片段的路径或链接（若 Skill 支持），说明希望保留的节奏或情绪。
- 多版本对比：明确要求生成多个候选版本，试听后在对话中指定保留某一版并下载。
经过上面的步骤，你应能在对话里拿到试听链接或本地文件路径；具体字段名、轮询方式以安装后的 Skill 文档为准。
适用场景与注意¶
适合谁
- 内容创作者、独立开发者、小团队，需要在助手工作流里快速出歌、改歌。
- 已使用或计划使用 Suno，希望减少在网页与本地工具之间来回切换的人。
使用注意
- API Key：SkillHub 标注
requires_api_key=true，未配置密钥时无法完成生成；费用与配额以 Suno 及 Skill 提供方说明为准。 - 合规与版权：生成音乐用于商用或平台发布前，请自行确认 Suno 服务条款及目标平台对 AI 生成内容的规则。
- 版本：本文依据 SkillHub 页面 v1.3.3；升级可用
skillhub在相同--dir下更新，或让 AI 按 skillhub.md 操作。 - 数据口径：SkillHub 展示页会变动评分与下载量；撰写时页面可见为企业 Skill、高评分条目，具体数字以打开页面时为准。
结尾¶
Suno AI写歌 把 Suno 的歌曲生成接到 AI 助手：用主题、歌词、风格或参考音频驱动，得到可试听、可下载的完整曲与候选版本。若你已在 Cursor 或 Claude Code 里用 Skill 扩展能力，可按上文安装坐标 @org-0bqts5ar/suno-ai-songwriting，从 SkillHub 官方页获取最新说明：
https://www.skillhub.cn/skills/org-0bqts5ar/suno-ai-songwriting
