mcpField
A
album-dashboard

album-dashboard

github.com/bitwize-music-studio生产力603223 次安装2 周前更新
代码仓库

关于 album-dashboard

为 bitwize-music 项目按专辑生成进度仪表板，面向跟踪音乐制作流程的人。它汇总各阶段完成度、阻塞项和建议的下一步，并通过 MCP 工具获取专辑状态。

主要功能

  1. 01按九个制作阶段汇总进度
  2. 02展示阶段完成百分比和进度条
  3. 03标出阻塞项并建议下一步

适用场景

  1. 01检查专辑制作各阶段的完成情况
  2. 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 服务获取
  1. 调用 get_album_progress(album_slug) — 返回完成统计、阶段检测结果和按状态统计的曲目数量
  2. 调用 find_album(name) — 返回专辑元数据（流派、状态、含各曲目字段的曲目列表）
  3. 调用 list_track_files(album_slug) — 返回曲目及其文件路径，以便进行其他检查

这三次调用可替代所有手动读取 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%：仅其中一个文件存在
  • 不适用：专辑并非基于来源（没有曲目包含 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%

请记住

  1. 可视化进度条 — 使用 ASCII 进度条，便于快速浏览
  2. 突出显示阻塞项 — 阻塞项是最重要的信息
  3. 包含下一步操作 — 结尾给出明确的建议
  4. 确保准确 — 仔细计数，不要估算
  5. 妥善处理缺失数据 — 如果 audio_root 不存在，母带处理进度为 0%

评论

支持 Markdown