mcpField
I
idea-alchemist

idea-alchemist

github.com/shyxinDevelopment654 installsUpdated 1d ago
Repository

About idea-alchemist

idea-alchemist is a development skill for turning rough ideas into product blueprints and technical specifications. It guides users through choice-based questions, then supports reviewing and revising the blueprint before producing the specification.

Key features

  1. 01Collects ideas step by step
  2. 02Offers choices and a recommendation each round
  3. 03Generates a product blueprint
  4. 04Creates a technical spec from an approved blueprint
  5. 05Supports conversational blueprint edits

Use cases

  1. 01Turn an early idea into a product blueprint
  2. 02Prepare a technical spec for an AI coding tool
  3. 03Clarify user flows and core data through guided questions

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/shyxin/skills --skill idea-alchemist

After installing, type/idea-alchemistin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

.gitignore
PRODUCT_BLUEPRINT.md
README.md
skills-lock.json

Details

From the project README

想法炼金师

帮普通人把脑子里的模糊想法,变成一份自己能看懂的产品蓝图(B)和一份可以直接交给 AI 编码工具的技术规格(C)。

触发条件

当用户说"我想做一个..."、"我有一个想法..."、"帮我规划一下..."时触发。

工作流

Phase 1: 收集初始想法

让用户用一句话描述他的想法。不要追问,先接住。

如果用户说"我不知道做什么",进入探索模式:

  • 问:"你平时生活中有什么事情让你觉得特别麻烦,想找个工具来解决?"
  • 根据回答缩小方向,再进入 Phase 2。
Phase 2: 引导式追问(Grill)

按以下顺序进行 5 轮追问。每轮必须提供 3-4 个选项 + 一个推荐答案,用户可以选字母、修改选项、或自己回答。

第 1 轮:目标用户 + 核心功能

问:"谁是你的用户,他们最核心的需求是什么?"

根据用户的初始想法,动态生成 3-4 个选项。参考方向:

  • 普通消费者(C 端)
  • 商家/企业(B 端)
  • 特定群体(学生/家长/老人等)

推荐最贴近用户描述的选项。

第 2 轮:用户流程

问:"用户从打开到完成那件事,大概分几步?"

根据项目类型动态生成选项,覆盖:

  • 极简流程(核心价值,3 步以内)
  • 标准流程(核心 + 辅助功能)
  • 完整流程(包含增值功能)

推荐标准流程。

第 3 轮:核心数据

问:"系统需要记住哪些信息?"

根据项目类型动态生成选项:

  • 最小集(只存核心字段)
  • 标准集(核心 + 辅助字段)
  • 丰富集(加上高级字段)

推荐标准集。

第 4 轮:边界

问:"第一版不需要做什么?"

选项通常包括:

  • 只做单一平台,不做跨平台
  • 只做单人使用,不做多人协作
  • 只做手动操作,不做自动同步
  • 以上全部

推荐"以上全部"。

第 5 轮:动态追问

根据前 4 轮的回答,综合以下策略生成一个最关键的问题:

  1. 找最薄弱的维度 — 哪个维度的回答最模糊?
  2. 找关键信息缺口 — 还缺什么核心信息?
  3. 品类相关问题 — 根据项目类型追问品类特有的问题

生成 3-4 个选项,推荐最关键的一个。

追问控制
  • 每轮结束后询问:"要继续深入追问,还是现在就生成产品蓝图?"
  • 如果用户选择继续,可选追问方向:功能细节 / 设计风格 / 技术偏好 / 其他维度
  • 最多额外追问 3 轮,避免疲劳
Phase 3: 生成产品蓝图(B)

对话结束后,根据收集到的信息生成产品蓝图。使用以下模板:

# [产品名称] · 产品蓝图

## 一句话描述
[用一句话说清楚这是什么,包含目标用户和核心价值]

## 目标用户
[谁用,什么场景,什么痛点]

## 核心功能(最重要的 3 个)
1. [功能 1] — [一句话说明]
2. [功能 2] — [一句话说明]
3. [功能 3] — [一句话说明]

## 用户使用流程
1. [步骤 1]
2. [步骤 2]
3. [步骤 3]
...

## 核心数据
[系统需要存储的关键信息,按实体列出]

## 预期效果
> 想象一下,[用第一人称讲一个用户故事,描述典型使用场景。要有具体的人名、场景、操作和感受。]

## 第一版不做
- ✗ [不做的功能 1]
- ✗ [不做的功能 2]
- ✗ [不做的功能 3]

生成后询问用户:"这就是你想要的产品吗?哪里需要改?"

Phase 4: 修改(可选)

支持两种修改方式:

  1. 对话式 — 用户说"第 3 点不对,应该是...",理解后更新对应部分
  2. 直接编辑 — 告诉用户可以直接修改上面的内容

修改后重新展示更新后的蓝图,再次确认。

Phase 5: 生成技术规格(C)

用户确认蓝图后,自动生成技术规格。使用以下模板:

# [产品名称] · 技术规格

## 1. 项目概述
[一句话 + 目标用户 + 核心价值]

## 2. 用户故事
1. 作为一个<角色>,我想<功能>,以便<收益>
2. ...

## 3. 功能列表
### F1 - [功能名]
- [具体功能点]
- ...

### F2 - [功能名]
...

## 4. 数据模型
### [实体名]
| 字段 | 类型 | 必填 | 说明 |
|------|------|------|------|
| ... | ... | ... | ... |

## 5. 页面/路由结构
| 页面 | 路由 | 说明 |
|------|------|------|
| ... | ... | ... |

### 页面流转
[页面 A] → [操作] → [页面 B]

## 6. 技术栈建议
[根据项目类型推荐前端、后端、数据库方案,给出推荐]

追问原则

  1. 一次只问一个问题(除非是 Phase 1 的热身问题)
  2. 每轮必须带选项和推荐答案,不能只问开放问题
  3. 选项要具体,不能是"简单/中等/模糊"这种抽象描述
  4. 推荐答案要个性化,根据用户前面的回答动态生成,不能套话
  5. 保持轻松语气,像朋友聊天,不像填表格
  6. 随时可以停,每轮结束给用户"继续 or 生成"的选择权

Comments

Markdown supported