promote-idea

タスク

入力：$ARGUMENTS

IDEAS.md の Pending アイデアを、1回の呼び出しで完全なアルバムプロジェクトに変換します。手動の3ステップのワークフロー（get_ideas → new-album → update_idea）を単一のエントリーポイントに置き換えます。

---

アイデアの昇格スキル

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

想定される形式：

• "<idea title>" — タイトルからスラッグを自動生成します
• "<idea title>" <album-slug> — 自動生成されたスラッグを上書きします
• "<idea title>" documentary — 標準スラッグを使用し、documentary フラグをオンにします
• "<idea title>" <album-slug> documentary — 明示的なスラッグと documentary を指定します

例：

• "Kleine Welt" → スラッグは kleine-welt に自動生成されます
• "The Great Molasses Flood" molasses-flood documentary
• "Ängstliche Kätzchen" → スラッグは angstliche-katzchen になります（ダイアクリティカルマークを除去）

引数が指定されていない場合、またはタイトルが空の場合は、最初に利用可能な Pending アイデアの一覧を表示し、どのアイデアを昇格するか尋ねます：

Which idea should I promote?

Pending ideas:
1. Kleine Welt (electronic, Thematic)
2. The Great Molasses Flood (folk, Documentary)
3. Linux Kernel Wars (electronic, Character Study)

Reply with the exact title.

get_ideas(status_filter="Pending") を使用して一覧を取得します。

ステップ2：生成されたスラッグを確認する

get_ideas(status_filter="Pending")（または search(query=idea_title, scope="ideas")）を呼び出し、アイデアが存在することを確認して、これから行う処理をユーザーに示します。

表示用にのみローカルでスラッグを計算します（小文字化し、ダイアクリティカルマークを除去し、英数字以外をハイフンに変換）。結果が不自然に見える場合は、上書きを提案します：

About to promote:
  Idea:  Kleine Welt
  Slug:  kleine-welt
  Genre: electronic
  Type:  Thematic

Proceed? (Or supply a different slug.)

ユーザーが明示的なスラッグをすでに指定している場合は、確認の手順を省略します。これは、ユーザーがすでに検討済みであることを示しています。

ステップ3：Documentary フラグについて尋ねる（未指定の場合）

documentary フラグは、RESEARCH.md と SOURCES.md を作成するかどうかを決めます。この情報はアイデアのメタデータから推測できません。アイデアの「Type」フィールドに「Documentary」と記載されていても、それは別の概念（物語の形式）です。1回だけ尋ねます：

これはドキュメンタリー／実話のアルバムですか？（リサーチとソースのテンプレートを追加します。現実の出来事なら「yes」、フィクションなら「no」と回答してください。）

引数に documentary がすでに含まれている場合は、この手順を省略します。

ステップ4：MCP で昇格する

promote_idea(idea_title, album_slug=<slug or "">, documentary=<bool>) を呼び出します。

このツールは以下のすべてを実行します：

1. 状態内でアイデアを検索します（見つからない場合、またはすでに昇格済みの場合はエラーになります）
2. create_album_structure を使用してアルバムディレクトリを作成します
3. アイデアのコンセプトを新しい README.md の ## Concept セクションに挿入します
4. アイデアのステータスを Pending → In Progress に進めます
5. IDEAS.md 内のアイデアに **Promoted To**: <slug> のバックリンクを追加します

成功時、ツールは {promoted: true, slug, album_path, files, ...} を返し、失敗時は {error: ...} を返します。

ステップ5：完了を伝え、次の手順を提案する

成功した場合は、次のように報告します：

Promoted "Kleine Welt" → album "kleine-welt"

Location: ~/bitwize-music/artists/bitwize/albums/electronic/kleine-welt/
Files:    README.md, tracks/

Concept block injected into README.md from idea.
Idea status: Pending → In Progress

Next step:
  /bitwize-music:album-conceptualizer

  This walks through the 7 Planning Phases (Vision, Identity, Sonic
  Direction, Structure, Tracks, Content, Approval) to develop the concept
  you just carried over into the album.

ドキュメンタリーアルバムの場合は、次の内容を追加します：

  Research files also created: RESEARCH.md, SOURCES.md
  Don't forget human source verification before generation.

---

エラー処理

アイデアが見つからない場合：

Error: Idea "Nonexistent" not found in IDEAS.md.

Check available ideas: /bitwize-music:album-ideas list

アイデアがすでに昇格済みの場合：

Error: Idea "Already Active" is already promoted (status: In Progress).

If you want to rename or re-scaffold, use /bitwize-music:rename on the
existing album instead.

アイデアにジャンルがない場合：

Error: Idea "No Genre" has no **Genre** field in IDEAS.md.

Set the genre first: /bitwize-music:album-ideas edit "No Genre"

ジャンルが無効な場合：

Error: Invalid genre "xyz" on idea. Not in genres/.

Fix the genre in IDEAS.md, then retry.

アルバムのスラッグが重複している場合：

Error: Album "kleine-welt" already exists.

Options:
1. Supply a different slug: /bitwize-music:promote-idea "Kleine Welt" kleine-welt-2
2. Resume the existing album: /bitwize-music:resume kleine-welt

---

例

シンプルなタイトル

/bitwize-music:promote-idea "Kleine Welt"

スラッグ kleine-welt を自動生成し、documentary フラグについて尋ね、promote_idea を呼び出して結果を報告します。

明示的なスラッグの上書き

/bitwize-music:promote-idea "The Great Molasses Flood" molasses-1919

自動生成された the-great-molasses-flood ではなく、molasses-1919 を使用します。

ドキュメンタリーアルバム

/bitwize-music:promote-idea "The Great Molasses Flood" documentary

標準の README とトラックディレクトリに加えて、RESEARCH.md と SOURCES.md を作成します。

---

専用スキルが必要な理由

手動のワークフローでは、次の3つの手順を順番に実行する必要がありました。

1. get_ideas でアイデアのジャンルを確認する
2. ユーザーが考案したスラッグを使って /bitwize-music:new-album <slug> <genre> を実行する
3. update_idea("<title>", "status", "In Progress") を実行する

このスキルで解決する問題：

• コンセプトの引き継ぎ — アイデアのコンセプト文が新しいアルバムの README に自動的に統合されるようになりました（手動でのコピー＆ペーストは、これまでよく抜け落ちていました）。
• ステータス管理 — 作業を開始したアイデアが Pending のまま残らなくなりました。ステータスの変更は自動的に行われ、双方向で記録されます（Promoted To による逆リンク）。
• スラッグの生成 — スラッグを考案し直す必要はありません。発音区別符号と句読点が一貫した方法で正規化されます。
• 単一のエントリーポイント — 初心者は3つではなく、1つのコマンドを覚えればよくなります。

---

留意事項

1. Pending のみが対象 — 昇格できるのは Pending のアイデアだけです。In Progress および Complete のアイデアではエラーが返されます。
2. 一方向の操作 — 昇格するとファイルが作成され、状態が更新されます。「昇格の取り消し」はできません。やり直す必要がある場合は、/bitwize-music:rename を使うか、手動でクリーンアップしてください。
3. コンセプトは保持される — 昇格後、アイデアのコンセプトは2か所に残ります。IDEAS.md 内のアイデアのエントリー（履歴記録）と、新しいアルバムの README.md（作業用ドキュメント）です。
4. 次のステップは常に album-conceptualizer — 昇格で作成されるのはひな形だけです。実際の計画は7つの計画フェーズで行います。