前言¶
做短视频 BGM、活动主题曲或产品 demo 时，常见路径是：自己写词、找编曲、再进 DAW 混一版。流程长，且「先有一首能听的完整歌」往往比精修更重要。若你已经在 Cursor、Claude Code 等环境里用 Agent 处理文案和素材，把「写歌」也交给同一套对话流程，可以减少在多个工具之间切换的成本。
下面介绍 SkillHub 上的 AI写歌生成器（@org-0bqts5ar/ai-write-song）：在对话里输入主题、歌词或风格方向，由 AI 助手调用该 Skill 生成可试听、可下载的完整歌曲，并附带项目链接与两首候选版本。
这是什么¶
AI写歌生成器 是面向 design-media 分类的 Agent Skill，坐标 @org-0bqts5ar/ai-write-song，当前版本 1.3.3，来源为 enterprise，由 乐萱同行科技（深圳）有限公司 发布。
它解决的是：在 Agent 对话中，用自然语言描述创作意图（从一句主题到完整歌词、标题和风格），快速得到完整歌曲输出，而不是只生成文字歌词或 MIDI 说明。官方简介明确支持检索场景如 AI写歌、写歌AI、自动写歌、write song AI、AI歌曲生成器等需求。
SkillHub 页面统计（以抓取资料为准）：评分 100000，下载 1451 次。技能标签包含 requires_api_key=true，使用前需按 Skill 说明配置 API 密钥。
核心功能¶
以下能力均来自官方简介与 SkillHub 页面，未单独核实的接口细节不展开。
- 多种输入粒度：可只给一句主题；也可提供完整歌词，并补充标题与风格方向。
- 完整歌曲产出：生成可试听、可下载的完整歌曲（非仅文本歌词）。
- 双候选版本：一次流程返回 两首候选歌，便于对比选版。
- 项目链接：结果中包含 项目链接，便于后续打开或管理生成内容。
安装与启用¶
官方安装指引为：根据 SkillHub 安装文档 安装 @org-0bqts5ar/ai-write-song。也可在 SkillHub 技能页将安装提示词发给当前 AI，让其按同一文档完成安装。
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 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 到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；文档说明默认装到 ./skills/ 可能不会被 Agent 加载，且安装后通常需要重启 Agent。
搜索与安装示例（将坐标替换为本技能）：
skillhub search ai-write-song
skillhub install org-0bqts5ar/ai-write-song --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
3、API Key¶
标签 requires_api_key=true 表示该 Skill 依赖外部服务密钥。具体环境变量名、申请入口与填写方式以安装后技能包内的 SKILL.md 及发布方说明为准；未在公开页面写明的内容此处不臆测。
典型用法¶
公开页面未提供固定 CLI 子命令或 JSON 请求体示例，典型用法即 在已启用该 Skill 的 Agent 对话中描述创作需求，由 Agent 按 SKILL.md 调用能力。下面三类输入与官方简介一致，可直接复现交互方式。
仅主题（最小输入）
在对话中说明要写歌，并给出一句主题，例如要求生成一首关于「城市夜景」的歌曲，请返回可试听链接与两首候选。
主题 + 风格
补充风格方向（如流行、民谣、电子等，以你实际支持的描述为准），让 Agent 在生成时约束曲风。
完整歌词 + 标题 + 风格
粘贴已写好的歌词，并给出曲名与风格说明，由 Skill 生成完整歌曲、项目链接及两首候选版本。
经过上面的步骤，你应能在回复中获得：完整歌曲（可试听、可下载）、项目链接、两首候选歌。
适用场景与注意¶
适合谁
- 需要快速出「能听的完整歌」的内容创作者、运营或产品经理，且已在使用支持 Skill 的 AI 客户端。
- 正在搜索 AI写歌、写歌AI、自动写歌、write song AI、AI歌曲生成器等方案，希望把能力挂在 Agent 工作流里的开发者。
需要注意
- API Key：
requires_api_key=true，未配置密钥时 Skill 可能无法调用后端生成服务。 - 安装路径：务必
skillhub install ... --dir指向正确目录，并按要求重启 Agent。 - 版本与来源：当前为 v1.3.3、enterprise 来源；升级与变更以 SkillHub 页面为准。
- 版权与商用：生成音乐的授权、商用范围以发布方服务条款为准，使用前请自行确认。
结尾¶
AI写歌生成器 把「主题 / 歌词 / 风格 → 完整歌曲 + 双候选 + 项目链接」收敛到 Agent 对话里，适合把写歌从独立工具链里拆出来、交给助手编排的场景。
- SkillHub 技能页：https://www.skillhub.cn/skills/org-0bqts5ar/ai-write-song
- 官方地址：https://api.skillhub.cn/org-0bqts5ar/ai-write-song
- 安装说明：https://skillhub.cn/install/skillhub.md
