From d23086ba0c1a5875b7cef902546e0104adf17d99 Mon Sep 17 00:00:00 2001 From: OpenCode Date: Mon, 13 Jul 2026 11:50:10 +0700 Subject: [PATCH] Update README with prompt engineering guide section --- README.md | 17 ++++++++++++++--- 1 file changed, 14 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 920404d..8a62975 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ MCP сервер для [Suno API](https://sunoapi.org) — генерация AI-музыки, текстов, видео, обработка аудио прямо из opencode. -**24 инструмента**, rate limiter, proxy support, полное покрытие всех эндпоинтов. +**24 инструмента**, rate limiter, proxy support, полное покрытие эндпоинтов. Встроенный **Prompt Engineering Guide** для Suno v5/v5.5 с разметкой Lyrics/Style/Negative Prompt, золотыми правилами по жанрам и управлением вокалом. ## 🚀 Быстрый старт @@ -32,7 +32,18 @@ npm install Готовый конфиг лежит здесь: `.opencode/opencode.json`. -Перезапусти opencode. Агентам будет доступен skill `suno` с инструкцией на русском. +Перезапусти opencode. Агентам будет доступен skill `suno` с инструкцией на русском и Prompt Engineering Guide. + +## 🎹 Skill для агентов + +В комплекте идёт `.opencode/skills/suno/SKILL.md` — инструкция, по которой агенты учатся правильно формировать промпты для Suno: + +- **Три блока промпта**: Lyrics (с мета-тегами `[Verse]`, `[Chorus]`, `[Bridge]`), Style (иерархия: genre → vocal → instrumentation → recording), Negative Prompt (через запятые без `no`) +- **Золотые правила**: Disco, Latin, Blues, Brazilian Funk, Electronic, Rock, Jazz +- **Управление вокалом**: octave higher, dry vocal, no vocal intro, harmonies +- **Лимиты символов**: Style до 200 (V4) или 1000 (V4.5/V5/V5.5) +- **Пример готового промпта**: рок-трек «Восхождение» +- **Чек-лист перед отправкой** ## 🔧 Переменные окружения @@ -123,7 +134,7 @@ suno-mcp-server/ │ └── tsconfig.json ├── .opencode/ │ ├── opencode.json # Пример конфига -│ └── skills/suno/SKILL.md # Skill для агентов (русский) +│ └── skills/suno/SKILL.md # Skill для агентов + Prompt Engineering Guide └── README.md ```