configure

タスク

入力：$ARGUMENTS

引数に応じて振り分けます：

• setup または引数なし → 初回セットアップを対話形式で実施
• edit → 特定の設定を編集
• show → 現在の設定を表示
• validate → 設定に問題がないか確認
• reset → 設定を削除して最初からやり直す

---

プラグイン設定スキル

~/.bitwize-music/config.yaml 設定ファイルのセットアップと管理をユーザーに案内します。

設定ファイルの場所

~/.bitwize-music/config.yaml

コマンド

/configure または /configure setup

初回セットアップを対話形式で実施します。設定ファイルの作成をユーザーに案内します。

手順：

1. ~/.bitwize-music/config.yaml が存在するか確認します
2. 存在する場合は、上書きするか、代わりに編集するかを尋ねます
3. 新規作成する場合：
   • 必要に応じて ~/.bitwize-music/ ディレクトリを作成します
   • 必須設定を1つずつ対話形式で尋ねます
   • 設定ファイルを書き込みます
   • 結果を検証します

尋ねる必須設定：

1. artist.name - 「アーティスト名またはプロジェクト名を入力してください。」
2. paths.content_root - 「アルバムやプロジェクトの保存先を指定してください。（例：~/music-projects）」
3. paths.audio_root - 「マスタリング済み音声ファイルの保存先を指定してください。（例：~/music-projects/audio）」
4. paths.documents_root - 「調査資料や PDF の保存先を指定してください。（例：~/music-projects/documents）」

任意の設定： 5. artist.genres - 「主なジャンルを入力してください。（カンマ区切り、またはスキップ）」 6. urls.soundcloud - 「SoundCloud のプロフィール URL を入力してください。（またはスキップ）」

ステップ 5：オーバーライド用ディレクトリ（任意）

次のように尋ねます：

オーバーライドファイルを含むディレクトリのパスを指定できます。 ここでワークフローやスキルをカスタマイズすれば、プラグインの更新と競合せずに済みます。

作成できるオーバーライドファイル：

• CLAUDE.md（カスタムワークフローの指示）
• pronunciation-guide.md（アーティスト名、キャラクター名）
• explicit-words.md（カスタムの露骨な表現の単語リスト）

デフォルト：~/music-projects/overrides

パスを入力してください（または Enter キーを押してデフォルトを使用）：

ユーザーがパスを指定した場合：

• 設定に paths.overrides: "[user-path]" を追加します

ユーザーが Enter キーを押した場合（デフォルトを使用）：

• 設定に paths.overrides: "~/music-projects/overrides" を追加します
• ユーザーに次のように伝えます：「注：ディレクトリはまだ存在していなくてもかまいません。カスタマイズする際にオーバーライドファイルを作成してください。」

ステップ 6：アルバムアイデアファイル（任意）

次のように尋ねます：

アルバムのアイデアを記録するファイルのパスを指定できます。 ブレインストーミングや計画には、/bitwize-music:album-ideas スキルがこのファイルを管理します。

デフォルト：~/music-projects/IDEAS.md

パスを入力してください（または Enter キーを押してデフォルトを使用）：

ユーザーがパスを指定した場合：

• 設定に paths.ideas_file: "[user-path]" を追加します

ユーザーが Enter キーを押した場合（デフォルトを使用）：

• 設定に paths.ideas_file: "~/music-projects/IDEAS.md" を追加します
• ユーザーに次のように伝えます：「注：ファイルはまだ存在していなくてもかまいません。album-ideas スキルを初めて使用したときに作成されます。」

対話例：

Let's set up your bitwize-music configuration.

What's your artist/project name?
> Neon Circuits

Where should albums and projects be stored?
(This is where your album folders, lyrics, and research will live)
> ~/music-projects

Where should mastered audio files go?
> ~/music-projects/audio

Where should research documents/PDFs go?
> ~/music-projects/documents

What are your primary genres? (comma-separated, or press Enter to skip)
> electronic, synthwave

SoundCloud profile URL? (or press Enter to skip)
> https://soundcloud.com/neon-circuits

Overrides directory path? (press Enter for default: ~/music-projects/overrides)
> [Enter]

Album ideas file path? (press Enter for default: ~/music-projects/IDEAS.md)
> [Enter]

Creating config at ~/.bitwize-music/config.yaml...

✓ Configuration saved!

Your settings:
  Artist: Neon Circuits
  Content: ~/music-projects
  Audio: ~/music-projects/audio
  Documents: ~/music-projects/documents
  Genres: electronic, synthwave
  SoundCloud: https://soundcloud.com/neon-circuits
  Overrides: ~/music-projects/overrides (will be used if created)
  Ideas File: ~/music-projects/IDEAS.md (will be created when first used)

You're ready to start creating albums!

/configure edit

設定全体を作り直さずに、特定の設定を編集します。

手順：

1. 既存の設定を読み込みます
2. 現在の値を表示します
3. 変更したい内容を尋ねます
4. 該当する設定のみを更新します
5. 検証して保存します

例：

Current configuration:

  artist.name: Neon Circuits
  paths.content_root: ~/music-projects
  paths.audio_root: ~/music-projects/audio
  paths.documents_root: ~/music-projects/documents
  artist.genres: [electronic, synthwave]
  urls.soundcloud: https://soundcloud.com/neon-circuits

What would you like to change?

/configure show

現在の設定を読みやすい形式で表示します。

手順：

1. ~/.bitwize-music/config.yaml を読み込みます
2. すべての設定を整形した表で表示します
3. 不足している必須設定があれば示します

出力例：

bitwize-music Configuration
Location: ~/.bitwize-music/config.yaml

┌─────────────────────┬────────────────────────────────────┐
│ Setting             │ Value                              │
├─────────────────────┼────────────────────────────────────┤
│ artist.name         │ Neon Circuits                      │
│ artist.genres       │ electronic, synthwave              │
│ paths.content_root  │ ~/music-projects                   │
│ paths.audio_root    │ ~/music-projects/audio             │
│ paths.documents_root│ ~/music-projects/documents         │
│ paths.overrides     │ ~/music-projects/overrides         │
│ paths.ideas_file    │ ~/music-projects/IDEAS.md          │
│ urls.soundcloud     │ https://soundcloud.com/neon-circuits│
│ generation.service  │ suno                               │
└─────────────────────┴────────────────────────────────────┘

✓ All required settings present

/configure validate

設定に問題がないか確認します。

確認項目：

1. 設定ファイルが存在する
2. すべての必須フィールドが設定されている
3. パスが有効である（ディレクトリが存在する、または作成可能である）
4. YAML の構文エラーがない

出力例：

Validating ~/.bitwize-music/config.yaml...

✓ Config file exists
✓ artist.name: Neon Circuits
✓ paths.content_root: ~/music-projects (exists)
✓ paths.audio_root: ~/music-projects/audio (exists)
✓ paths.documents_root: ~/music-projects/documents (will be created)
✓ paths.overrides: ~/music-projects/overrides (will be used if created)
✓ paths.ideas_file: ~/music-projects/IDEAS.md (will be created when first used)
✓ generation.service: suno

All checks passed!

問題がある場合：

Validating ~/.bitwize-music/config.yaml...

✓ Config file exists
✓ artist.name: Neon Circuits
✗ paths.content_root: not set (required)
✓ paths.audio_root: ~/music-projects/audio
✗ paths.documents_root: /invalid/path (directory doesn't exist)

2 issues found. Run /configure edit to fix.

/configure reset

設定を削除し、必要に応じて最初からやり直します。

手順：

1. 本当にリセットするかユーザーに確認します
2. 既存の設定を config.yaml.bak にバックアップします
3. ~/.bitwize-music/config.yaml を削除します
4. 今すぐセットアップを実行するか尋ねます

例：

⚠️  This will delete your configuration at ~/.bitwize-music/config.yaml

Current config will be backed up to config.yaml.bak

Are you sure you want to reset? (yes/no)

実行する場合：

✓ Backed up to ~/.bitwize-music/config.yaml.bak
✓ Deleted ~/.bitwize-music/config.yaml

Config has been reset.

Would you like to set up a new config now? (yes/no)

---

設定テンプレート

新しい設定ファイルを作成するときは、次の構造を使用します。

# bitwize-music Plugin Configuration
# Generated by /configure

artist:
  name: "{artist_name}"
  genres:
    - "{genre1}"
    - "{genre2}"

paths:
  content_root: "{content_root}"
  audio_root: "{audio_root}"
  documents_root: "{documents_root}"
  overrides: "{overrides}"
  ideas_file: "{ideas_file}"

urls:
  soundcloud: "{soundcloud_url}"

generation:
  service: suno

---

例外的なケース

設定ファイルが存在するものの、YAML が無効な場合

• 既存ファイルをバックアップします：config.yaml.bak
• 新しい設定ファイルの作成を提案します

ディレクトリが存在しない場合

• 作成を提案します：「ディレクトリ ~/music-projects が存在しません。作成しますか？」

ユーザーが相対パスを指定した場合

• 絶対パスに変換します：./projects → /Users/name/projects
• または、~ を先頭に付けます：~/projects

---

覚えておくこと

• 大文字と小文字を正確に維持します - ユーザーが「bitwize」と言った場合は、「Bitwize」ではなく「bitwize」と記述します
• 表示するパスでは、常に ~ を展開します
• 存在しないディレクトリは作成します（許可を得たうえで）
• 上書きする前に既存の設定ファイルをバックアップします
• 変更後は必ず検証します
• 親しみやすく対応し、各設定の役割を説明します