minimax-music

Other Community

Repo stars 2
Author repo claude-marketplace

Interpretation is structured for decision-making; original keeps the upstream SKILL.md unchanged.

Decide Fit First

Core job: 高质量歌词必须同时满足：叙事性 + 意象性 + 韵律感 + 情感共鸣检查标准：有没有具体的时间/地点/人物/物品？有没有直接说"心痛/悲伤"？用具体物品和动作替代抽象情绪词： skills/minimax-music/ ├── settings.exa…
Best fit: Use it when the task has reusable inputs, steps, and validation criteria rather than a one-off answer.
Avoid forcing it: If the source lacks commands, platform support, or external-service evidence, keep those fields unknown instead of guessing.

Design Intent

Structure: The skill is organized around “核心方法论”, “AI 音乐生成三大规律”, “歌词四轴法则”, “克制原则”, showing how the author expects the agent to judge fit, collect context, and produce verifiable output.
Trigger evidence: Prioritize the author’s wording around when to use it, what context to collect, and what output shape to produce.
Evidence boundary: Author text states facts, repository files prove commands and paths, and Fluxly only adds fit, limits, and usage judgment.

How To Use It

Inputs: Provide target material, scope, expected result, forbidden changes, and validation method.
Invocation: Name minimax-music directly; if the source includes slash commands, start with the command and then add task context.
Validation: Start small and check whether the result follows “核心方法论 / AI 音乐生成三大规律 / 歌词四轴法则” before expanding.

Boundaries And Review

Dependencies: Prepare Vendor-specific API keys before running a full task.
Permissions: Declared permissions include read / write; ask the agent to state file, command, and rollback boundaries before acting.
Quality bar: A useful result names the deliverable, evidence, and next action. Generic prose means the task needs tighter context.

MiniMax AI 音乐生成 Skill

核心方法论

AI 音乐生成三大规律

约束叠加 > 单一描述：同时给 2-3 个相互制约的风格条件，AI 会做出更精确的创造性选择
Hook-First：先设计副歌记忆点（≤7字，具体画面），再倒推全曲结构
迭代比一次到位更可靠：固定 tempo+mood+song length，每次只改一个变量

歌词四轴法则

高质量歌词必须同时满足：叙事性 + 意象性 + 韵律感 + 情感共鸣 检查标准：有没有具体的时间/地点/人物/物品？有没有直接说"心痛/悲伤"？

克制原则

用具体物品和动作替代抽象情绪词：

❌ "我的心好痛" → ✅ "输入法还记得你的名字"
❌ "时间过得好快" → ✅ "校服领口松了两颗扣"

目录结构

skills/minimax-music/
├── SKILL.md
├── settings.example.yaml    # 配置模板
├── scripts/
│   └── music_generator.py
└── references/
    └── prompt_templates.md  # 完整方法论（必读）

快速开始

环境配置

复制配置模板：

cp settings.example.yaml settings.yaml

在 settings.yaml 中配置输出目录：

OUTPUT_DIR: "/path/to/your/music/output"

确保 MINIMAX_API_KEY 已设置在环境变量中（脚本从 os.environ 读取）

单首生成

from scripts.music_generator import generate_music
import yaml

settings = yaml.safe_load(open("settings.yaml"))
result = generate_music(
    prompt="中文民谣，关于清晨便利店独自喝咖啡的场景...",
    lyrics="___LYRICS_OPTIMIZER___",
    vocals="沙哑男声，有岁月感，有呼吸感",
    genre="folk",
    mood="melancholic, warm",
    instruments="木吉他，指弹风格",
    tempo="moderate",
    structure="verse - verse - pre-chorus - chorus - bridge - chorus",
    avoid="'心痛' or '悲伤' or '眼泪', 情歌套路, 说教结尾",
    settings=settings,
)

每日三首

from scripts.music_generator import generate_daily_music
results = generate_daily_music("/path/to/skills/minimax-music/")

mmx music generate 核心参数

人声音乐（含 --lyrics-optimizer）

mmx music generate \
  --prompt "<场景+情绪描述，禁止项>" \
  --lyrics-optimizer \
  --vocals "<人声：音域+质感+每段落发声策略>" \
  --genre "<流派>" \
  --mood "<情绪>" \
  --structure "<verse-chorus-verse-chorus-bridge-chorus>" \
  --avoid "<具体要排除的元素>" \
  --out "/path/to/output.mp3"

器乐

mmx music generate \
  --prompt "<音色+层次+情绪曲线+场景描述>" \
  --instrumental \
  --genre "<流派>" \
  --mood "<情绪>" \
  --instruments "<乐器层次>" \
  --avoid "<不要的元素>" \
  --structure "<intro - main theme - ending>" \
  --out "/path/to/output.mp3"

--vocals 写法模板

专业写法：音域 + 音色质感 + 各段落发声策略

--vocals "男高音 tenor，略带沙哑有力量感。
          主歌 chest voice 叙事，接近说话的语气；
          预副歌 mixed voice 慢慢叠加能量；
          副歌 strong belt 爆发，高音有穿透力；
          桥段 head voice 轻唱，脆弱感；
          尾副歌 belt 推到最高，最后长音 vibrato 收尾"

核心原则：主歌收 → 预副歌蓄 → 副歌放 → 桥段收 → 尾副歌最放

详见 references/prompt_templates.md — 完整声乐术语和模板

歌词禁止清单

必须禁止：

抽象情绪词：心痛、悲伤、难过、崩溃、绝望
陈词滥调：飞蛾扑火、遍体鳞伤、沧海桑田、海枯石烂
说教结尾：珍惜当下、把握今天、勇敢前行
过度煽情：直接哭喊、直接说"我爱你爱到死"

参考资料

完整方法论、意象库、prompt 模板、速查表： → references/prompt_templates.md

注意事项

mmx music generate 超时 300 秒，耐心等待
--lyrics-optimizer 的 prompt 必须包含场景+禁止项，不能太笼统
API Key 从环境变量 MINIMAX_API_KEY 读取，禁止硬编码
--aigc-watermark 推荐开启
歌词生成后对照四轴法则自检
每日生成建议每次只改一个变量迭代优化

Fluxly profile Author and license come from source; runtime, permissions, and network are Fluxly detections or estimates

Fluxly category: Other
Author-declared agents: No explicit declaration found; this is not inferred or tested compatibility
Static check: 88 / 100 · heuristic scan, not runtime safety proof
Author / version / license: @111pointer111 · no license declared
Fluxly token estimate: Lean
Fluxly setup estimate: Guided setup
External API key: Required · Vendor-specific
Detected OS requirements: Unspecified
Runtime requirements: Python
Detected file/system behavior: Read-only
Write / modify
Detected network behavior: External requests
Install commands: None (reference only)

Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.

Heads up: 未限定 allowed-tools，默认拥有全部工具权限。

Output preview minimax-music.preview

The current SKILL.md does not define a fixed output example.

SKILL.md SKILL.md

# MiniMax AI 音乐生成 Skill

## 核心方法论

### AI 音乐生成三大规律

1. **约束叠加 > 单一描述**：同时给 2-3 个相互制约的风格条件，AI 会做出更精确的创造性选择
2. **Hook-First**：先设计副歌记忆点（≤7字，具体画面），再倒推全曲结构
3. **迭代比一次到位更可靠**：固定 tempo+mood+song length，每次只改一个变量

### 歌词四轴法则

高质量歌词必须同时满足：**叙事性 + 意象性 + 韵律感 + 情感共鸣**
检查标准：有没有具体的时间/地点/人物/物品？有没有直接说"心痛/悲伤"？

### 克制原则

用具体物品和动作替代抽象情绪词：
- ❌ "我的心好痛" → ✅ "输入法还记得你的名字"
- ❌ "时间过得好快" → ✅ "校服领口松了两颗扣"

## 目录结构
```
skills/minimax-music/
├── SKILL.md
├── settings.example.yaml    # 配置模板
├── scripts/
│   └── music_generator.py
└── references/
    └── prompt_templates.md  # 完整方法论（必读）
```

## 快速开始

### 环境配置

1. 复制配置模板：
```bash
cp settings.example.yaml settings.yaml
```

2. 在 `settings.yaml` 中配置输出目录：
```yaml
OUTPUT_DIR: "/path/to/your/music/output"
```

3. 确保 `MINIMAX_API_KEY` 已设置在环境变量中（脚本从 `os.environ` 读取）

### 单首生成
```python
from scripts.music_generator import generate_music
import yaml

settings = yaml.safe_load(open("settings.yaml"))
result = generate_music(
    prompt="中文民谣，关于清晨便利店独自喝咖啡的场景...",
    lyrics="___LYRICS_OPTIMIZER___",
    vocals="沙哑男声，有岁月感，有呼吸感",
    genre="folk",
    mood="melancholic, warm",
    instruments="木吉他，指弹风格",
    tempo="moderate",
    structure="verse - verse - pre-chorus - chorus - bridge - chorus",
    avoid="'心痛' or '悲伤' or '眼泪', 情歌套路, 说教结尾",
    settings=settings,
)
```

### 每日三首
```python
from scripts.music_generator import generate_daily_music
results = generate_daily_music("/path/to/skills/minimax-music/")
```

## mmx music generate 核心参数

### 人声音乐（含 --lyrics-optimizer）
```bash
mmx music generate \
  --prompt "<场景+情绪描述，禁止项>" \
  --lyrics-optimizer \
  --vocals "<人声：音域+质感+每段落发声策略>" \
  --genre "<流派>" \
  --mood "<情绪>" \
  --structure "<verse-chorus-verse-chorus-bridge-chorus>" \
  --avoid "<具体要排除的元素>" \
  --out "/path/to/output.mp3"
```

### 器乐
```bash

…

Evidence boundary and execution chain

Author text anchors workflow facts; Fluxly only indexes current sections, terms, files, and commands.

sections -> 核心方法论 → AI 音乐生成三大规律 → 歌词四轴法则 → 克制原则 → 目录结构 → 快速开始
terms    -> 约束叠加 > 单一描述 · Hook-First · 迭代比一次到位更可靠 · 叙事性 + 意象性 + 韵律感 + 情感共鸣 · 音域 + 音色质感 + 各段落发声策略 · 核心原则 · 300 秒 · 场景+禁止项
files/cmd -> settings.yaml · MINIMAXAPIKEY · os.environ · references/prompttemplates.md · mmx music generate · --lyrics-optimizer · --aigc-watermark
body sha256 -> f3fbdeb9836a