Back to Details

album-dashboard

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Your Task

你的任务

Input: $ARGUMENTS (album name)
Generate a structured progress dashboard for the specified album.
输入：$ARGUMENTS（专辑名称）
为指定专辑生成结构化的进度仪表盘。

Album Dashboard

专辑仪表盘

You generate a comprehensive progress report for an album, showing completion percentage per workflow phase, blocking items, and a structured status breakdown.
你需要生成一份全面的专辑进度报告，展示各工作流阶段的完成百分比、阻塞项以及结构化的状态细分。

Workflow Phases

工作流阶段

Track completion across these phases:
PhaseComplete When
1. ConceptAlbum README has title, genre, tracklist defined
2. ResearchRESEARCH.md and SOURCES.md exist (if source-based)
3. Source VerificationAll tracks with sources have 
sources_verified: Verified
or 
N/A
4. LyricsAll tracks have lyrics in their Lyrics Box
5. PronunciationAll pronunciation table entries applied in lyrics
6. ReviewLyrics reviewed (no critical issues remain)
7. GenerationAll tracks have 
has_suno_link: true
8. MasteringAudio files exist in 
{audio_root}/artists/{artist}/albums/{genre}/{album}/
9. ReleaseAlbum status is "Released"
跟踪以下阶段的完成情况：
阶段完成条件
1. 概念阶段专辑README文件已定义标题、流派和曲目列表
2. 调研阶段RESEARCH.md和SOURCES.md文件存在（若基于素材创作）
3. 素材验证阶段所有带素材的曲目均标记为
sources_verified: Verified
或
N/A
4. 歌词阶段所有曲目在其歌词框中包含歌词内容
5. 发音标注阶段歌词中已应用所有发音表条目
6. 审核阶段歌词已审核（无关键问题遗留）
7. 生成阶段所有曲目均标记为
has_suno_link: true
8. 母带处理阶段音频文件存在于
{audio_root}/artists/{artist}/albums/{genre}/{album}/
路径下
9. 发布阶段专辑状态为“Released”

Data Collection

数据收集

From MCP Server

从MCP Server获取

  1. Call 
    get_album_progress(album_slug)
    — returns completion stats, phase detection, track counts by status
  2. Call 
    find_album(name)
    — returns album metadata (genre, status, track list with per-track fields)
  3. Call 
    list_track_files(album_slug)
    — returns tracks with file paths for any additional checks
These three calls replace all manual state.json reads and file globbing.
  1. 调用
    get_album_progress(album_slug)
    — 返回完成统计数据、阶段检测结果、按状态划分的曲目数量
  2. 调用
    find_album(name)
    — 返回专辑元数据（流派、状态、带单轨字段的曲目列表）
  3. 调用
    list_track_files(album_slug)
    — 返回带文件路径的曲目，用于额外检查
这三个调用替代了所有手动读取state.json文件和文件匹配操作。

Dashboard Format

仪表盘格式

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]
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]

Phase Completion Calculation

阶段完成度计算

Concept Phase

概念阶段

  • 100% if: Album README has title AND tracklist with actual track names (not template)
  • 50% if: README exists but tracklist is template placeholder
  • 0% if: No README
  • 100%完成：专辑README文件包含标题且曲目列表为实际曲目名称（非模板占位符）
  • 50%完成：README文件存在但曲目列表为模板占位符
  • 0%完成：无README文件

Research Phase (source-based albums only)

调研阶段（仅基于素材的专辑）

  • 100% if: RESEARCH.md AND SOURCES.md both exist with content
  • 50% if: Only one exists
  • N/A if: Album is not source-based (no tracks have sources_verified field or all are N/A)
  • 100%完成：RESEARCH.md和SOURCES.md均存在且包含内容
  • 50%完成：仅其中一个文件存在
  • N/A：专辑非基于素材创作（无曲目包含sources_verified字段或所有字段均为N/A）

Source Verification Phase

素材验证阶段

  • % = (tracks with Verified or N/A) / total tracks * 100
  • Skip tracks where sources_verified is N/A for the denominator
  • 完成率 = (标记为Verified或N/A的曲目数) / 总曲目数 * 100
  • 分母中跳过sources_verified为N/A的曲目

Lyrics Phase

歌词阶段

  • % = (tracks with lyrics content) / total tracks * 100
  • 完成率 = (包含歌词内容的曲目数) / 总曲目数 * 100

Generation Phase

生成阶段

  • % = (tracks with has_suno_link=true) / total tracks * 100
  • 完成率 = (标记为has_suno_link=true的曲目数) / 总曲目数 * 100

Mastering Phase

母带处理阶段

  • Check 
    {audio_root}/artists/{artist}/albums/{genre}/{album}/
    for WAV/FLAC files
  • % = (audio files found) / total tracks * 100
  • 检查
    {audio_root}/artists/{artist}/albums/{genre}/{album}/
    路径下是否存在WAV/FLAC文件
  • 完成率 = (找到的音频文件数) / 总曲目数 * 100

Release Phase

发布阶段

  • 100% if album status is "Released", 0% otherwise
  • 专辑状态为“Released”则完成率100%，否则0%

Remember

注意事项

  1. Visual progress bars — Use ASCII progress bars for quick scanning
  2. Highlight blockers — Blocking items are the most important info
  3. Include next action — End with a clear recommendation
  4. Be accurate — Count carefully, don't estimate
  5. Handle missing data gracefully — If audio_root doesn't exist, mastering is 0%
  1. 可视化进度条 — 使用ASCII进度条以便快速浏览
  2. 突出显示阻塞项 — 阻塞项是最重要的信息
  3. 包含下一步操作 — 结尾给出明确建议
  4. 确保准确性 — 仔细统计，不要估算
  5. 优雅处理缺失数据 — 若audio_root不存在，母带处理阶段完成率为0%