resume
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseResume 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查找专辑
- Call — fuzzy match by name, slug, or partial (case-insensitive)
find_album(name) - If not found: MCP returns available albums — suggest closest match or
/bitwize-music:new-album - If multiple matches: list all with paths, ask user which one
- If MCP returns stale/missing cache error: call then retry
rebuild_state()
- 调用——按名称、slug或部分内容进行模糊匹配(不区分大小写)
find_album(name) - 若未找到:MCP会返回可用专辑——建议最匹配的专辑或使用创建新专辑
/bitwize-music:new-album - 若找到多个匹配项:列出所有专辑及其路径,询问用户选择哪一个
- 若MCP返回缓存过期/缺失错误:调用后重试
rebuild_state()
Step 2: Get Album Progress
步骤2:获取专辑进度
- Call — returns track counts by status, completion percentage, and detected workflow phase
get_album_progress(album_slug) - Call — returns per-track details (status, has_suno_link, sources_verified)
list_tracks(album_slug)
- 调用——返回按状态分类的曲目数量、完成百分比及检测到的工作流阶段
get_album_progress(album_slug) - 调用——返回单首曲目的详细信息(状态、是否有suno_link、来源是否已验证)
list_tracks(album_slug)
Step 3: Update Session Context
步骤3:更新会话上下文
Call to set the active album and phase.
update_session(album=album_slug, phase=detected_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 Status | Track Statuses | Current Phase |
|---|---|---|
| Concept | Most "Not Started" | Planning - Need to fill in album README and create tracks |
| Research Complete | Some "Sources Pending" | Verification - Need human verification of sources (documentary albums) |
| Sources Verified | All sources verified | Ready to Write - Sources cleared, begin lyrics (documentary albums) |
| In Progress | Mixed, some "Not Started" | Writing - Need to complete lyrics (or route instrumental tracks to suno-engineer) |
| In Progress | Some "Sources Pending" | Verification - Need human verification of sources |
| In Progress | All have lyrics | Ready to Generate - Run Ready to Generate checkpoint |
| In Progress | Some "Generated" | Generating - Continue generating on Suno. Check Generation Logs for rejected tracks needing regeneration |
| In Progress | All "Generated", none "Final" | Review & Approve - Listen to generated tracks, mark keepers with ✓, regenerate rejected ones |
| Complete | All "Final" | Mastering - Ready to master audio |
| Released | All "Final" | Released - Album is live |
Note: Non-documentary albums skip and — they go directly from → .
Research CompleteSources VerifiedConceptIn 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 or Track Details table for . Instrumental tracks skip the lyrics workflow entirely and go straight to .
instrumental: true**Instrumental** | Yes/bitwize-music:suno-engineerAlbum 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:
- Call — check
get_session()from session context, resume that albumlast_album - If no session context, call to find all in-progress albums
list_albums() - Prioritize: closest to completion > unblocked work > last worked on
- 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]若调用时未指定专辑名称:
- 调用——检查会话上下文的
get_session(),恢复该专辑last_album - 若无会话上下文,调用查找所有进行中的专辑
list_albums() - 优先级排序:接近完成 > 未阻塞工作 > 最近处理的专辑
- 若无任何专辑存在,建议使用创建新专辑
/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_tracksinstead of reading state.json directlyupdate_session - 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,而非直接读取state.jsonupdate_session - 不区分大小写匹配 - "Sample-Album"应匹配"sample-album"
- 优雅处理未找到专辑的情况 - 列出已存在的专辑,避免报错
- 后续步骤需具体 - 不要只说“继续工作”,要明确说明具体操作
- 包含完整路径 - 用户需要知道文件的存储位置
- 谨慎使用表情符号 - 仅在报告的章节标题中使用
Model
模型
Use Sonnet 4.5 - This is a coordination/reporting task, not creative work.
使用Sonnet 4.5 - 这是一项协调/报告任务,而非创意工作。