recoup-roster-add-artist — скилл для Claude Code: онбординг артиста

Что делает recoup-roster-add-artist

Скилл ведёт артиста по цепочке из восьми шагов, а состояние держит в RECOUP.md. Сначала проверяется Spotify-ссылка или ID: находится точный spotify_artist_id из 22 символов, регистрозависимый. Неоднозначные совпадения останавливают работу и ждут выбора. Дальше идёт POST /api/artists с именем, Spotify ID и organization_id — ответ 200 означает, что переиспользован существующий канонический профиль, 201 — что создан новый. Статус и ID сохраняются сразу.

Потом скилл тянет исследование через GET /api/research/lookup, читает профиль, карьеру и плейлисты, собирает каталог Spotify в releases/{slug}/RELEASE.md и releases/top-tracks.md, ищет соцсети и дописывает их через PATCH /api/artists/{id}, а в конце собирает раздел базы знаний. Все вызовы идут через доступ recoup-platform-api-access.

Ручной путь без Spotify — отдельный: только {name, organization_id} и режим manual. Он не связывает артиста по совпадению имени и не создаёт запись профессионального ростера. Если канонический запрос упал, этот путь использовать нельзя. Ещё момент: мутацию не повторяют автоматически при сетевой ошибке или 5xx — она могла пройти, поэтому сначала сверяют ростер. Для примеров из scripts/onboarding_examples.sh нужны Bash, jq и настроенный RECOUP_API_KEY или RECOUP_ACCESS_TOKEN.