前言¶

做短视频配乐、活动 demo 或歌词草稿时，常见做法是切到网页工具里填表单、等生成、再拷链接回来。流程长，作品也难和账号里的历史项目对齐。若你已经在 Cursor、Claude Code 等环境里用 Agent 写文案、改代码，更顺手的方式是把「写一首歌」当成一条可执行的 Skill：用自然语言交代主题、风格或歌词，由 Agent 调本地 CLI 完成生成，并直接带回试听与下载。

下面介绍 SkillHub 社区 Skill AI写歌（@user_87b8e34f/ai-songwriting，当前版本 1.3.2）的定位、能力与安装用法。

这是什么¶

AI写歌是面向中文音乐创作者的 Agent Skill，由社区发布者 user_87b8e34f 维护，分类为 design-media，底层能力由 海绵音乐 提供。账号、积分、会员与作品库与「海绵音乐AI写歌」小程序及 lexuan.club 网页互通。

一句话：在 AI 对话里描述主题、风格、情绪、歌词或使用场景，即可生成完整歌曲，并获得试听链接与音频下载；作品会同步到海绵音乐账号，便于在小程序或网页继续管理。

与「只在聊天里编一段歌词」不同，本 Skill 要求 Agent 通过安装目录下的 Node 入口 bin/aimv.js 调用本地 aimv CLI（通用本地 CLI，不是 MCP server），对接海绵音乐生成与项目状态。

核心功能¶

依据 Skill 说明与 SkillHub 页面，已核实能力包括：

1. 中文写歌：根据主题、风格、情绪或一句创意 brief 生成完整歌曲（原创路径）。
2. 歌词成曲、纯音乐等：CLI/API 侧支持 from-lyrics、instrumental 等模式（与 from-brief 并列，见 Skill 内 curl 示例）。
3. 交付物：生成结果包含试听链接与可下载音频；每个项目固定 两首候选歌，呈现时应都交给用户。
4. 账号同步：作品进入海绵音乐账号，可在「海绵音乐AI写歌」小程序与 lexuan.club 管理。
5. Agent 侧执行：有 shell 权限时，由 Agent 直接跑 aimv 完成初始化、生成、查询与下载，而不是让用户手抄一长串命令。

SkillHub 标签 requires_api_key=true：首次使用前需完成海绵音乐连接并配置 API Key（见下文）。

安装与启用¶

1. 安装 SkillHub CLI¶

若尚未安装，可按 SkillHub 官方安装说明执行：

command -v skillhub && skillhub --version

未安装时（完整安装或仅 CLI）：

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. 安装 AI写歌 Skill¶

安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。官方页面要求参照 SkillHub 安装文档 安装坐标 @user_87b8e34f/ai-songwriting。

示例（将 <skills 目录> 换成你环境对应路径）：

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

常用路径（来自 SkillHub 安装文档）：

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

安装完成后，Skill 包内入口为 bin/aimv.js；下文用 <安装目录> 表示该 Skill 在 skills 目录中的实际路径（例如 .../@user_87b8e34f/ai-songwriting）。

3. 连接海绵音乐（API Key）¶

第一次生成前若未登录，Agent 应执行：

node <安装目录>/bin/aimv.js init

CLI 会给出连接页链接：

https://lexuan.club/skills/connect?slug=ai-songwriting&from=skill

把链接发给用户；用户在网页登录（新用户可自动注册）后复制 API Key，再由 Agent 执行：

node <安装目录>/bin/aimv.js init --api-key <KEY>

Key 长期有效，一般只需配置一次。沙箱无 HOME 时，可用环境变量 AIMV_API_KEY 或 AIMV_CONFIG_DIR 指向可写配置目录（见 Skill 说明）。

典型用法¶

在对话里触发¶

当用户提到 AI写歌、AI作词作曲、自动写歌、中文 AI 写歌等意图时，Agent 应优先启用本 Skill。用户说法示例（来自官方 Skill 文档）：

• 「AI写歌，帮我写一首轻快的中文流行歌，主题是夏天旅行」
• 「用 AI 写一首适合毕业季的校园民谣」
• 「帮我自动写歌，风格年轻、有记忆点，适合品牌发布会」

推荐 CLI 命令¶

有 shell 时，由 Agent 直接运行（--wait 会阻塞到任务完成或超时）：

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

带风格标签示例：

node <安装目录>/bin/aimv.js song create --brief "用 AI 写一首适合毕业季的校园民谣" --style folk mandopop --wait

若环境已把 aimv 注册为工具，也可调用 aimv song create / aimv bgm create 等等价逻辑；未注册时一律使用 node <安装目录>/bin/aimv.js ...。

受限网络环境¶

若沙箱只允许 curl、aimv 报网络错误而 curl 正常，可先设置 AIMV_FORCE_CURL=1 后重试原命令。CLI 完全不可用时，Skill 文档提供与 CLI 一致的 HTTP API（https://music.68zysm.cn/api/v3/ai-music/...），请求头需包含 X-API-Key、X-Platform: skill、X-App-Id: ai-songwriting、X-AIMV-Skill-Slug: ai-songwriting。API Key 仍来自上述连接页。

适用场景与注意¶

适合谁

• 需要快速出歌 demo 的短视频、品牌或活动创作者；
• 想用中文 brief 探索歌词与编曲方向、而不是从零搭 DAW 工程的人；
• 已在 AI 助手工作流中、希望生成结果自动进海绵音乐作品库的用户。

使用注意

1. 积分与会员：CLI 在积分不足（业务码 402）或额度受限（429）时会输出带 pay_url= 的 [error] 标签，需引导用户在网页充值或开通会员后重试。
2. 鉴权：auth_required 时按 connect_url 完成连接，勿跳过 init --api-key。
3. 等待超时：wait_timeout 表示后台仍在生成，应按 [hint] 稍后查询，不等于失败。
4. 不要误注册 MCP：bin/aimv.js 是 Node CLI，不要当作 MCP stdio 服务注册。

SkillHub 社区页显示本 Skill 评分 100000、下载 8842 次（统计随 SkillHub 更新变化）。

结尾¶

AI写歌把中文写歌需求收敛成 Agent 可执行的 Skill：自然语言描述需求，本地 aimv CLI 对接海绵音乐，回传试听与下载，并在小程序与 lexuan.club 延续管理。

• SkillHub 页面：https://www.skillhub.cn/skills/user_87b8e34f/ai-songwriting
• 安装坐标：@user_87b8e34f/ai-songwriting
• 官方地址：https://api.skillhub.cn/user_87b8e34f/ai-songwriting