用途:校验一张专辑是否具备全部必需文件且位置正确,在发布前或用户想检查专辑结构健康度时使用。输入为专辑名(如 sample-album)。
主要能力:按类别执行检查——配置(配置文件是否存在、content_root、audio_root、artist 是否定义)、专辑结构(专辑目录、README.md、tracks/ 目录、曲目文件数量;纪录片型专辑还检查 RESEARCH.md 与 SOURCES.md)、音频文件(音频目录是否位于正确路径 {audio_root}/artists/{artist}/albums/{genre}/{album}/,是否误放在 {audio_root}/{album} 等错误位置,WAV 文件、mastered/ 目录)、专辑封面、以及每首曲目文件(Status 字段、Suno Style Box、Suno Lyrics Box;Status 为 Generated 或 Final 时需有 Suno Link;纪录片型检查 Sources Verified;并比对 frontmatter instrumental 字段与 Track Details 表中 Instrumental 行是否一致)。
使用方式:优先调用 MCP 工具 get_config()、find_album()、validate_album_structure(),后者一次性完成目录结构、必需文件、音频放置与曲目内容检查并返回 {passed, failed, warnings, skipped, issues[], checks[]};也可按文档手动执行各类检查。配置缺失时提示运行 /configure。结果以 PASS/FAIL/WARN/SKIP 标记并汇总数量,发现的问题会给出修复命令,例如将音频目录移动到含 artist 的正确路径:mv {audio_root}/{album}/ {audio_root}/artists/{artist}/albums/{genre}/{album}/。
适用场景:专辑发布前检查、结构健康度审查、排查文件错位与缺失内容。
限制:资料未提供该技能的安装步骤、收费、平台支持或实际效果说明;部分检查在无音频或未母带处理时返回 SKIP 而非失败。