new-album

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Your Task

你的任务

Input: $ARGUMENTS

Create a new album directory structure with all required files and templates.

输入: $ARGUMENTS

创建包含所有必需文件和模板的新专辑目录结构。

New Album Skill

新专辑Skill

You create the complete album directory structure based on config.

你需要基于配置创建完整的专辑目录结构。

Step 1: Parse Arguments

步骤1：解析参数

Expected formats:

```
<album-name> <genre>
```
— standard album
```
<album-name> documentary <genre>
```
— true-story/documentary album (creates RESEARCH.md + SOURCES.md)

Examples:

```
sample-album electronic
```
```
my-new-album hip-hop
```
```
protest-songs folk
```
```
the-heist documentary hip-hop
```

Valid genres (primary categories):

```
hip-hop
```
```
electronic
```
```
rock
```
```
folk
```
```
country
```
```
pop
```
```
metal
```
```
jazz
```
```
rnb
```
```
classical
```
```
reggae
```
```
punk
```
```
indie-folk
```
```
blues
```
```
gospel
```
```
latin
```
```
k-pop
```

Parsing logic:

If 3 arguments and second is
```
documentary
```
: album = arg1, genre = arg3, documentary = true
If 2 arguments: album = arg1, genre = arg2, documentary = false
If 2 arguments and neither matches a valid genre: ask for clarification
If only 1 argument or none: ask the user

After parsing, if documentary flag was not set, ask: "Is this a documentary/true-story album? (This adds research and sources templates.)"

If arguments are missing, ask:

Usage: /new-album <album-name> <genre>
       /new-album <album-name> documentary <genre>

Example: /new-album sample-album electronic
         /new-album the-heist documentary hip-hop

Valid genres: hip-hop, electronic, rock, folk, country, pop, metal, jazz, rnb, classical, reggae, punk, indie-folk, blues, gospel, latin, k-pop

预期格式：

```
<album-name> <genre>
```
— 标准专辑
```
<album-name> documentary <genre>
```
— 纪实/真实故事类专辑（会创建RESEARCH.md + SOURCES.md）

示例：

```
sample-album electronic
```
```
my-new-album hip-hop
```
```
protest-songs folk
```
```
the-heist documentary hip-hop
```

有效流派（主分类）：

```
hip-hop
```
```
electronic
```
```
rock
```
```
folk
```
```
country
```
```
pop
```
```
metal
```
```
jazz
```
```
rnb
```
```
classical
```
```
reggae
```
```
punk
```
```
indie-folk
```
```
blues
```
```
gospel
```
```
latin
```
```
k-pop
```

解析逻辑:

若有3个参数且第二个是
```
documentary
```
：专辑名=参数1，流派=参数3，纪实标识=true
若有2个参数：专辑名=参数1，流派=参数2，纪实标识=false
若有2个参数但均不匹配有效流派：请求用户澄清
若只有1个参数或无参数：询问用户

解析完成后，若未设置纪实标识，询问： "这是一张纪实/真实故事类专辑吗？（此选项会添加研究和来源模板。）"

若参数缺失，提示：

用法: /new-album <album-name> <genre>
       /new-album <album-name> documentary <genre>

示例: /new-album sample-album electronic
         /new-album the-heist documentary hip-hop

有效流派: hip-hop, electronic, rock, folk, country, pop, metal, jazz, rnb, classical, reggae, punk, indie-folk, blues, gospel, latin, k-pop

Step 2: Create Album via MCP

步骤2：通过MCP创建专辑

Call

create_album_structure(album_slug, genre, documentary)

— creates the complete directory structure with templates in one call.

Creates content directory at

{content_root}/artists/{artist}/albums/{genre}/{album-name}/

Copies album template as README.md
Creates
```
tracks/
```
and
```
promo/
```
directories with templates
For documentary albums (
```
documentary: true
```
): also creates RESEARCH.md and SOURCES.md

Returns

{created: bool, path: str, files: [...]}

If album already exists, returns an error

Note: Audio and documents directories are NOT created (those are created when needed by import-audio/import-art).

调用

create_album_structure(album_slug, genre, documentary)

— 一键创建包含模板的完整目录结构。

在

{content_root}/artists/{artist}/albums/{genre}/{album-name}/

位置创建内容目录

复制专辑模板作为README.md
创建包含模板的
```
tracks/
```
和
```
promo/
```
目录
对于纪实类专辑（
```
documentary: true
```
）：额外创建RESEARCH.md和SOURCES.md

{created: bool, path: str, files: [...]}

若专辑已存在，返回错误

注意: 音频和文档目录不会创建（这些会在使用import-audio/import-art时按需创建）。

Step 3: Confirm

步骤3：确认

Report:

Created album: {album-name}
Location: {album_path}

Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)
- promo/ (social media copy templates)

Next steps:
  Option 1 - Interactive (Recommended):
    Run /bitwize-music:album-conceptualizer to design your album concept
    through the 7 Planning Phases.

  Option 2 - Manual:
    1. Edit README.md with your album concept
    2. Create tracks with /import-track or manually in tracks/

反馈内容：

已创建专辑: {album-name}
位置: {album_path}

已创建文件:
- README.md (专辑模板)
- tracks/ (空目录，准备好接收曲目文件)
- promo/ (社交媒体文案模板)

后续步骤:
  选项1 - 交互式（推荐）:
    运行 /bitwize-music:album-conceptualizer，通过7个规划阶段设计你的专辑概念

  选项2 - 手动操作:
    1. 编辑README.md，填入你的专辑概念
    2. 使用/import-track或手动在tracks/目录中创建曲目

Error Handling

错误处理

Config file missing:

Error: Config not found at ~/.bitwize-music/config.yaml
Run /configure to set up.

Invalid genre:

Error: Invalid genre "{genre}"

Valid genres: hip-hop, electronic, rock, folk, country, pop, metal, jazz, rnb, classical, reggae, punk, indie-folk, blues, gospel, latin, k-pop

Album already exists:

Error: Album already exists at {album_path}

Templates not found:

Error: Templates not found. Is the plugin installed correctly?
Expected at: ${CLAUDE_PLUGIN_ROOT}/templates/

配置文件缺失:

错误: 未在~/.bitwize-music/config.yaml找到配置文件
运行/configure进行设置。

无效流派:

错误: 无效流派"{genre}"

有效流派: hip-hop, electronic, rock, folk, country, pop, metal, jazz, rnb, classical, reggae, punk, indie-folk, blues, gospel, latin, k-pop

专辑已存在:

错误: 专辑已存在于{album_path}

模板未找到:

错误: 未找到模板。插件是否正确安装？
预期位置: ${CLAUDE_PLUGIN_ROOT}/templates/

Examples

示例

/new-album sample-album electronic

Config has:

yaml

paths:
  content_root: ~/bitwize-music
artist:
  name: bitwize

Result:

Created album: sample-album
Location: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/

Files created:
- README.md (album template)
- tracks/ (empty, ready for track files)

Next steps:
  Option 1 - Interactive (Recommended):
    Run /bitwize-music:album-conceptualizer to design your album concept
    through the 7 Planning Phases.

  Option 2 - Manual:
    1. Edit README.md with your album concept
    2. Create tracks with /import-track or manually in tracks/

/new-album sample-album electronic

配置文件内容：

yaml

paths:
  content_root: ~/bitwize-music
artist:
  name: bitwize

结果：

已创建专辑: sample-album
位置: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/

已创建文件:
- README.md (专辑模板)
- tracks/ (空目录，准备好接收曲目文件)

后续步骤:
  选项1 - 交互式（推荐）:
    运行 /bitwize-music:album-conceptualizer，通过7个规划阶段设计你的专辑概念

  选项2 - 手动操作:
    1. 编辑README.md，填入你的专辑概念
    2. 使用/import-track或手动在tracks/目录中创建曲目

True Story Albums

纪实类专辑

If user mentions this is a documentary or true-story album:

/new-album the-heist documentary hip-hop

The

create_album_structure(album_slug, genre, documentary=true)

call automatically creates RESEARCH.md and SOURCES.md from templates.

Report:

Created album: the-heist (documentary)
Location: ~/bitwize-music/artists/bitwize/albums/hip-hop/the-heist/

Files created:
- README.md (album template)
- RESEARCH.md (research template)
- SOURCES.md (sources template)
- tracks/ (empty, ready for track files)

若用户提及这是纪实或真实故事类专辑：

/new-album the-heist documentary hip-hop

调用

create_album_structure(album_slug, genre, documentary=true)

会自动从模板创建RESEARCH.md和SOURCES.md。

反馈内容：

已创建专辑: the-heist (纪实类)
位置: ~/bitwize-music/artists/bitwize/albums/hip-hop/the-heist/

已创建文件:
- README.md (专辑模板)
- RESEARCH.md (研究模板)
- SOURCES.md (来源模板)
- tracks/ (空目录，准备好接收曲目文件)

Common Mistakes

常见错误

❌ Don't: Create directories manually

❌ 请勿：手动创建目录

Wrong:

bash

undefined

错误做法:

bash

undefined

Manual mkdir, config reading, template copying

手动创建目录、读取配置、复制模板

cat ~/.bitwize-music/config.yaml mkdir -p ~/music-projects/artists/bitwize/albums/... cp templates/album.md ...


**Right:**

cat ~/.bitwize-music/config.yaml mkdir -p ~/music-projects/artists/bitwize/albums/... cp templates/album.md ...


**正确做法**:

Single MCP call handles everything

单次MCP调用即可处理所有操作

create_album_structure(album_slug, genre, documentary)


The MCP tool reads config, resolves paths, creates directories, and copies templates automatically.

create_album_structure(album_slug, genre, documentary)


MCP工具会自动读取配置、解析路径、创建目录并复制模板。

❌ Don't: Use wrong genre category

❌ 请勿：使用错误的流派分类

Wrong:

bash

undefined

错误做法:

bash

undefined

Using subgenre instead of primary category

使用子流派而非主分类

/new-album my-album boom-bap # boom-bap is a subgenre /new-album my-album trap # trap is a subgenre


**Right:**
```bash

/new-album my-album boom-bap # boom-bap是子流派 /new-album my-album trap # trap是子流派


**正确做法**:
```bash

Use primary genre category

使用主流派分类

/new-album my-album hip-hop # boom-bap and trap go in hip-hop /new-album my-album electronic # house, techno go in electronic


Valid primary genres: `hip-hop`, `electronic`, `rock`, `folk`, `country`, `pop`, `metal`, `jazz`, `rnb`, `classical`, `reggae`, `punk`, `indie-folk`, `blues`, `gospel`, `latin`, `k-pop`

/new-album my-album hip-hop # boom-bap和trap属于hip-hop流派 /new-album my-album electronic # house和techno属于electronic流派


有效主流派: `hip-hop`, `electronic`, `rock`, `folk`, `country`, `pop`, `metal`, `jazz`, `rnb`, `classical`, `reggae`, `punk`, `indie-folk`, `blues`, `gospel`, `latin`, `k-pop`