Back to Details

recoup-roster-add-artist

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Recoup — Add Artist

Recoup — 添加艺术家

Bring a new artist into the box: create the account, enrich it, and scaffold their workspace. Driven by a checklist so the long chain is resumable.
将新艺术家纳入系统：创建账号、完善信息并搭建其工作区。通过清单驱动，长流程支持断点续传。

The 8-call onboarding chain (drive from the RECOUP.md checklist)

8步调用的艺人引入流程（基于RECOUP.md清单驱动）

Long chains run from prose drop steps, so drive from the 
RECOUP.md
checklist: scaffold it first (frontmatter holds captured values; body holds the unchecked steps), tick + persist after each step — the file IS the workflow state, resumable from the first unchecked box. Don't run under an 
agent+
account (data gets orphaned). The 8 calls:
  1. POST /api/artists {name, organization_id}
    → capture 
    account_id
    .
  2. GET /api/spotify/search
    → best match → 
    id
    , 
    external_urls.spotify
    , 
    images[0]
    .
  3. PATCH /api/artists/{id}
    with image + 
    profileUrls:{SPOTIFY}
    (UPPERCASE keys).
  4. Structured research (retry transient misses): 
    /research/lookup?spotifyId=
    → 
    songstats_artist_id
    , then 
    /research/profile|career|playlists
    + 
    /research/web
    .
  5. Spotify catalog (
    topTracks
    , 
    albums
    , 
    album
    ) → write 
    releases/{slug}/RELEASE.md
    per album + 
    releases/top-tracks.md
    .
  6. Web search for socials (ig/tiktok/twitter/youtube).
  7. PATCH /api/artists/{id}
    with discovered 
    profileUrls
    (only platforms found).
  8. Synthesize a 
    ## Knowledge base
    section into 
    RECOUP.md
    .
Run in order; don't continue past a 4xx/5xx without recovery. Uses recoup-platform-api-access for the call shapes.
长流程通过分步文本指令执行，因此请基于
RECOUP.md
清单驱动：先搭建清单（前置元数据存储已捕获的值；正文存储未完成的步骤），完成每一步后勾选并保存——该文件即为工作流状态，可从第一个未勾选的步骤恢复执行。请勿在
agent+
账号下运行（数据会变为孤立状态）。8步调用如下：
  1. POST /api/artists {name, organization_id}
    → 捕获
    account_id
    。
  2. GET /api/spotify/search
    → 匹配最优结果 → 获取
    id
    、
    external_urls.spotify
    、
    images[0]
    。
  3. 使用图片和
    profileUrls:{SPOTIFY}
    （键名需大写）调用
    PATCH /api/artists/{id}
    。
  4. 结构化调研（临时查询失败可重试）：调用
    /research/lookup?spotifyId=
    → 获取
    songstats_artist_id
    ，随后调用
    /research/profile|career|playlists
    + 
    /research/web
    。
  5. 获取Spotify作品目录（
    topTracks
    、
    albums
    、
    album
    ）→ 为每张专辑生成
    releases/{slug}/RELEASE.md
    文件，并创建
    releases/top-tracks.md
    文件。
  6. 网络搜索社交账号（Instagram/TikTok/Twitter/YouTube）。
  7. 使用发现的
    profileUrls
    （仅包含已找到的平台）调用
    PATCH /api/artists/{id}
    。
  8. 在
    RECOUP.md
    中生成
    ## 知识库
    章节。
请按顺序执行；遇到4xx/5xx错误未恢复前请勿继续。调用格式需遵循recoup-platform-api-access规范。

Guardrails

约束规则

  • The file is the state — tick + persist each step or a fresh turn redoes/skips work.
  • No placeholder data in artist files — real content or leave the section out.
  • Never invent a roster/artist — confirm via recoup-platform-api-access first; an empty filesystem is not an empty roster.
  • 文件即状态 — 完成每一步后需勾选并保存，否则重新执行时会重复或跳过工作。
  • 艺人文件中禁止使用占位数据 — 要么填入真实内容，要么保留该部分为空。
  • 禁止虚构艺人名单/艺人 — 需先通过recoup-platform-api-access确认；文件系统为空不代表艺人名单为空。