用途：根据文字描述（caption）和可选歌词生成音乐，可输出纯器乐、带人声或两者兼具的完整歌曲，底层使用 ACE-Step 1.5 的 Python API。
主要能力：支持文本到音乐（text2music）；可指定风格、乐器、情绪、人声语言、时长、BPM、调性、拍号；支持批量生成多个变体、指定随机种子以复现结果、选择输出格式（flac/wav/mp3/opus/aac）；提供 draft/standard/high/max 四档音质预设，其中 high 与 max 会启用 LM 思考模式以改善结构与歌词贴合度。
使用方式：先运行 preflight.sh 与 detect_gpu.sh 做环境检查并确定音质档位，再调用 music_engine.sh。全局参数（如 --quality、--format、--seed）放在子命令 generate 之前，子命令参数（如 --caption、--duration）放在其后。示例：bash ~/.claude/skills/claude-music/scripts/music_engine.sh generate --caption "upbeat electronic dance music, energetic synths, driving beat" --instrumental --duration 60。带歌词时用 --lyrics 传入含 [Verse]、[Chorus] 等结构标签的文本。输出为 stdout 上的 JSON，包含文件路径、种子、耗时与播放提示。
适用场景：快速探索音乐创意、为视频或项目生成配乐、制作带人声的歌曲小样、按种子复现并迭代某个方向。
限制：caption 上限 512 字符，歌词上限 4096 字符，时长范围 10-600 秒，BPM 30-300，批量 1-8；max 档约需 3-5 分钟。具体安装步骤、依赖与收费信息暂未提供。