album-dashboard について
bitwize-music のアルバム制作工程を追跡するダッシュボードを作成するスキルです。MCP ツールで取得した情報から各段階の進捗と阻害要因をまとめ、次の対応を提示します。
主な機能
- 019 段階の制作進捗を追跡
- 02段階ごとの達成率と進捗バーを表示
- 03阻害要因と次の対応を提示
活用シーン
- 01アルバム制作工程の完了状況を確認
- 02リリースを妨げる作業を特定
MCP 対応
MCP サーバーのアルバム進捗、アルバム検索、トラックファイル一覧のツールで情報を取得します。
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ bitwize-music-studio/ claude-ai-music-skills --skill album-dashboardインストール後、Claude Code で/album-dashboardを入力して読み込まれたか確認します。
詳細
作業内容
入力:$ARGUMENTS(アルバム名)
指定されたアルバムの構造化された進捗ダッシュボードを生成します。
アルバムダッシュボード
アルバムの包括的な進捗レポートを生成します。ワークフローの各フェーズの完了率、ブロック要因、および構造化されたステータスの内訳を表示します。
ワークフローのフェーズ
次のフェーズの完了状況を追跡します。
| フェーズ | 完了条件 |
|---|---|
| 1. コンセプト | アルバムの README にタイトル、ジャンル、定義済みのトラックリストがある |
| 2. リサーチ | RESEARCH.md と SOURCES.md が存在する(ソースベースの場合) |
| 3. ソース検証 | ソースがあるすべてのトラックで sources_verified: Verified または N/A になっている |
| 4. 歌詞 | すべてのトラックの Lyrics Box に歌詞がある |
| 5. 発音 | 発音テーブルの項目がすべて歌詞に反映されている |
| 6. レビュー | 歌詞のレビューが完了している(重大な問題が残っていない) |
| 7. 生成 | すべてのトラックで has_suno_link: true になっている |
| 8. マスタリング | {audio_root}/artists/{artist}/albums/{genre}/{album}/ にオーディオファイルがある |
| 9. リリース | アルバムのステータスが "Released" である |
データ収集
MCP サーバーから
get_album_progress(album_slug)を呼び出します — 完了状況、フェーズの検出結果、ステータス別のトラック数を返しますfind_album(name)を呼び出します — アルバムのメタデータ(ジャンル、ステータス、トラックごとのフィールドを含むトラックリスト)を返しますlist_track_files(album_slug)を呼び出します — 追加チェック用のファイルパスを含むトラックを返します
この3つの呼び出しにより、state.json の手動読み込みやファイルの glob 検索は不要になります。
ダッシュボードの形式
ALBUM DASHBOARD
===============
[Album Title] ([genre])
Status: [status]
PROGRESS BY PHASE
─────────────────
[============================ ] 90% Concept
[============================ ] 90% Research
[======================== ] 75% Source Verification
[==================== ] 63% Lyrics Written
[================ ] 50% Pronunciation
[============ ] 38% Reviewed
[======== ] 25% Generated
[ ] 0% Mastered
[ ] 0% Released
OVERALL: ████████░░░░░░░░ 47% complete
TRACK STATUS BREAKDOWN
──────────────────────
| # | Track | Status | Suno | Sources |
|---|-------|--------|------|---------|
| 01 | Track One | Final | link | Verified |
| 02 | Track Two | In Progress | — | Pending |
| 03 | Track Three | Not Started | — | N/A |
...
BLOCKING ITEMS
──────────────
! Track 02: Sources pending verification — blocks generation
! Track 05: No style prompt — blocks generation
! Track 07: Pronunciation table not applied — blocks generation
SUMMARY
───────
Tracks: [X complete / Y total]
Blocking: [N items]
Next action: [recommendation]
フェーズ完了率の計算
コンセプトフェーズ
- 100%:アルバムの README にタイトルと、実際のトラック名(テンプレートではない)を含むトラックリストがある場合
- 50%:README は存在するが、トラックリストがテンプレートのプレースホルダーである場合
- 0%:README がない場合
リサーチフェーズ(ソースベースのアルバムのみ)
- 100%:RESEARCH.md と SOURCES.md の両方が存在し、内容がある場合
- 50%:いずれか一方だけが存在する場合
- N/A:アルバムがソースベースではない場合(sources_verified フィールドがあるトラックがない、またはすべて N/A の場合)
ソース検証フェーズ
- % = (Verified または N/A のトラック数)/ 全トラック数 * 100
- 分母の計算では、sources_verified が N/A のトラックを除外します
歌詞フェーズ
- % = (歌詞の内容があるトラック数)/ 全トラック数 * 100
生成フェーズ
- % = (has_suno_link=true のトラック数)/ 全トラック数 * 100
マスタリングフェーズ
{audio_root}/artists/{artist}/albums/{genre}/{album}/内の WAV/FLAC ファイルを確認します- % = (見つかったオーディオファイル数)/ 全トラック数 * 100
リリースフェーズ
- アルバムのステータスが "Released" の場合は 100%、それ以外は 0%
注意事項
- 視覚的な進捗バー — ひと目で把握できるように ASCII の進捗バーを使います
- ブロック要因を強調 — ブロック要因は最も重要な情報です
- 次のアクションを記載 — 明確な推奨事項で締めくくります
- 正確を期す — 慎重に数え、推定しないでください
- データが不足している場合も適切に対応 — audio_root が存在しない場合、マスタリングの完了率は 0% です
コメント
Markdown 対応