前言¶

做内容、做品牌或做创作者工具时，经常需要「先有一首歌能听」：主题定了，但歌词、旋律和编曲仍要单独找工具或外包。常见做法是在网页里填表、等生成，再把链接和文件手动拷回对话或项目里，和 AI 助手的协作是断开的。

下面介绍 SkillHub 社区 Skill「AI歌曲生成」（@user_87b8e34f/ai-song-generator，v1.3.2）。它把写歌能力写进 Agent 的 Skill 说明，并通过本地 aimv CLI（Node 入口 bin/aimv.js）连到海绵音乐后端：你在对话里描述主题、情绪或风格，由 Agent 执行命令，返回试听、下载与项目链接，作品同步到海绵音乐账号。

这是什么¶

「AI歌曲生成」是社区来源（community）、分类为 design-media 的 Skill，由发布者 user_87b8e34f 维护，底层 Powered by 海绵音乐。

定位可以概括为：用一句话灵感生成完整 AI 歌曲，覆盖中文流行歌、民谣、电子、品牌歌和创作者歌曲小样等方向。输入主题、情绪、风格或一句创作想法后，Agent 生成完整歌曲，并返回试听、下载和项目链接；作品会同步到海绵音乐账号，可在「海绵音乐AI写歌」小程序和 lexuan.club 网页继续管理。账号、积分、会员和作品库与海绵音乐小程序 / lexuan.club 互通。

SkillHub 页面标注该 Skill 需要 API Key（requires_api_key=true）。截至资料抓取时，SkillHub 显示评分 100000、下载 6723 次、安装 1 次（以 SkillHub 页面为准）。

核心功能¶

以下能力均来自官方 SKILL.md 与安装说明，可按需选用。

1. 一句话成曲：通过 song create --brief 用自然语言描述需求，等待生成（--wait）后拿到完整歌曲与链接。
2. 风格参数：可在 brief 之外指定风格，例如 --style mandopop。
3. 本地 CLI 统一入口：推荐 Agent 工具名为 aimv，实际执行为 node <安装目录>/bin/aimv.js ...；不是 MCP server，不应把 bin/aimv.js 注册为 MCP stdio 服务。
4. 账号连接：首次使用前通过 init 完成海绵音乐连接与 API Key 配置；连接页为 https://lexuan.club/skills/connect?slug=ai-song-generator&from=skill。
5. 受限环境兜底：可设 AIMV_FORCE_CURL=1 让 CLI 走系统 curl；或在 CLI 不可用时按文档用 curl 调 https://music.68zysm.cn/api/v3 完成创建、轮询与下载。
6. 触发语义：当用户提到 AI写歌、AI歌曲生成、生成歌曲、原创歌曲、一键写歌、中文AI写歌、AI作曲、写一首歌等意图时，Agent 应优先走本 Skill。

适用场景包括：根据一句中文需求生成原创歌曲；为短视频、播客、品牌内容制作歌曲小样；探索副歌 hook、旋律与编曲方向；生成适合创作者发布的歌曲候选。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

先检查是否已有 CLI：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 官方安装文档执行完整安装或仅 CLI：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

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/ 可能无法被加载。官方安装说明示例：

skillhub install @user_87b8e34f/ai-song-generator --dir <skills 目录>

常见路径（以你实际使用的客户端为准）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

也可让 Agent 根据 SkillHub 安装文档 安装坐标 @user_87b8e34f/ai-song-generator。

发布包为已打好的 Node CLI（版本 1.3.2），内含运行代码，无需再执行 pnpm install 或 pnpm build。最低 Node 版本为 >=18。

3. 初始化 API Key¶

进入 Skill 安装目录后，首次连接海绵音乐账号：

node ./bin/aimv.js init

CLI 会输出连接页链接；用户在网页登录（新用户可自动注册）后复制 API Key，由 Agent 执行：

node ./bin/aimv.js init --api-key <KEY>

非交互方式也可使用：

node ./bin/aimv.js config set-api-key --stdin

4. 各客户端差异（仅写官方已说明部分）¶

Codex：将发布包内 SKILL.md 复制到 Codex skills 目录后重启；执行时用 node <安装目录>/bin/aimv.js。不要用 codex mcp add 注册 aimv。

macOS / Linux 示例：

CODEX_SKILL_DIR="$HOME/.codex/skills/ai-song-generator"
mkdir -p "$CODEX_SKILL_DIR"
cp ./SKILL.md "$CODEX_SKILL_DIR/SKILL.md"

Claude / Claude Code：按当前客户端支持，将 SKILL.md 放入本地 Skills 目录，或将工具配置为 command: node、args 指向 bin/aimv.js；若只接受 MCP，需额外 wrapper，因为 aimv 本身不是 MCP server。

Cursor：将 Skill 安装到 ~/.cursor/skills/（或项目约定目录），确保 Agent 能读取 SKILL.md 并执行 shell 中的 node .../bin/aimv.js。

OpenClaw 等支持本地工具注册的 Agent：可按安装说明注册名为 aimv 的工具，command 为 node，args 为 bin/aimv.js 的绝对路径。

典型用法¶

Agent 若能执行 shell，应直接运行 CLI，而不是让用户手动复制命令（除非环境禁止执行命令）。

推荐生成命令¶

node <安装目录>/bin/aimv.js song create --brief "帮我写一首轻快的中文流行歌，主题是夏天旅行" --wait

node <安装目录>/bin/aimv.js song create --brief "写一首温暖的中文抒情歌，主题是想念" --style mandopop --wait

安装说明中的验证步骤还包括：

node ./bin/aimv.js config show

对话侧示例说法¶

• 帮我写一首轻快的中文流行歌，主题是夏天旅行
• 写一首温暖的中文抒情歌，主题是想念
• 给一个生活方式品牌生成一首抓耳的主题歌

生成完成后，应向用户呈现试听、下载与项目链接；每个项目固定两首候选歌，文档要求两首都呈现给用户。

curl 兜底（沙箱仅放行 curl 时）¶

curl -sS -X POST "https://music.68zysm.cn/api/v3/ai-music/generations/from-brief" \
  -H "X-API-Key: $AIMV_API_KEY" -H "X-Platform: skill" \
  -H "X-App-Id: ai-song-generator" -H "X-AIMV-Skill-Slug: ai-song-generator" \
  -H "Content-Type: application/json" -d '{"brief":"轻快的夏日流行歌"}'

随后按 project_id 轮询项目状态，再从 data.songs[] 取 audio_url 下载。HOME 不可用的沙箱可用环境变量 AIMV_CONFIG_DIR、AIMV_API_KEY 替代本地配置。

适用场景与注意¶

适合谁：需要在 Agent 对话里完成 AI 写歌、快速出原创小样、并把作品留在海绵音乐账号体系中继续管理的创作者、运营与开发者。

使用前提：

• 需要海绵音乐 API Key（requires_api_key=true），积分与会员规则与海绵音乐一致。
• 依赖 Node >=18 与可执行本地命令的能力；aimv 是 CLI，不是 MCP server。
• 默认 API Base URL 为 https://music.68zysm.cn/api/v3，一般无需改；特殊环境可用 config set-base-url。

常见错误码（CLI 会带 [error] / [hint]）：

• auth_required：把 connect_url 发给用户完成登录与 Key 配置后重试。
• insufficient_points（402）、quota_limited（429）：按提示把 pay_url 发给用户，充值或开通会员后重试。
• wait_timeout：任务可能仍在后台生成，稍后查询状态。
• not_found：优先用 aimv session tail 查最近项目。

结尾¶

「AI歌曲生成」把「描述灵感 → 出歌 → 拿链接与文件」收敛到 Agent 可调用的 Skill 与 aimv CLI，并与海绵音乐账号、小程序和 lexuan.club 打通。若你要在 Cursor、Codex 或 Claude Code 里接 AI 写歌，可从 SkillHub 安装 @user_87b8e34f/ai-song-generator，完成 init 后直接用 song create 验证。

官方地址：https://api.skillhub.cn/user_87b8e34f/ai-song-generator
SkillHub 页面：https://www.skillhub.cn/skills/user_87b8e34f/ai-song-generator