promote-idea

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Your Task

你的任务

Input: $ARGUMENTS

Convert a

Pending

idea from

IDEAS.md

into a full album project in one call. Replaces the manual 3-step workflow (

get_ideas

→

new-album

→

update_idea

) with a single entry point.

输入：$ARGUMENTS

将

Pending

状态的想法从

IDEAS.md

中一键转换为完整的专辑项目。将手动三步工作流（

get_ideas

→

new-album

→

update_idea

）替换为单一入口。

Promote Idea Skill

Step 1: Parse Arguments

步骤1：解析参数

Expected formats:

```
"<idea title>"
```
— auto-derive slug from the title
```
"<idea title>" <album-slug>
```
— override the auto-derived slug
```
"<idea title>" documentary
```
— standard slug, documentary flag on
```
"<idea title>" <album-slug> documentary
```
— explicit slug + documentary

Examples:

```
"Kleine Welt"
```
→ slug auto-derived to
```
kleine-welt
```

"The Great Molasses Flood" molasses-flood documentary

"Ängstliche Kätzchen"

→ slug

angstliche-katzchen

(diacritics stripped)

If no arguments are supplied, or the title is empty, list the available pending ideas first and ask which one to promote:

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.

Use

get_ideas(status_filter="Pending")

to fetch the list.

预期格式：

```
"<idea title>"
```
— 从标题自动派生slug
```
"<idea title>" <album-slug>
```
— 覆盖自动派生的slug
```
"<idea title>" documentary
```
— 使用标准slug，开启documentary标记
```
"<idea title>" <album-slug> documentary
```
— 显式指定slug + 开启documentary标记

示例：

```
"Kleine Welt"
```
→ 自动派生slug为
```
kleine-welt
```

"The Great Molasses Flood" molasses-flood documentary

"Ängstliche Kätzchen"

→ slug为

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")

获取列表。

Step 2: Confirm the Derived Slug

步骤2：确认派生的Slug

Call

get_ideas(status_filter="Pending")

(or

search(query=idea_title, scope="ideas")

) to confirm the idea exists and show the user what's about to happen.

Compute the slug locally for display only (lowercase, strip diacritics, non-alphanumeric → hyphen). If the result looks odd, offer to override:

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

Proceed? (Or supply a different slug.)

Skip the confirmation step if the user has already provided an explicit slug — that's the signal they've already thought about it.

调用

get_ideas(status_filter="Pending")

（或

search(query=idea_title, scope="ideas")

) 确认想法存在，并向用户展示即将执行的操作。

仅在本地计算slug用于展示（转为小写，去除变音符号，非字母数字字符替换为连字符）。如果结果看起来异常，提供覆盖选项：

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

Proceed? (Or supply a different slug.)

如果用户已提供显式slug，则跳过确认步骤——这表明他们已经考虑过slug的问题。

Step 3: Ask About Documentary Flag (if not already supplied)

步骤3：询问Documentary标记（如果未提供）

The

documentary

flag decides whether

RESEARCH.md

and

SOURCES.md

are created. This is not derivable from idea metadata — the idea's "Type" field can say "Documentary" but that's a separate concept (narrative shape). Ask once:

Is this a documentary/true-story album? (Adds research + sources templates. Answer 'yes' for real-world events, 'no' for fiction.)

Skip this step if

documentary

is already in the arguments.

documentary

标记决定是否创建

RESEARCH.md

和

SOURCES.md

。这无法从想法元数据中推导——想法的"Type" 字段可能显示"Documentary"，但这是一个独立的概念（叙事形式）。询问一次：

这是纪录片/真实故事类专辑吗？（添加研究和来源模板。真实事件请回答'yes'，虚构内容请回答'no'。）

如果参数中已包含

documentary

，则跳过此步骤。

Step 4: Promote via MCP

步骤4：通过MCP执行推广

Call

promote_idea(idea_title, album_slug=<slug or "">, documentary=<bool>)

The tool performs all of:

Find the idea in state (error if missing or already promoted)
Create the album directory via
```
create_album_structure
```
Inject the idea's concept into the new
```
README.md
```
under a
```
## Concept
```
section
Advance idea status
```
Pending
```
→
```
In Progress
```
Add
```
**Promoted To**: <slug>
```
back-link to the idea in
```
IDEAS.md
```

The tool returns

{promoted: true, slug, album_path, files, ...}

on success or

{error: ...}

on failure.

调用

promote_idea(idea_title, album_slug=<slug或"">, documentary=<bool>)

。

该工具会执行以下所有操作：

在状态中查找想法（如果缺失或已推广则返回错误）
通过
```
create_album_structure
```
创建专辑目录
将想法的概念内容注入新的
```
README.md
```
的
```
## Concept
```
部分
将想法状态从
```
Pending
```
更新为
```
In Progress
```
在
```
IDEAS.md
```
的想法条目中添加
```
**Promoted To**: <slug>
```
反向链接

工具成功时返回

{promoted: true, slug, album_path, files, ...}

，失败时返回

{error: ...}

。

Step 5: Confirm and Suggest Next Step

步骤5：确认结果并建议下一步操作

On success, report:

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.

For documentary albums, add:

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

成功时，反馈：

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 Handling

错误处理

Idea not found:

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

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

Idea already promoted:

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.

Idea has no genre:

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

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

Invalid genre:

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

Fix the genre in IDEAS.md, then retry.

Duplicate album slug:

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

未找到想法：

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.

专辑slug重复：

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

Examples

示例

Simple title

简单标题

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

Auto-derives slug

kleine-welt

, asks about documentary flag, calls

promote_idea

, reports outcome.

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

自动派生slug为

kleine-welt

，询问documentary标记，调用

promote_idea

，反馈结果。

Explicit slug override

显式覆盖slug

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

Uses

molasses-1919

instead of the auto-derived

the-great-molasses-flood

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

使用

molasses-1919

而非自动派生的

the-great-molasses-flood

。

Documentary album

纪录片类专辑

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

Creates

RESEARCH.md

and

SOURCES.md

in addition to the standard README and tracks directory.

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

除标准的README和tracks目录外，还创建

RESEARCH.md

和

SOURCES.md

。

Why a Dedicated Skill

为何需要专用Skill

The manual workflow required three steps in sequence:

```
get_ideas
```
to find the idea's genre
```
/bitwize-music:new-album <slug> <genre>
```
with a slug the user invented

update_idea("<title>", "status", "In Progress")

Problems this skill solves:

Concept transfer — The idea's concept text is now merged into the new album README automatically (manual copy/paste used to be skipped often).
Status discipline — Ideas no longer linger as
```
Pending
```
after being worked on; the transition is automatic and bidirectional (
```
Promoted To
```
back-link).
Slug derivation — No more re-inventing the slug; diacritics and punctuation are normalized consistently.
Single entry point — Newcomers learn one command instead of three.

手动工作流需要依次执行三个步骤：

```
get_ideas
```
查找想法的流派
```
/bitwize-music:new-album <slug> <genre>
```
，其中slug由用户自行创建

update_idea("<title>", "status", "In Progress")

此Skill解决的问题：

概念传递 — 想法的概念文本现在会自动合并到新专辑的README中（过去手动复制粘贴经常被遗漏）。
状态规范 — 想法在开始处理后不会再停留在
```
Pending
```
状态；状态转换是自动且双向的（带有
```
Promoted To
```
反向链接）。
Slug派生 — 无需重新创建slug；变音符号和标点会被一致地标准化。
单一入口 — 新手只需学习一个命令，而非三个。

Remember

注意事项

Pending-only — Only
```
Pending
```
ideas can be promoted.
```
In Progress
```
and
```
Complete
```
ideas return an error.
One-way operation — Promotion creates files and updates state. There is no "unpromote"; use
```
/bitwize-music:rename
```
or manual cleanup if you need to redo.
Concept is preserved — The idea's concept survives in two places after promotion: the idea's entry in
```
IDEAS.md
```
(historical record) and the new album's
```
README.md
```
(working document).
Next step is always album-conceptualizer — Promotion only scaffolds; the actual planning happens in the 7 Planning Phases.

仅支持Pending状态 — 只有
```
Pending
```
状态的想法可以被推广。
```
In Progress
```
和
```
Complete
```
状态的想法会返回错误。
单向操作 — 推广会创建文件并更新状态。没有“撤销推广”功能；如果需要重做，请使用
```
/bitwize-music:rename
```
或手动清理。
概念保留 — 推广后，想法的概念会保存在两个地方：
```
IDEAS.md
```
中的想法条目（历史记录）和新专辑的
```
README.md
```
（工作文档）。
下一步始终是album-conceptualizer — 推广仅完成脚手架搭建；实际规划需在7个规划阶段中完成。