suno-engineer

用途

suno-engineer 是一个面向 Suno AI 音乐生成的技术提示词工程技能，专注于为当前模型家族（v6、v6-wild、v6-mini、Custom Models）构建风格提示词、选择模型与生成设置，并优化提示。它既可以接收曲目文件，也可以接收一个概念输入，输出完整的 Suno 提示策略。

主要能力

• 读取曲目文件，检查是否为纯器乐（frontmatter 中的 instrumental: true 或 Track Details 中的 Instrumental | Yes）。
• 从曲目路径提取专辑目录，读取该目录的 README.md 获取专辑级流派/主题/风格；若缺失则仅使用曲目级上下文。
• 构建 Style Prompt 并填写 Generation Settings 表（模型、Variety、Max Mode 等）。
• 更新曲目文件的 Suno Inputs 部分。
• 对纯器乐曲目：设置 Instrumental: On，Style Box 聚焦流派、器乐、情绪、速度，Lyrics Box 仅使用结构段落标签（[Intro]、[Main Theme]、[Bridge]、[Outro]、[End]），跳过 Streaming Lyrics、Pronunciation Notes 和 Phonetic Review 部分。
• 对概念输入：设计完整的 Suno 提示策略，提供风格提示、结构标签和推荐设置。
• 支持加载用户自定义偏好覆盖（load_override("suno-preferences.md")），包括流派映射、默认设置和避免规则。

使用方式

调用时传入曲目文件或概念。技能会读取曲目文件、检查器乐属性、查找专辑上下文、构建风格提示并填写生成设置表，最后更新曲目文件的 Suno Inputs 部分。对于纯器乐曲目，该技能是入口点，会跳过 lyric-writer。

核心原则包括：

• Suno 是字面执行的，简单清晰的提示效果最好。
• 段落标签至关重要，需使用 [Intro]、[Verse]、[Chorus]、[Pre-Chorus]、[Bridge]、[Outro]、[End] 等，并默认附加表演提示（Performance Cues），如 [Verse 1 - cold regal]。
• 人声描述放在 Style Prompt 最前面。
• 检查并加载自定义 Suno 偏好覆盖。

Style Prompt 结构：[Vocal description]. [Genre/instrumentation]. [Production notes]。

Exclude Styles（负面提示）：最多 2–4 项，使用裸元素（如 drums，而非 no drums），放在 Suno 的 Exclude Styles 字段中。

Generation Settings 规则：

• Model：成品曲目用 v6；未定声音或 v6 表现弱的流派（grunge、metal、alt-country、synth-pop 等）首轮用 v6-wild；专辑一致性用 Custom: <name>；Free 账户用 v6-mini（输出不可发布）。
• Variety：当 Style Box 经过工程化时始终 Off。
• Max Mode：超过约 2:00 的曲目、任何 Cover、任何 Voice 时开启（20 积分而非 10）；短想法和草稿关闭。
• Vocal Gender：来自曲目的人声描述；Voice 或 Custom Model 提供声音时留空。
• Duration：除非曲目或专辑设置 Target Duration，否则 Auto；Custom 接受 10 秒–6:00 并硬切。
• Weirdness / Style Influence：默认 50 / 50。
• Audio Influence：仅在附加音频（Cover / Voice）时使用，Voice 约 0.70–0.85。

流派选择：越具体越好，但最多 2–3 个流派描述词。模式：[Primary genre] + [1-2 subgenre modifiers] + [1 key instrument/technique]。流派混合最多组合 3 个流派。

适用场景

• 为 Suno 曲目构建技术性风格提示词。
• 选择 Suno 模型和生成设置。
• 优化现有提示词。
• 处理纯器乐曲目（作为入口点，跳过 lyric-writer）。
• 从概念设计完整的 Suno 提示策略。
• 需要专辑级一致性的音乐项目。

限制

• Suno 的 Exclude Styles 是概率性的，不是硬过滤器，无法覆盖强烈暗示被排除元素的提示。
• 内联 no [element] 在 v6 上无效，需使用 Exclude Styles 字段。
• 歌词框中 Suno 会字面演唱所有内容，不能放入舞台指示、制作笔记或括号描述。
• 不要在 Style Box 中放入艺术家姓名，v6 会重写并显示替换提示。
• Duration Custom 硬切并会压缩不合适的歌词。
• Suno 最大 8 分钟（Auto/Extend），Duration 滑块 Custom 范围最高 6:00。
• v6-wild 上 Max Mode 未测试。
• v6-mini 输出不可发布。
• 部分功能（如 Voices、Custom Models）的具体细节在资料中未完全展开。

参考文件

技能引用 ${CLAUDE_PLUGIN_ROOT}/reference/suno/ 下的文档：best-practices.md、models.md、pronunciation-guide.md、tips-and-tricks.md、structure-tags.md、voice-tags.md、instrumental-tags.md、genre-list.md，以及 genre-practices.md。