mm-music-expert 是一个用于调用 MiniMax 音乐生成 API 完成音乐创作的技能，默认模型为 music-2.5+（推荐），也可使用 music-2.5。它主要面向音乐新手，通过引导式交互帮助用户把模糊的音乐想法整理成可生成的 prompt 和歌词。
用途方面，该技能适用于生成有人声演唱的歌曲、纯音乐/背景音乐，以及哼唱/吟唱（旋律人声无歌词）。用户可以通过自然语言描述需求，例如“帮我做一首关于杭州的歌”，技能会先确认需求再进入生成流程。
主要能力包括：分步确认音乐类型、风格、情绪、场景、节奏、乐器、人声、歌词来源、情绪走向和参考对象；根据需求设计歌曲蓝图，规划各段落的情绪/能量、乐器编曲、人声表现与制作特点；从蓝图派生 prompt，强调描述段落间的动态变化而非平铺属性；编写带结构标签和括号指令的歌词；调用 scripts/generate_music.py 生成音频；生成后收集反馈并支持修改 prompt 或歌词后重新生成。
使用方式上，需要先设置环境变量 MINIMAX_MUSIC_API_KEY。技能要求遵循四步交互流程：第一步理解并澄清需求，只询问缺失的关键维度，每个问题提供字母选项；第二步设计歌曲蓝图并展示完整方案，包括蓝图表、prompt、歌词和说明，等待用户明确确认；第三步在用户确认后运行生成命令，标准歌曲使用 --lyrics 和 --prompt，纯音乐使用 --is-instrumental true 并省略 --lyrics，自动写词使用 --lyrics-optimizer true 并省略 --lyrics；第四步告知文件位置并邀请试听，根据反馈调整后回到第二步。
适用场景包括短视频/Vlog 背景音乐、个人收藏或送人、游戏/动画配乐、咖啡馆/餐厅氛围音乐、婚礼/庆典、运动/健身音乐等。技能还提供了 prompt 构建公式、歌词结构标签、括号指令、中文空格分词、双语歌词和典型歌曲结构模板等创作参考。
限制方面，纯音乐模式仅 music-2.5+ 支持，music-2.5 不支持；标准歌曲需要歌词，纯音乐需要 prompt；prompt 长度上限为 2000 字符，歌词长度上限为 3500 字符（具体字段约束以资料为准）；生成 API 调用可能需要 30-120 秒。未提供收费、价格、平台覆盖范围或生成质量保证等信息。