| name | deliver-set |
| description | This skill should be used when the user asks to deliver a set, export a set, finalize a set, do a rekordbox export, sync a set to YM, or generate a cheat sheet. Covers the generated-sets bundle (MP3 + M3U8 + cheatsheet + rekordbox XML), YM playlist push and backup. |
| version | 1.1.0 |
Deliver DJ Set Workflow
Превратить готовую set_version в исполняемый пакет. Продукт доставки — папка generated-sets/<Set-Name>/: пронумерованные MP3 + playlist.m3u8 + CHEATSHEET.md + rekordbox.xml, плюс YM-плейлист и бэкап.
Steps
-
Gate on review of the chosen version
- Состав и порядок версии:
local://sets/{id}/tracks (или entity_get(entity="set_version", id=<v>, include_relations=["items"])).
local://sets/{id}/review?version=<v> — hard conflicts = стоп, чини через skill build-set.- Треки сета должны быть на L5: проверь
entity_list(entity="track_features", filters={"track_id__in": [...], "analysis_level__lt": 5}) — непустой результат = сначала download (шаг 2) + entity_update(track_features, id, {"level": 5}), затем пересобери set_version (L5 меняет ключи и picker-решения — иначе доставишь устаревший cheatsheet).
-
Ensure MP3s on disk (до любых YM-push'ей — budget общий)
entity_create(entity="audio_file", data={"track_ids": [...]}) батчами 8–10; skip = строка есть И файл на диске (v1.6.2 перекачивает stale).- На MCP-таймауте UoW откатывается (файлы на диске, строк нет):
entity_list(entity="audio_file", filters={"track_id__in": [...]}, fields=["id","track_id","file_path"]) → перевыпусти entity_create только на недостающие ids; повторяй до полного покрытия. Пути бери из этого же ответа — НЕ ls по диску.
-
Assemble the bundle (generated-sets/<Set-Name>/)
- Копируй MP3 в порядке сета с именами
NN. Artist - Title.mp3 (нумерация = позиция; этот формат обязателен для DB-матчинга rekordbox-экспортёра).
playlist.m3u8 — #EXTINF:<sec>,Artist - Title + имя файла, в порядке сета.
-
CHEATSHEET.md — исполняемый план, не голая таблица
- Источник:
local://sets/{id}/cheatsheet?version=<v> (fx_type, bars, mix_in/out points, ключи с provenance, next_transition.overall).
- Обязательный состав: шапка (set/version id, quality, длительность, BPM-диапазон, hard rejects), описание арки, таблица треков (BPM / Camelot / LUFS / mix-in / mix-out), и per-transition план в терминах djay Pro AI (Neural Mix): пресет + бары + техника исполнения + на что смотреть (pitch заранее, слабейший стык, пик).
- Пресеты движка = 7 djay Pro 5 built-ins (
NeuralMixTransition): DRUM_SWAP / DRUM_CUT / FADE / ECHO_OUT / VOCAL_SUSTAIN / VOCAL_CUT / HARMONIC_SUSTAIN — переноси как есть. FILTER_SWEEP в рантайме НЕ существует; встретил его в legacy-cheatsheet старого сета — мапь в DRUM_SWAP, filter-knob подавай как опциональный ручной приём.
-
Rekordbox XML — через боевой скрипт, не руками
set -a && . ./.env && set +a && uv run python scripts/export_folder_to_rekordbox_xml.py "generated-sets/<Set-Name>" --playlist-name "<Name>"- Успех =
tracks_enriched == tracks_exported (обогащение BPM/key/beatgrid/cues из БД матчится по имени файла NN. Artist - Title.mp3). Меньше — чини имена файлов, не игнорируй.
- Импорт: rekordbox → Preferences → Advanced → rekordbox xml → путь к файлу.
-
Push to Yandex Music (порядок — это продукт)
- Create:
provider_write(provider="yandex", entity="playlist", operation="create", params={"title": "<Set Name>"}) → возьми kind из ответа.
- Add:
provider_write(..., operation="add_tracks", params={"playlist_id": "<kind>", "track_ids": [<ym ids в порядке сета>], "at": <текущий trackCount>}) — без at YM вставляет в позицию 0 (prepend) и рушит порядок; для свежего плейлиста at=0. YM id треков — из имён скачанных файлов ([<ym_id>].mp3); таблица track_external_ids не входит в EntityRegistry — читается только через Supabase MCP/SQL.
- Верифицируй ответ:
trackCount == N, durationMs ≈ длительность сета.
-
Backup вне /tmp и вне репо
- MP3 живут в
/tmp/dj_audio/ (macOS чистит /tmp), generated-sets/ в .gitignore. Копируй бандл в ~/Music/DJ-Sets/ (и в ~/DJ_USB_BUILD/_SETS/, если идёт USB-кампания). Восстановление без бэкапа = полная перекачка под YM rate-limit.
Tips
AudioFileCreate принимает track_id | track_ids (ровно один) + опциональный source (default "yandex") — ключа persistent не существует.- Rekordbox-экспортёру нужен ffprobe (
/opt/homebrew/bin/ffprobe) и локальный asyncpg-доступ (локаль/teleport; не облако).
deliver_set_workflow prompt — канонический рецепт с conflict-гейтом, когда нужен интерактивный путь; ручной путь выше — когда собираешь бандл сам.- YM rate budget общий на токен/IP: не гоняй доставку параллельно с массовой качалкой.
