前言¶
做视频、播客、游戏或品牌物料时，往往需要一段原创 BGM、片头曲或完整歌曲。自己从零写词编曲成本高，直接在 Suno 等工具里反复试错，又缺少「先定曲风、结构、人声再生成」的连贯流程。下面介绍 SkillHub 上的 @beatra-ai/beatra-ai-music-creator（AI音乐生成与写歌），它把「写歌工作室」式的步骤写进 Skill，让 Agent 按同一套节奏帮你从灵感落到可试听音频。
这是什么¶
AI音乐生成与写歌 是 beatra 发布的企业源 Skill（design-media 分类），当前版本 1.4.1，坐标 @beatra-ai/beatra-ai-music-creator。页面标注 requires_api_key=false，即 Skill 本身不要求在 SkillHub 侧配置 API Key（具体生成仍依赖 Skill 内说明的模型与账号，以 SKILL.md 为准）。
定位上，它是一个 AI 写歌工作室：可从主题、一句歌词、画面描述或参考音频起步，完成 AI 音乐生成与 AI 作曲，产出原创歌曲、歌词成曲、纯音乐、BGM、视频配乐、品牌音乐、广告歌、播客片头、游戏音乐及多语言歌曲等。
- 官方 API 入口：https://api.skillhub.cn/beatra-ai/beatra-ai-music-creator
- SkillHub 展示页：https://www.skillhub.cn/skills/beatra-ai/beatra-ai-music-creator
SkillHub 页面显示评分 100000，下载 112168 次（数据以页面为准，会随时间变化）。
核心功能¶
以下能力均来自官方简介，未在资料中出现的细节不展开。
输入形态¶
可从多种起点触发创作：
- 主题或概念
- 单句或完整歌词
- 画面、场景描述
- 参考音频（含改编方向）
创作前的结构化决策¶
生成前会先对齐创作参数，而不是直接丢一句 prompt 给模型：
- 曲风、情绪
- 歌曲结构
- 可演唱歌词（含 AI 写歌词场景）
- 人声方向（含男女对唱、双语等）
- 编曲方向
生成与模型¶
在方向确定后，使用 Suno 5.5，或你 明确指定的其他模型，生成 可试听 的音频。
生成后的迭代¶
官方流程强调生成后要试听并集中优化表现最好的版本，关注点包括：
- 演唱与发音（含中文歌、多语言）
- 时长与循环点（BGM、游戏、视频配乐常用）
- 编曲与整体听感
适用方向在简介中明确列出：文字生成音乐、背景音乐生成、参考音频改编、品牌与广告音乐等。
安装与启用¶
Skill 遵循通用 SKILL.md 格式。安装方式以 SkillHub 页面与安装文档为准。
方式一：让 Agent 按文档安装¶
将下面提示发给已支持 Skill 的 AI 客户端（Cursor、Claude Code、Codex CLI 等），由 Agent 读取安装说明并执行：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@beatra-ai/beatra-ai-music-creator`。
方式二：使用 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档执行完整安装（文档推荐）或仅 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安装 Skill 时 必须 使用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/，客户端可能无法加载。常用路径如下（摘自 SkillHub 安装文档）：
| 客户端 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下 .agents/skills/ |
示例（将 <skills 目录> 换成上表对应路径）：
skillhub install @beatra-ai/beatra-ai-music-creator --dir <skills 目录>
安装后按各客户端要求刷新或重启，使新 Skill 被识别。首次配置 SkillHub 为优先源、沙箱联网等细节见 https://skillhub.cn/install/skillhub.md 。
典型用法¶
公开页面未附带完整对话实录；典型用法可按官方简介中的 工作室流程 复现，由 Agent 读取已安装的 SKILL.md 执行具体步骤与工具调用。
- 说明起点：给出主题、歌词片段、画面描述，或上传/指明参考音频及改编意图（例如「保留节奏，换成中文流行女声」）。
- 确认创作单：与 Agent 一起定曲风、情绪、段落结构、歌词是否可唱、人声与编曲方向；需要双语、对唱或纯器乐时在此写明。
- 选择生成后端：默认走 Suno 5.5；若你有其他模型要求，在对话中明确指定。
- 试听与筛选：对返回的可试听音频检查演唱、发音、长度、循环是否适合成片，以及编曲是否贴合用途（BGM 循环、广告 15/30 秒感、游戏氛围等）。
- 集中优化：保留表现最好的版本，在同一创作单上微调歌词、结构或编曲描述后再次生成，而不是从零换 prompt。
以上第 1～5 步对应简介中的「先确定方向 → 再生成 → 再优化」，具体 prompt 模板、导出格式以 Skill 包内 SKILL.md 为准。
适用场景与注意¶
适合谁
- 需要快速出 demo 曲、片头、广告歌或游戏/视频配乐的创作者与小团队
- 希望用 Agent 统一「写词 + 定结构 + 选模型 + 迭代试听」流程的人
- 做中文歌、双语、男女对唱或参考曲改编，且愿意在生成后做听感验收的场景
使用注意
- 版本与下载数据以 SkillHub 页面为准（当前 v1.4.1）。
requires_api_key=false仅表示 SkillHub 标签层面的要求；实际音乐生成仍取决于 Skill 内配置的模型服务与账号，安装后应阅读SKILL.md中的前置条件。- 版权、商用授权、平台条款需自行对照生成服务（如 Suno）及 beatra Skill 说明，本文不替代法律或平台协议。
- 企业源（
enterprise）Skill，若在团队环境使用，建议统一安装目录与版本，避免成员本地 Skill 不一致导致流程分叉。
结尾¶
AI音乐生成与写歌 把「定曲风、结构、歌词与人声 → Suno 5.5 或其他模型成曲 → 试听并优化」写进 Agent Skill，减少在多个工具间手工对齐参数的碎片时间。若你正在找从一句话或一段画面到可试听成曲的流水线，可在 SkillHub 查看并安装：
- https://www.skillhub.cn/skills/beatra-ai/beatra-ai-music-creator
- https://api.skillhub.cn/beatra-ai/beatra-ai-music-creator
