resume

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Resume Album Work

恢复专辑工作

Purpose: Find an album and resume work where you left off.
Usage:
/bitwize-music:resume <album-name>
/bitwize-music:resume my-album
/bitwize-music:resume "demo album"
When to use: When user wants to continue working on an existing album.

用途:查找专辑并从中断处继续工作。
使用方式:
/bitwize-music:resume <album-name>
/bitwize-music:resume my-album
/bitwize-music:resume "demo album"
使用时机:当用户希望继续处理现有专辑时。

Instructions

操作说明

When this skill is invoked with an album name:
当使用专辑名称调用此Skill时:

Step 1: Find the Album via MCP

步骤1:通过MCP查找专辑

  1. Call
    find_album(name)
    — fuzzy match by name, slug, or partial (case-insensitive)
  2. If not found: MCP returns available albums — suggest closest match or
    /bitwize-music:new-album
  3. If multiple matches: list all with paths, ask user which one
  4. If MCP returns stale/missing cache error: call
    rebuild_state()
    then retry
  1. 调用
    find_album(name)
    ——按名称、slug或部分内容进行模糊匹配(不区分大小写)
  2. 若未找到:MCP会返回可用专辑——建议最匹配的专辑或使用
    /bitwize-music:new-album
    创建新专辑
  3. 若找到多个匹配项:列出所有专辑及其路径,询问用户选择哪一个
  4. 若MCP返回缓存过期/缺失错误:调用
    rebuild_state()
    后重试

Step 2: Get Album Progress

步骤2:获取专辑进度

  1. Call
    get_album_progress(album_slug)
    — returns track counts by status, completion percentage, and detected workflow phase
  2. Call
    list_tracks(album_slug)
    — returns per-track details (status, has_suno_link, sources_verified)
  1. 调用
    get_album_progress(album_slug)
    ——返回按状态分类的曲目数量、完成百分比及检测到的工作流阶段
  2. 调用
    list_tracks(album_slug)
    ——返回单首曲目的详细信息(状态、是否有suno_link、来源是否已验证)

Step 3: Update Session Context

步骤3:更新会话上下文

Call
update_session(album=album_slug, phase=detected_phase)
to set the active album and phase.
调用
update_session(album=album_slug, phase=detected_phase)
设置活跃专辑及阶段。

Step 4: Determine Current Phase

步骤4:确定当前阶段

Based on album and track statuses, identify the workflow phase:
Album StatusTrack StatusesCurrent Phase
ConceptMost "Not Started"Planning - Need to fill in album README and create tracks
Research CompleteSome "Sources Pending"Verification - Need human verification of sources (documentary albums)
Sources VerifiedAll sources verifiedReady to Write - Sources cleared, begin lyrics (documentary albums)
In ProgressMixed, some "Not Started"Writing - Need to complete lyrics (or route instrumental tracks to suno-engineer)
In ProgressSome "Sources Pending"Verification - Need human verification of sources
In ProgressAll have lyricsReady to Generate - Run Ready to Generate checkpoint
In ProgressSome "Generated"Generating - Continue generating on Suno. Check Generation Logs for rejected tracks needing regeneration
In ProgressAll "Generated", none "Final"Review & Approve - Listen to generated tracks, mark keepers with ✓, regenerate rejected ones
CompleteAll "Final"Mastering - Ready to master audio
ReleasedAll "Final"Released - Album is live
Note: Non-documentary albums skip
Research Complete
and
Sources Verified
— they go directly from
Concept
In Progress
.
根据专辑和曲目状态,识别工作流阶段:
专辑状态曲目状态当前阶段
概念阶段大多数为“未开始”规划阶段 - 需要完善专辑README并创建曲目
研究完成部分为“来源待验证”验证阶段 - 需要人工验证来源(纪实类专辑)
来源已验证所有来源均已验证准备创作阶段 - 来源已审核通过,开始撰写歌词(纪实类专辑)
进行中状态混合,部分为“未开始”创作阶段 - 需要完成歌词(或将器乐曲目转交suno-engineer处理)
进行中部分为“来源待验证”验证阶段 - 需要人工验证来源
进行中所有曲目均有歌词准备生成阶段 - 运行“准备生成”检查点
进行中部分为“已生成”生成阶段 - 继续在Suno上生成曲目。查看生成日志,重新生成被驳回的曲目
进行中所有曲目“已生成”,无“最终版”审核与批准阶段 - 试听生成的曲目,标记保留的曲目为✓,重新生成不符合要求的曲目
完成所有曲目为“最终版”母带制作阶段 - 准备进行音频母带处理
已发布所有曲目为“最终版”已发布 - 专辑已上线
注意:非纪实类专辑跳过“研究完成”和“来源已验证”阶段——直接从“概念阶段”→“进行中”。

Step 5: Report to User

步骤5:向用户汇报

Present a clear status report:
📁 Album: [Album Title]
   Location: {content_root}/artists/{artist}/albums/{genre}/{album}/
   Status: [Album Status]

📊 Progress:
   - Tracks: [X completed / Y total] ([N vocal, M instrumental])
   - Not Started: X
   - In Progress: Y
   - Generated: Z
   - Final: N

📍 Current Phase: [Phase Name]

✅ What's Done:
   - [List completed items]

⏭️ Next Steps:
   1. [Specific action 1]
   2. [Specific action 2]
   3. [Specific action 3]

Ready to continue? Tell me what you'd like to work on.
呈现清晰的状态报告:
📁 专辑: [专辑标题]
   存储位置: {content_root}/artists/{artist}/albums/{genre}/{album}/
   状态: [专辑状态]

📊 进度:
   - 曲目: [已完成X首 / 共Y首] ([N首人声,M首器乐])
   - 未开始: X
   - 进行中: Y
   - 已生成: Z
   - 最终版: N

📍 当前阶段: [阶段名称]

✅ 已完成事项:
   - [列出已完成的项目]

⏭️ 后续步骤:
   1. [具体操作1]
   2. [具体操作2]
   3. [具体操作3]

是否准备继续?告诉我你想处理哪部分。

Step 6: Recommend the Single Best Next Action

步骤6:推荐最佳下一步操作

Pick ONE clear recommendation from the decision tree below. Don't list 5 options — pick the best one, include the skill name, and be specific about which track.
Decision Tree (evaluate top-to-bottom, first match wins):
Instrumental detection: Check each track's frontmatter for
instrumental: true
or Track Details table for
**Instrumental** | Yes
. Instrumental tracks skip the lyrics workflow entirely and go straight to
/bitwize-music:suno-engineer
.
Album Status = "Concept"
  → "Define the album concept. Run /bitwize-music:album-conceptualizer"

Album Status = "Research Complete"
  → Any tracks Sources Pending?
    YES → "Sources need verification. Run /bitwize-music:verify-sources [album]"
    NO  → Any "Not Started" tracks instrumental?
      YES → "Create Style Box for instrumental track [name]. Use /bitwize-music:suno-engineer"
      NO  → "Ready to write! Pick a track and use /bitwize-music:lyric-writer"

Album has tracks with "Not Started"
  → Is the first not-started track instrumental?
    YES → "Create Style Box for [track]. Use /bitwize-music:suno-engineer directly (instrumental track)"
    NO  → "Write lyrics for [first not-started track]. Use /bitwize-music:lyric-writer"

Album has tracks with "In Progress" (lyrics partially written)
  → "Finish lyrics for [first in-progress track]. Use /bitwize-music:lyric-writer"

Album has tracks with "Sources Pending"
  → "Verify sources for [track]. Run /bitwize-music:verify-sources [album]"

All tracks have lyrics (or Style Box for instrumentals), none generated
  → Mixed album (vocal + instrumental)?
    YES → "All tracks ready! Run /bitwize-music:pronunciation-specialist on vocal tracks, then /bitwize-music:lyric-reviewer, then /bitwize-music:pre-generation-check to validate all gates (instrumental tracks auto-skip lyrics gates)."
    NO  → "All lyrics complete! Style prompts should be ready. Run /bitwize-music:pronunciation-specialist to check for pronunciation risks, then /bitwize-music:lyric-reviewer for final QC, then /bitwize-music:pre-generation-check to validate all gates before generating on Suno."

Some tracks generated, some not
  → Any Generated tracks without ✓ in Generation Log Rating?
    YES → "Track [name] was generated but not approved. Listen and decide:
           - Happy? Mark ✓ in Generation Log and set Status: Final
           - Not happy? Log the reason, then:
             Style issue → /bitwize-music:suno-engineer to revise Style Box
             Lyrics issue → /bitwize-music:lyric-writer to fix, then regenerate
             Bad luck → Regenerate on Suno with same settings (it's non-deterministic)"
    NO  → "Generate [first un-generated track] on Suno. Use /bitwize-music:suno-engineer"

All tracks generated, none Final
  → "All tracks generated! Listen to each track and approve:
     - Mark keepers with ✓ in Generation Log Rating column
     - Reject and regenerate any that don't meet quality standards
     - Once all have ✓, batch-approve:
       Use update_track_field(album_slug, track_slug, 'status', 'Final') for each approved track.
       Once all Final, album advances to Complete automatically."

All tracks generated, some Final
  → Any Generated (non-Final) tracks without ✓?
    YES → "Review track [name] — listen and approve (✓) or regenerate"
    NO  → "All tracks approved! Batch-approve: update_track_field(album_slug, track_slug, 'status', 'Final') for each.
           Then import audio with /bitwize-music:import-audio, then master with /bitwize-music:mastering-engineer"

All tracks Final
  → "All tracks approved! Import audio with /bitwize-music:import-audio, then master with /bitwize-music:mastering-engineer"

Album Status = "Complete"
  → "Album is complete! Release with /bitwize-music:release-director"

Album Status = "Released"
  → "This album is released! Consider /bitwize-music:promo-director for promotional content"
  → Also suggest: "Start a new album? Check /bitwize-music:album-ideas list"
Format the recommendation as:
RECOMMENDED NEXT ACTION:
  [Clear, specific instruction with skill name and track name]

WHY:
  [One sentence explaining why this is the right next step]
从以下决策树中选择一个清晰的建议。不要列出多个选项——选择最优项,包含Skill名称,并明确指定曲目。
决策树(从上到下评估,匹配到第一个即生效):
器乐检测:检查每首曲目的前置信息是否有
instrumental: true
,或曲目详情表中是否标记
**Instrumental** | Yes
。器乐曲目完全跳过歌词工作流,直接进入
/bitwize-music:suno-engineer
处理。
专辑状态 = "概念阶段"
  → "定义专辑概念。运行/bitwize-music:album-conceptualizer"

专辑状态 = "研究完成"
  → 是否有曲目处于“来源待验证”状态?
    是 → "来源需要验证。运行/bitwize-music:verify-sources [专辑名]"
    否 → 是否有“未开始”的器乐曲目?
      是 → "为器乐曲目[name]创建风格框。使用/bitwize-music:suno-engineer"
      否 → "准备创作!选择一首曲目并使用/bitwize-music:lyric-writer"

专辑存在“未开始”状态的曲目
  → 第一首未开始的曲目是否为器乐?
    是 → "为[曲目名]创建风格框。直接使用/bitwize-music:suno-engineer(器乐曲目)"
    否 → "为第一首未开始的曲目撰写歌词。使用/bitwize-music:lyric-writer"

专辑存在“进行中”状态的曲目(歌词部分完成)
  → "完成第一首进行中曲目的歌词。使用/bitwize-music:lyric-writer"

专辑存在“来源待验证”状态的曲目
  → "验证[曲目名]的来源。运行/bitwize-music:verify-sources [专辑名]"

所有曲目均有歌词(或器乐曲目已完成风格框),无已生成曲目
  → 是否为混合专辑(人声+器乐)?
    是 → "所有曲目准备就绪!对人声曲目运行/bitwize-music:pronunciation-specialist,然后运行/bitwize-music:lyric-reviewer,最后运行/bitwize-music:pre-generation-check验证所有关卡(器乐曲目自动跳过歌词关卡)。"
    否 → "所有歌词已完成!风格提示应已准备就绪。运行/bitwize-music:pronunciation-specialist检查发音风险,然后运行/bitwize-music:lyric-reviewer进行最终质量检查,最后运行/bitwize-music:pre-generation-check验证所有关卡,再在Suno上生成曲目。"

部分曲目已生成,部分未生成
  → 是否有已生成曲目未在生成日志评分中标记✓?
    是 → "曲目[name]已生成但未获批准。试听后决定:
           - 满意?在生成日志中标记✓并设置状态为:最终版
           - 不满意?记录原因,然后:
             风格问题 → 使用/bitwize-music:suno-engineer修改风格框
             歌词问题 → 使用/bitwize-music:lyric-writer修正,然后重新生成
             随机问题 → 使用相同设置在Suno上重新生成(生成结果非确定性)"
    否 → "在Suno上生成第一首未生成的曲目。使用/bitwize-music:suno-engineer"

所有曲目已生成,无最终版
  → "所有曲目已生成!试听每首曲目并批准:
     - 在生成日志评分栏中标记保留的曲目为✓
     - 驳回并重新生成不符合质量标准的曲目
     - 所有曲目标记✓后,批量批准:
       对每首批准的曲目使用update_track_field(album_slug, track_slug, 'status', 'Final')。
       所有曲目变为最终版后,专辑将自动进入完成状态。"

所有曲目已生成,部分为最终版
  → 是否有已生成(非最终版)曲目未标记✓?
    是 → "审核曲目[name]——试听后批准(✓)或重新生成"
    否 → "所有曲目已批准!批量批准:对每首曲目使用update_track_field(album_slug, track_slug, 'status', 'Final')。
           然后使用/bitwize-music:import-audio导入音频,再使用/bitwize-music:mastering-engineer进行母带制作"

所有曲目为最终版
  → "所有曲目已批准!使用/bitwize-music:import-audio导入音频,再使用/bitwize-music:mastering-engineer进行母带制作"

专辑状态 = "完成"
  → "专辑已完成!使用/bitwize-music:release-director发布"

专辑状态 = "已发布"
  → "此专辑已发布!考虑使用/bitwize-music:promo-director制作推广内容"
  → 同时建议:"开启新专辑?查看/bitwize-music:album-ideas列表"
建议格式如下:
推荐下一步操作:
  [清晰、具体的指令,包含Skill名称和曲目名称]

原因:
  [一句话说明为何这是正确的下一步]

When No Album Specified (No Arguments)

未指定专辑时(无参数)

If invoked without an album name:
  1. Call
    get_session()
    — check
    last_album
    from session context, resume that album
  2. If no session context, call
    list_albums()
    to find all in-progress albums
  3. Prioritize: closest to completion > unblocked work > last worked on
  4. If no albums exist, suggest
    /bitwize-music:new-album
Present a multi-album summary if multiple are in progress:
You have X albums. Here's the most actionable:

PRIORITY 1: [album-name] ([genre])
  Status: [status] | Progress: [X/Y tracks]
  → [Recommended action]

Also in progress:
  - [album-2] — [brief status]

若调用时未指定专辑名称:
  1. 调用
    get_session()
    ——检查会话上下文的
    last_album
    ,恢复该专辑
  2. 若无会话上下文,调用
    list_albums()
    查找所有进行中的专辑
  3. 优先级排序:接近完成 > 未阻塞工作 > 最近处理的专辑
  4. 若无任何专辑存在,建议使用
    /bitwize-music:new-album
    创建新专辑
若存在多个进行中的专辑,呈现多专辑摘要:
你有X张专辑。以下是最需优先处理的:

优先级1: [专辑名] ([流派])
  状态: [状态] | 进度: [X/Y首曲目]
  → [推荐操作]

其他进行中的专辑:
  - [专辑2] — [简要状态]

Examples

示例

Example 1: Album in Writing Phase

示例1:处于创作阶段的专辑

/bitwize-music:resume my-album

📁 Album: My Album
   Location: ~/bitwize-music/artists/bitwize/albums/rock/my-album/
   Status: In Progress

📊 Progress:
   - Tracks: 3 completed / 8 total
   - Not Started: 3
   - In Progress: 2
   - Final: 3

📍 Current Phase: Writing Lyrics

✅ What's Done:
   - Tracks 1-3 have final lyrics
   - Album concept and tracklist defined

⏭️ Next Steps:
   1. Complete lyrics for Track 4 (in progress)
   2. Complete lyrics for Track 5 (in progress)
   3. Write lyrics for Tracks 6-8

Ready to continue? Tell me which track you'd like to work on.
/bitwize-music:resume my-album

📁 专辑: My Album
   存储位置: ~/bitwize-music/artists/bitwize/albums/rock/my-album/
   状态: 进行中

📊 进度:
   - 曲目: 3首完成 / 共8首
   - 未开始: 3
   - 进行中: 2
   - 最终版: 3

📍 当前阶段: 歌词创作

✅ 已完成事项:
   - 曲目1-3已有最终版歌词
   - 专辑概念和曲目列表已确定

⏭️ 后续步骤:
   1. 完成曲目4的歌词(进行中)
   2. 完成曲目5的歌词(进行中)
   3. 为曲目6-8撰写歌词

是否准备继续?告诉我你想处理哪首曲目。

Example 2: Album Ready for Generation

示例2:准备生成的专辑

/bitwize-music:resume demo-album

📁 Album: Demo Album
   Location: ~/bitwize-music/artists/bitwize/albums/electronic/demo-album/
   Status: In Progress

📊 Progress:
   - Tracks: 8 / 8 total (all lyrics complete)
   - Final: 8

📍 Current Phase: Ready to Generate

✅ What's Done:
   - All 8 tracks have complete lyrics
   - All lyrics phonetically reviewed
   - Suno Style and Lyrics boxes filled

⏭️ Next Steps:
   1. Run Ready to Generate checkpoint (I'll verify everything)
   2. Start generating on Suno
   3. Log generation attempts

Shall I run the Ready to Generate checkpoint now?
/bitwize-music:resume demo-album

📁 专辑: Demo Album
   存储位置: ~/bitwize-music/artists/bitwize/albums/electronic/demo-album/
   状态: 进行中

📊 进度:
   - 曲目: 8 / 共8首(所有歌词已完成)
   - 最终版: 8

📍 当前阶段: 准备生成

✅ 已完成事项:
   - 所有8首曲目均有完整歌词
   - 所有歌词已完成语音审查
   - Suno风格和歌词框已填写

⏭️ 后续步骤:
   1. 运行“准备生成”检查点(我会验证所有内容)
   2. 开始在Suno上生成曲目
   3. 记录生成尝试

现在是否要运行“准备生成”检查点?

Example 3: Album Not Found

示例3:未找到专辑

/bitwize-music:resume my-album

❌ Album 'my-album' not found.

Available albums:
- demo-album (electronic) - In Progress
- example-tracks (hip-hop) - Complete

Did you mean one of these? Or use /bitwize-music:new-album to create a new album.

/bitwize-music:resume my-album

❌ 未找到专辑'my-album'。

可用专辑:
- demo-album (electronic) - 进行中
- example-tracks (hip-hop) - 完成

你指的是其中之一吗?或使用/bitwize-music:new-album创建新专辑。

Implementation Notes

实现说明

  • Use MCP tools -
    find_album
    ,
    get_album_progress
    ,
    list_tracks
    ,
    update_session
    instead of reading state.json directly
  • Case-insensitive matching - "Sample-Album" should match "sample-album"
  • Handle missing albums gracefully - List what exists, don't error
  • Be specific about next steps - Don't just say "continue working", say exactly what to do
  • Include full paths - User needs to know where files are located
  • Use emojis sparingly - Only for section headers in the report

  • 使用MCP工具 - 使用
    find_album
    get_album_progress
    list_tracks
    update_session
    ,而非直接读取state.json
  • 不区分大小写匹配 - "Sample-Album"应匹配"sample-album"
  • 优雅处理未找到专辑的情况 - 列出已存在的专辑,避免报错
  • 后续步骤需具体 - 不要只说“继续工作”,要明确说明具体操作
  • 包含完整路径 - 用户需要知道文件的存储位置
  • 谨慎使用表情符号 - 仅在报告的章节标题中使用

Model

模型

Use Sonnet 4.5 - This is a coordination/reporting task, not creative work.
使用Sonnet 4.5 - 这是一项协调/报告任务,而非创意工作。