技能创建
- 作者仓库星标 2
- 作者仓库 claude-marketplace
- 领域
- 通用
- 作者声明的智能体
- 未找到明确声明;不据此推断已兼容或已测试
- 静态检查
- 88 / 100 · 启发式扫描,不代表运行安全
- 运行环境证据
- 未执行;当前没有隔离运行测试证据
- 作者 / 版本 / 许可证
- @111pointer111 · 未声明许可证
- 上下文用量评级
- 低消耗
- 接入复杂程度
- 需简单配置
- 是否需要外部接口密钥
- 需要 · Vendor-specific
- 兼容的系统
- 未声明(默认跨平台)
- 运行环境要求
- Python
- 检测到的文件与系统行为
-
- 只读
- 允许写入 / 修改
- 网络行为
- 允许外网请求
- 安装命令数
- 无(仅作为资料)
需要注意: 未声明工具权限范围;实际权限由运行环境决定。
# 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
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` 推荐开启
- 歌词生成后对照**四轴法则**自检
- 每日生成建议**每次只改一个变量**迭代优化
章节与文件索引
按说明文件中的顺序排列。
AI 音乐生成三大规律
克制原则
环境配置
--vocals 写法模板
歌词禁止清单
文件/命令 -> settings.yaml · MINIMAX_API_KEY · os.environ · references/prompt_templates.md · mmx music generate · --lyrics-optimizer · --aigc-watermark
内容校验值 -> f3fbdeb9836a
当前原文的自动摘译,尚未人工审校。
AI 音乐生成三大规律
约束叠加 > 单一描述:同时给 2-3 个相互制约的风格条件,AI 会做出更精确的创造性选择 Hook-First:先设计副歌记忆点(≤7字,具体画面),再倒推全曲结构 迭代比一次到位更可靠:固定 tempo+mood+song length,每次只改一个变量
克制原则
用具体物品和动作替代抽象情绪词: ❌ "我的心好痛" → ✅ "输入法还记得你的名字" ❌ "时间过得好快" → ✅ "校服领口松了两颗扣"
环境配置
复制配置模板: 在
settings.yaml中配置输出目录: 确保MINIMAX_API_KEY已设置在环境变量中(脚本从os.environ读取)--vocals 写法模板
专业写法:音域 + 音色质感 + 各段落发声策略 核心原则:主歌收 → 预副歌蓄 → 副歌放 → 桥段收 → 尾副歌最放 详见
references/prompt_templates.md— 完整声乐术语和模板歌词禁止清单
必须禁止: 抽象情绪词:心痛、悲伤、难过、崩溃、绝望 陈词滥调:飞蛾扑火、遍体鳞伤、沧海桑田、海枯石烂 说教结尾:珍惜当下、把握今天、勇敢前行 过度煽情:直接哭喊、直接说"我爱你爱到死"