前言¶
做短视频、品牌内容或独立创作时，音乐往往卡在「有想法、没成品」：要在 DAW 里从零搭编曲，或反复在网页工具与本地素材之间切换，对话里很难一次拿到可试听、可下载的成曲。若希望 Agent 能直接根据 brief、歌词或参考音频发起生成，并把作品同步到统一账号里管理，就需要把海绵音乐的能力接到本地 Skills 工作流里。下面介绍 SkillHub 上的 海绵音乐AI写歌（@user_87b8e34f/haimian-music，当前版本 1.3.2）。
这是什么¶
海绵音乐AI写歌 是海绵音乐官方的 AI 音乐生成 Skill，归类为 SkillHub design-media，来源为社区发布（发布者 user_87b8e34f）。它在 AI 助手中通过本地 Node CLI（入口 bin/aimv.js，推荐工具名 aimv）调用后端，而不是把 bin/aimv.js 注册成 MCP stdio 服务。
你描述风格、情绪、歌词或使用场景后，可在对话链路里完成生成，并获得试听、下载和项目链接；作品会同步到海绵音乐账号，并可在「海绵音乐AI写歌」小程序与 lexuan.club 网页继续管理。账号、积分、会员与作品库与海绵音乐小程序 / lexuan.club 互通。SkillHub 标记该 Skill 需要 API Key（requires_api_key=true）。
核心功能¶
以下能力均来自官方 SKILL.md 与安装说明，可按需组合使用：
- AI 写歌 / 原创歌曲：用 brief 描述主题与风格，生成完整歌曲候选。
- 歌词成曲：提供歌词、标题与风格标签，从文本生成成曲。
- 纯音乐 BGM：按场景生成背景音乐（如发布会开场、短视频铺底）。
- 参考音频改编：上传或引用参考素材，生成更贴近需求的版本（需关注参考素材就绪状态）。
- 查询与下载：Agent 通过 CLI 轮询项目状态、获取试听链接并下载音频；每个项目固定两首候选，需一并呈现给用户。
触发语义包括：海绵音乐、AI音乐生成、AI写歌、生成音乐、歌词成曲、BGM生成、背景音乐、参考音频改编等。
安装与启用¶
1. 安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时可执行官方一键脚本（完整包或仅 CLI，以 SkillHub 安装文档 为准）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2. 安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被 Agent 加载。常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令（与 SkillHub 页面说明一致）：
skillhub install @user_87b8e34f/haimian-music --dir ~/.cursor/skills
将 ~/.cursor/skills 换成你实际使用的目录。安装完成后，Agent 应能读取包内 SKILL.md，并具备执行 node <安装目录>/bin/aimv.js 的能力。发布包要求 Node >= 18，解压即用，无需在包内再执行 pnpm install 或 pnpm build。
3. 首次连接（API Key）¶
第一次生成前若未登录，由 Agent 运行初始化（路径替换为你的安装目录）：
node <安装目录>/bin/aimv.js init
CLI 会输出连接页：https://lexuan.club/skills/connect?slug=haimian-music&from=skill。用户在网页登录（新用户可自动注册）后复制 API Key，Agent 再执行：
node <安装目录>/bin/aimv.js init --api-key <KEY>
Key 长期有效，一般只需配置一次。也可用 node ./bin/aimv.js config set-api-key --stdin 非交互写入。
Codex：可将 SKILL.md 复制到 ~/.codex/skills/haimian-music/SKILL.md 后重启 Codex；执行时仍用 node <安装目录>/bin/aimv.js，不要用 codex mcp add 把 aimv 当成 MCP server。
Claude 系列：以当前客户端是否支持本地 Skills / 本地命令工具为准，按 INSTALL.md 将工具配置为 command: node + args 指向 bin/aimv.js 的绝对路径。
典型用法¶
在已连接 API Key、且 Agent 能执行 shell 的前提下，初始化、生成、查询、下载应由 Agent 直接跑 CLI，而不是让用户手动复制一长串命令（除非环境禁止执行本地命令）。
官方推荐示例：
node <安装目录>/bin/aimv.js song create --brief "写一首轻快的中文流行歌，主题是夏天旅行" --wait
node <安装目录>/bin/aimv.js song create --lyrics "..." --title "夏天旅行" --style mandopop --wait
node <安装目录>/bin/aimv.js bgm create --brief "适合产品发布会开场的电子 BGM" --wait
验证环境与配置时可先执行：
node <安装目录>/bin/aimv.js config show
若沙箱只允许 curl 联网，可设 AIMV_FORCE_CURL=1 后重试原命令；或在 CLI 不可用时按 SKILL.md 用 curl 调用 https://music.68zysm.cn/api/v3，请求头需包含 X-API-Key、X-App-Id: haimian-music、X-AIMV-Skill-Slug: haimian-music 等字段。无 HOME 的环境可用 AIMV_CONFIG_DIR、AIMV_API_KEY 替代本地配置。
适用场景与注意¶
适合谁：需要把「写歌、成曲、BGM、参考改编」嵌进 Agent 工作流的专业创作者与内容团队；希望在对话里拿到双候选成曲，并在小程序 / lexuan.club 延续编辑的团队。
使用注意：
- 积分与会员：
insufficient_points（402）或quota_limited（429）时，CLI 的[error]会带pay_url=，需在网页完成充值或开通会员后重试。 - 鉴权：
auth_required时按connect_url完成连接，勿跳过 API Key。 - 长任务：
wait_timeout表示后台仍在生成，应按[hint]稍后查询，不等于失败。 - 参考改编：
reference_not_ready时需先确认参考素材或项目状态。 - 网络环境：默认 API Base 为
https://music.68zysm.cn/api/v3；特殊环境可用node ./bin/aimv.js config set-base-url调整（一般用户用不到）。
SkillHub 页面显示该 Skill 评分 100000、下载 7324 次（统计以 SkillHub 为准，会随时间变化）。
结尾¶
海绵音乐AI写歌 把海绵音乐官方的写歌、歌词成曲、BGM、参考改编与下载能力，收敛成 SKILL.md + 本地 aimv CLI 的标准 Skill 形态，便于在 Cursor、Codex、Claude Code 等环境里用自然语言驱动成曲。安装与说明入口：
