📦 music-composer — 专业音乐创作规划

v1.0.1

基于 mmx-cli(MiniMax AI)生成高质量音乐和歌曲的专业音乐创作规划 Skill。自动规划曲风(Genre)、节奏(Tempo)、乐器编配(Instrumentation)、人声特色(Vocal),将用户的模糊需求转化为精准的生成 Prompt。支持纯器乐(instrumental)、中文歌词歌曲、英文歌词歌曲、音乐封面翻唱。

0· 21·0 当前·0 累计
yuhouxinliang 头像by @yuhouxinliang (朱一新)·MIT-0
下载技能包
License
MIT-0
最后更新
2026/4/16
0
安全扫描
VirusTotal
无害
查看报告
OpenClaw
可疑
medium confidence
该技能的行为(运行外部 'mmx' CLI 并包含辅助脚本)与其音乐生成描述相符,但包元数据缺少必需的 mmx 二进制文件,且未提供主页/来源——这种不匹配以及未经验证的 npm 安装建议令人担忧。
评估建议
在安装或运行此技能之前:- 验证 mmx CLI:该技能依赖外部工具 'mmx',但注册表元数据未声明它。确认官方项目/主页(SKILL.md 提到 https://www.minimax.io — 检查该域名和 npm 包 @aivcore/mmx-cli 是否与官方项目匹配)。- 优先进行沙箱测试:如果必须 'npm install -g',考虑先在容器或 VM 中安装以观察行为(全局 npm 安装可以运行任意脚本)。- 验证 npm 包和作者:审查 @aivcore/mmx-cli 包、其维护者以及 GitHub/发布标签,然后再信任它。- 检查 'mmx' 的功能:包含的代码将调用 'mmx quota' 和 'mmx music generate/cover' — 确认 mmx CLI 不会上传本地文件或发送您不期望的遥测数据。- 对文件内容保持谨慎:脚本会读取您提供的歌词文件并将输出写入 ~/video;避免在输入中放置敏感数据。- 如果需要更高保障,请向发布者请求官方主页/来源,或要求注册表元数据更新以声明 'mmx' 为必需二进制文件并包含经过验证的上游 URL。总体而...
详细分析 ▾
用途与能力
SKILL.md 和附带的脚本都要求使用外部 'mmx' CLI(甚至建议通过 npm 安装 @aivcore/mmx-cli)。然而,技能的注册表元数据没有列出必需的二进制文件、主页和来源。这种遗漏不一致:音乐生成技能确实需要 mmx,因此元数据应该声明它并提供可信的来源。缺失的主页/来源使得更难验证所声称的上游项目。
指令范围
运行时指令和脚本保持在所述用途范围内:它们运行 mmx 命令、构建提示、读取用户提供的歌词文件并将输出文件写入 ~/video。SKILL.md 明确建议在运行命令之前验证 mmx 二进制文件。该技能不请求无关的系统文件或环境变量,也不试图将数据泄露到所提供的文件中的外部端点。
安装机制
注册表中没有正式的安装规范(仅说明),但 SKILL.md 建议通过 npm 安装 mmx('npm install -g @aivcore/mmx-cli')。由于该技能没有主页/来源,且 npm 包命名空间未在此独立验证,推荐全局 npm 安装是一个中等风险的指令——用户应该确认包的官方来源,并考虑在沙箱或容器中安装。
凭证需求
该技能不请求环境变量、凭据或配置路径。脚本只使用用户的主目录进行输出并读取提供的歌词文件;所提供的代码中无法访问无关的机密或系统配置。
持久化与权限
该技能不请求'始终'存在,也不修改其他技能或系统范围的设置。它按需运行并使用外部 mmx CLI;自主设置是默认的,适合这种集成类型。
安全有层次,运行前请审查代码。

License

MIT-0

可自由使用、修改和再分发,无需署名。

运行时依赖

无特殊依赖

版本

latestv1.0.12026/4/16

- 新增依赖检查与安全声明:要求在生成音乐前,先验证 mmx CLI 是否已正确安装且来源可信。- 提供 mmx 安装指引,并加入官方渠道提示,避免从未知来源获取。- 明确规定必须执行 mmx 存在性与版本检查,若检查未通过,禁止执行生成命令并提醒用户。- 调整生成命令前置说明,强调执行前需完成依赖校验。

无害

安装命令

点击复制
官方npx clawhub@latest install music-composer
镜像加速npx clawhub@latest install music-composer --registry https://cn.longxiaskill.com

技能文档

依赖项

必需二进制: mmx(MiniMax AI CLI)

⚠️ 安全声明: 本 Skill 依赖 mmx CLI(MiniMax AI 音乐生成工具)。执行任何生成命令前,必须先验证 mmx 可用且来源可信

安装 mmx

# macOS / Linux
npm install -g @aivcore/mmx-cli
# 或通过官方渠道安装(请勿从未知来源安装)
# 访问 https://www.minimax.io 确认官方渠道

前置检查(必须执行)

在运行任何 mmx music generate 命令之前,必须执行以下检查:

# 1. 检查 mmx 是否存在
which mmx || { echo "错误:mmx 未安装,请先运行: npm install -g @aivcore/mmx-cli"; exit 1; }

# 2. 验证 mmx 版本(确认为 MiniMax 官方 CLI,非仿冒) mmx --version # 预期输出包含 "mmx" 和版本号,如 "mmx/1.x.x" # 若输出异常(不包含 mmx 关键字,或行为不符),立即停止并报告

风险提示:mmx 命令不存在、或 mmx --version 输出不包含 mmx 关键字,不要执行任何生成命令,告知用户安装缺失的依赖。


核心原则

用户说"帮我写首歌" → 先规划,再生成。

规划流程:曲风 → 情绪/主题 → 节奏速度 → 乐器编配(重点:过渡与层次)→ 人声特色(如有)→ 生成 Prompt

核心品质要求(本次升级重点):

  • 乐器过渡自然:避免生硬切入,用渐进引入、渐隐淡出
  • 层次感丰富:前景/中景/背景三层分离,不混在一起
  • 活人感:有呼吸感、轻微不完美、自然律动,模拟真实乐手演奏
  • 感情细腻:情感起伏贴合歌词,不flatline

标准生成命令

⚠️ 执行前提: 完成上方「前置检查」,确认 mmx 可用且版本正常。
# 纯器乐
mmx music generate \
  --model music-2.6 \
  --prompt "<英文 Prompt>" \
  --instrumental \
  --out ~/video/.mp3

# 带歌词歌曲 mmx music generate \ --model music-2.6 \ --prompt "<英文 Prompt>" \ --lyrics "<歌词>" \ --out ~/video/.mp3

# 翻唱 mmx music cover \ --prompt "<目标风格描述>" \ --audio-file /path/to/reference.mp3 \ --out ~/video/.mp3


规划流程(详细版)

Step 1:确认用户需求

至少确认:

维度问题示例
类型纯音乐还是带人声?instrumental / 中文歌 / 英文歌
曲风什么音乐风格?Jazz, Lo-Fi, Cinematic...
情绪什么情感氛围?温暖治愈 / 忧伤 / 活力...
场景用在什么场景?咖啡馆 / 视频bgm / 睡前...
人声(如有)想要什么音色?磁性男声 / 清亮女声...

Step 2:组合 Prompt(含活人感关键词)

Prompt 核心公式:

[情绪] + [曲风] + [层次描述] + [过渡描述] + [活人感关键词] + [场景/用途]

必须包含的质感关键词:

  • organic — 有机感、真实乐器
  • human feel / breathable — 活人感、呼吸感
  • natural dynamics — 自然动态,不呆板
  • smooth instrument transitions — 乐器间平滑过渡
  • layered arrangement — 分层编曲
  • subtle imperfection — 轻微不完美(太完美反而假)
  • slight swing / groove — 轻微摇摆感
  • room ambience — 空间残响,录音棚感
  • tender emotional depth — 细腻情感
  • swell and release — 起伏与释放

Step 3:歌词结构(如需)

参考 references/lyrics-structures.md

Step 4:生成并记录

  • 文件名:{序号}_{风格}_{主题}.mp3
  • 完成后汇报文件名

快速推荐(预设 Prompt)

场景推荐 Prompt 关键词
咖啡馆warm jazz, upright bass, smooth piano, coffee shop ambience, human feel, natural dynamics, breathable
电影感cinematic orchestra, layered strings, brass swell, smooth transitions, tender emotional depth, room ambience
夜晚独处ambient piano, reverb, intimate, slight pedal noise, organic, tender
活力运动upbeat indie rock, real drums, electric guitar, layered, groove, natural energy
失眠放松ambient soundscape, soft pad, slow breathing rhythm, human feel, dreamlike

关联文件

  • references/music-genres.md — 曲风/乐器/节奏/人声完整参数库
  • references/lyrics-structures.md — 歌词结构模板库
数据来源ClawHub ↗ · 中文优化:龙虾技能库