技能介绍

解决的具体问题

在日常内容创作中，创作者常面临“有主题、有歌词，却缺乏音乐制作能力或工具门槛过高”的痛点。无论是为短视频准备轻快 BGM，还是将一段中文歌词转化为完整的流行歌曲，手动操作网页端往往需要频繁切换、复制参数，且难以在 Agent 对话流中无缝完成。本技能旨在消除这些摩擦，让 AI 助手直接接管从“文本/参考音频”到“可试听、可下载歌曲”的全流程，作品自动同步至海绵音乐账号，方便后续在小程序或网页端继续管理。

核心能力与关键步骤

本地 CLI 驱动：该技能基于通用 Node CLI（推荐工具名 aimv，入口 bin/aimv.js），而非 MCP server。Agent 可直接在 Shell 中执行初始化、生成、查询与下载命令，无需用户手动复制命令或打开网页（除非无执行权限）。
首次连接：若未登录，Agent 运行 node /bin/aimv.js init 获取 connect_url。用户在网页完成登录（新用户自动注册）并复制 API Key 后，Agent 执行 node /bin/aimv.js init --api-key <key> 完成长期有效的连接。
触发与生成：当用户提出“suno写歌”、“AI写歌”、“歌词成曲”或指定 Suno 相关需求时，Agent 可调用 aimv song create 等逻辑命令，或直接运行 CLI 传入主题、歌词、风格或参考音频，获取两首候选歌曲。
结构化错误处理：CLI 会输出 [error] 与 [hint] 标签。Agent 需根据 code 进行引导：

- auth_required：发送连接链接引导用户获取 Key。
- insufficient_points (402) 或 quota_limited (429)：发送 pay_url 引导用户充值或开通会员。
- wait_timeout / reference_not_ready：提示任务仍在后台运行或素材未就绪，稍后查询状态。
- not_found：建议使用 aimv session tail 检索最近项目。

适用边界与注意点

受限沙箱环境：若 Agent 运行在仅放行 curl 等白名单工具的沙箱中，导致 aimv 报网络错误或 HTTP 400，可优先设置环境变量 AIMV_FORCE_CURL=1 强制 CLI 使用系统 curl 传输；若 CLI 彻底不可用，则需直接通过 curl 调用 API 完成生成与鉴权，响应信封格式与 CLI 保持一致。
账号体系绑定：账号、积分、会员与作品库均与“海绵音乐”体系互通。生成歌曲消耗对应积分，达到上限需通过网页端充值或升级会员。
候选结果展示：每次生成项目固定输出两首候选歌曲，Agent 必须将两首结果完整呈现给用户，不可遗漏。