resume

アルバム制作の再開

目的：アルバムを見つけて、中断したところから作業を再開します。

使い方：

/bitwize-music:resume <album-name>
/bitwize-music:resume my-album
/bitwize-music:resume "demo album"

使用するタイミング：既存のアルバムの制作を続けたいときに使用します。

---

手順

アルバム名を指定してこのスキルが呼び出された場合：

ステップ 1：MCP 経由でアルバムを検索

1. find_album(name) を呼び出します。名前、スラッグ、または部分一致であいまい検索します（大文字と小文字は区別しません）。
2. 見つからない場合：MCP が利用可能なアルバムを返します。最も近い候補、または /bitwize-music:new-album を提案します。
3. 複数見つかった場合：パスとともにすべて表示し、どれかをユーザーに尋ねます。
4. MCP がキャッシュの古さや不足を示すエラーを返した場合：rebuild_state() を呼び出してから再試行します。

ステップ 2：アルバムの進捗を取得

1. get_album_progress(album_slug) を呼び出します。ステータス別のトラック数、完了率、検出されたワークフローフェーズが返されます。
2. list_tracks(album_slug) を呼び出します。トラックごとの詳細（ステータス、has_suno_link、sources_verified）が返されます。

ステップ 3：セッションコンテキストを更新

update_session(album=album_slug, phase=detected_phase) を呼び出して、アクティブなアルバムとフェーズを設定します。

ステップ 4：現在のフェーズを判定

アルバムとトラックのステータスに基づいて、ワークフローのフェーズを特定します。

アルバムのステータス	トラックのステータス	現在のフェーズ
Concept	ほとんどが「Not Started」	計画 - アルバムの README を記入し、トラックを作成する必要があります
Research Complete	「Sources Pending」が一部ある	検証 - 出典を人手で検証する必要があります（ドキュメンタリーアルバム）
Sources Verified	すべての出典が検証済み	作詞の準備完了 - 出典の確認が完了しました。歌詞の作成を開始します（ドキュメンタリーアルバム）
In Progress	混在しており、「Not Started」が一部ある	作詞 - 歌詞を完成させる必要があります（またはインストゥルメンタルトラックを suno-engineer に引き継ぎます）
In Progress	「Sources Pending」が一部ある	検証 - 出典を人手で検証する必要があります
In Progress	すべて歌詞あり	生成の準備完了 - 「Ready to Generate」チェックポイントを実行します
In Progress	「Generated」が一部ある	生成中 - Suno での生成を続けます。生成ログを確認し、再生成が必要な却下済みトラックがないか確認します
In Progress	すべて「Generated」で、「Final」はなし	レビューと承認 - 生成されたトラックを聴き、採用するものに ✓ を付け、却下したものを再生成します
Complete	すべて「Final」	マスタリング - 音声のマスタリングを行う準備ができています
Released	すべて「Final」	リリース済み - アルバムは公開されています

注：ドキュメンタリー以外のアルバムでは、Research Complete と Sources Verified をスキップし、Concept から In Progress に直接進みます。

ステップ 5：ユーザーに報告

状況をわかりやすく報告します。

📁 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.

ステップ 6：次の最善のアクションを 1 つ提案

以下の判断ツリーから、明確な提案を 1 つ選びます。候補を 5 つ並べず、最善のものを選び、スキル名と対象のトラックを具体的に示します。

判断ツリー（上から順に確認し、最初に一致したものを採用します）：

インストゥルメンタルの判定：各トラックのフロントマターで instrumental: true を確認するか、「Track Details」テーブルで **Instrumental** | Yes を確認します。インストゥルメンタルトラックは作詞ワークフローを完全にスキップし、直接 /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"

提案の形式：

RECOMMENDED NEXT ACTION:
  [Clear, specific instruction with skill name and track name]

WHY:
  [One sentence explaining why this is the right next step]

アルバム名を指定しない場合（引数なし）

アルバム名を指定せずに呼び出された場合：

1. get_session() を呼び出し、セッションコンテキストの last_album を確認して、そのアルバムを再開します。
2. セッションコンテキストがない場合は、list_albums() を呼び出して、作業中のアルバムをすべて探します。
3. 優先順位：完成に最も近いもの > 作業がブロックされていないもの > 最後に作業したもの
4. アルバムがない場合は、/bitwize-music:new-album を提案します。

複数のアルバムを制作中の場合は、複数アルバムの概要を提示します。

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：作詞フェーズのアルバム

/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.

例 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?

例 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.

---

実装に関する注意事項

• MCP ツールを使用する - state.json を直接読み取るのではなく、find_album、get_album_progress、list_tracks、update_session を使用します
• 大文字と小文字を区別しない照合 - 「Sample-Album」は「sample-album」と一致する必要があります
• アルバムが見つからない場合は適切に対処する - 存在する項目を一覧表示し、エラーにしないでください
• 次の手順を具体的に示す - 単に「作業を続ける」と言うのではなく、具体的に何をすべきかを示してください
• フルパスを含める - ユーザーがファイルの場所を把握できるようにします
• 絵文字は控えめに使用する - レポートのセクション見出しにのみ使用します

---

モデル

Sonnet 4.5 を使用してください。これは創作作業ではなく、調整と報告のタスクです。