mm-music-expert

# MiniMax Music Expert

Generate music using MiniMax Music Generation API. Default model: **music-2.5+** (recommended).
This skill is designed to help **music novices** create professional-quality music through guided interaction.

## Environment Setup

```bash
export MINIMAX_MUSIC_API_KEY="your_api_key"
```

---

## Agent Workflow (MUST FOLLOW)

When a user requests music creation, **always** follow this 4-step interactive workflow. Do NOT skip steps or jump directly to generation.

### Step 1: Understand & Clarify Requirements

Analyze the user's input and identify which dimensions are already covered vs. missing. Then ask targeted follow-up questions to fill the gaps.

**Dimension checklist** — check which are provided, ask about the rest. Each question MUST provide lettered options (A/B/C/...) for the user to choose from:

| Dimension | Question with options |
|-----------|---------------------|
| **Type** | "这首歌的类型？ **A.** 有人声演唱的歌曲 **B.** 纯音乐/背景音乐(无人声) **C.** 哼唱/吟唱(旋律人声无歌词)" |
| **Genre/Style** | "你喜欢什么音乐风格？ **A.** 流行 **B.** 摇滚 **C.** 民谣 **D.** 电子/EDM **E.** 嘻哈/说唱 **F.** 爵士 **G.** 古风/中国风 **H.** R&B **I.** 其他(请描述)" |
| **Mood/Emotion** | "希望传达什么情绪？ **A.** 欢快活泼 **B.** 温柔抒情 **C.** 忧伤感怀 **D.** 激昂热血 **E.** 治愈放松 **F.** 大气磅礴/史诗感 **G.** 浪漫甜蜜 **H.** 其他(请描述)" |
| **Scene/Use case** | "这首歌打算用在什么场景？ **A.** 短视频/Vlog BGM **B.** 个人收藏/送人 **C.** 游戏/动画 **D.** 咖啡馆/餐厅 **E.** 婚礼/庆典 **F.** 运动/健身 **G.** 其他(请描述)" |
| **Tempo/Rhythm** | "节奏方面的偏好？ **A.** 慢速抒情(60-80 BPM) **B.** 中速舒缓(80-110 BPM) **C.** 中快轻快(110-130 BPM) **D.** 快速动感(130-160 BPM) **E.** 不确定，交给你来定" |
| **Instruments** | "有没有想要的乐器？ **A.** 钢琴为主 **B.** 吉他(民谣/电吉他) **C.** 中国民乐(笛子/琵琶/古筝/二胡) **D.** 弦乐(小提琴/大提琴) **E.** 电子合成器 **F.** 管乐(萨克斯/小号) **G.** 不确定，根据风格搭配 **H.** 其他(请描述)" |
|...