import-track

タスク

入力: $ARGUMENTS

設定に基づいて、トラックの Markdown ファイルを正しいアルバムの場所にインポートします。

---

トラックインポートスキル

トラックの Markdown ファイルを、ユーザーのコンテンツディレクトリ内の正しい場所に移動します。

ステップ 1: 引数を解析する

想定される形式: <file-path> <album-name> [track-number]

例:

• ~/Downloads/track.md sample-album 03
• ~/Downloads/t-day-beach.md sample-album 03
• ~/Downloads/03-t-day-beach.md sample-album（番号はすでにファイル名に含まれています）

引数が不足している場合は、次のように尋ねます:

Usage: /import-track <file-path> <album-name> [track-number]

Example: /import-track ~/Downloads/track.md sample-album 03

ステップ 2: MCP を使ってアルバムを検索し、パスを解決する

1. find_album(album_name) を呼び出します — 名前、スラッグ、または部分一致であいまい検索します。ジャンルを含むアルバムのメタデータが返されます。
2. resolve_path("tracks", album_slug) を呼び出します — トラックディレクトリのフルパスが返されます。

アルバムが見つからない場合、MCP は利用可能なアルバムを返します:

Error: Album "{album-name}" not found.

Available albums:
[list from MCP response]

Create album first with: /new-album {album-name} <genre>

ステップ 4: 移動先パスを作成する

移動先のパスは必ず次の形式です:

{content_root}/artists/{artist}/albums/{genre}/{album}/tracks/{XX}-{track-name}.md

次の例の場合:

• content_root: ~/bitwize-music
• artist: bitwize
• genre: electronic（アルバムの場所から取得）
• album: sample-album
• track-number: 03
• track-name: t-day-beach

結果:

~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/03-t-day-beach.md

トラック番号:

• トラック番号が指定されている場合は、それを使用します（ゼロ埋め: 03）。
• ファイル名にすでに番号の接頭辞（例: 03-name.md）がある場合は、そのまま保持します。
• どちらもない場合は、ユーザーにトラック番号を尋ねます。

ステップ 5: ファイルを移動する

mv "{source_file}" "{target_path}"

ステップ 6: 確認する

次の内容を報告します:

Moved: {source_file}
   To: {target_path}

エラー処理

ソースファイルが存在しない場合:

Error: File not found: {source_file}

設定ファイルが見つからない場合:

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

アルバムが見つからない場合:

Error: Album "{album-name}" not found.
Create it first with: /new-album {album-name} <genre>

トラックがすでに存在する場合:

Warning: Track already exists at destination.
Overwrite? (The original was not moved)

---

例

/import-track ~/Downloads/t-day-beach.md sample-album 03

設定の内容:

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

アルバムの場所: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/

結果:

Moved: ~/Downloads/t-day-beach.md
   To: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/03-t-day-beach.md

---

よくある間違い

❌ しないでください: 設定を手動で読み込んでアルバムを検索する

誤り:

cat ~/.bitwize-music/config.yaml
find . -name "README.md" -path "*albums/$album_name*"

正しい方法:

# Use MCP to find album and resolve path
find_album(album_name) → returns album metadata with genre
resolve_path("tracks", album_slug) → returns full tracks directory path

重要な理由: MCP は設定の読み込み、あいまい一致による検索、パスの解決を一度の呼び出しで処理します。

❌ しないでください: tracks/ サブディレクトリを忘れる

誤った移動先:

{album_path}/01-track.md
# Example: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/01-track.md

正しい移動先:

{album_path}/tracks/01-track.md
# Example: ~/bitwize-music/artists/bitwize/albums/electronic/sample-album/tracks/01-track.md

重要な理由: トラックは必ずアルバムフォルダー内の tracks/ サブディレクトリに格納します。

❌ しないでください: トラック番号の検証を省略する

誤り:

# Not validating track number format
mv track.md {album_path}/tracks/$track_num-track.md
# Could result in: 3-track.md instead of 03-track.md

正しい方法:

# Ensure zero-padding
track_num=$(printf "%02d" $track_num)
mv track.md {album_path}/tracks/$track_num-track.md
# Results in: 03-track.md

重要な理由: 正しく並べ替えるには、トラック番号をゼロ埋め（01、02、03...）する必要があります。

❌ しないでください: 検索せずにアルバムの場所を決めつける

誤り:

# Guessing album is in electronic genre
mv track.md ~/music-projects/artists/bitwize/albums/electronic/sample-album/tracks/

正しい方法:

# Use MCP to find the album (handles genre resolution)
find_album(album_name) → returns album metadata including genre and path

重要な理由: アルバムはジャンル別に整理されています。find_album がジャンルを自動的に解決します。