# Brainstorm

> >-

- **Type:** Skill
- **Install:** `agentstack add skill-junfengran-dev-env-brainstorm`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [JunfengRan](https://agentstack.voostack.com/s/junfengran)
- **Installs:** 0
- **Category:** [Agent Skills](https://agentstack.voostack.com/c/agent-skills)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [JunfengRan](https://github.com/JunfengRan)
- **Source:** https://github.com/JunfengRan/dev-env/tree/main/skills/brainstorm
- **Website:** https://github.com/JunfengRan/dev-env

## Install

```sh
agentstack add skill-junfengran-dev-env-brainstorm
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Brainstorm（启发式，非流水线）

把模糊想法变成可评审的短设计。本 skill **不进入** `spec/research-workflow.yaml`，也不阻断 gate / reducer。

## 何时用 / 何时跳过

| 建议使用 | 可以跳过 |
|----------|----------|
| 新功能、新模块、行为变更且意图未对齐 | 用户已给出可执行 plan / US |
| 多方案取舍未定 | 单行修复、文案、显然琐碎的改动 |
| 即将写 architecture / selection 文档 | 用户明确说「直接做，别 brainstorm」 |
| deep-research 的 brief 前研究问题仍糊 | 证据目标与读者已写清 |

默认姿态：**建议 → 征求同意 → 再展开**。不要未经提示就开长篇 brainstorm。

## 融合原则（来源）

| 理念 | 来源 | 在本 skill 中的形态 |
|------|------|---------------------|
| 一次一问、多选优先 | Superpowers brainstorming | 澄清阶段默认一次一问 |
| 2–3 方案 + 推荐 | Superpowers | 探索阶段必给取舍与推荐 |
| 分段呈现设计、增量确认 | Superpowers | 按复杂度缩放段落 |
| YAGNI / 范围过大先拆 | Superpowers | 多子系统先分解再 brainstorm 第一块 |
| 现有代码优先、边界清晰 | Superpowers | 先读仓再提案；单位职责单一 |
| 方案取舍表 + metadata | write-idea-docs | 落盘时用设计文档习惯 |
| 证据意识 | deep-research / interpret-tech-notes | 涉及实现断言时标「待验证」 |
| Spec 自检 | Superpowers self-review | 落盘后扫 TBD/矛盾/歧义 |

## 轻量流程（可中途退出）

```
0. 征得同意（一句）→ 1. 扫项目上下文 → 2. 澄清（一次一问）
→ 3. 2–3 方案取舍 → 4. 短设计确认 → 5. 可选落盘 → 6. 交接下一 skill
```

任一步用户说「够了 / 直接做」→ 立即结束 brainstorm，进入实现或 research。

### Step 0：征得同意

示例：

> 这块看起来还没对齐意图/方案。要不要先快速 brainstorm（几轮澄清 + 方案对比）？也可以直接做。

### Step 1：项目上下文

- 读相关文件、docs、近期结构；跟随现有模式
- 请求过大（多个独立子系统）→ **先拆分**，再对第一块 brainstorm
- 不跑无关重构

### Step 2：澄清

- **一次一问**；能多选就多选
- 聚焦：目的、约束、成功标准、非目标
- 不要一次抛出问卷

### Step 3：方案取舍

- 给出 **2–3** 个可行路径
- 每项：要点、代价、适用场景
- **先写推荐项 + 理由**（不要假中立堆砌）

### Step 4：短设计

按复杂度缩放：琐碎几句；复杂则分节（架构 / 组件 / 数据流 / 错误与测试），每节可问「这样可以吗」。

设计时检查：

- 单元是否单一职责、接口是否清晰
- 能否在不读内部的情况下理解用途
- 是否违反 YAGNI

### Step 5：可选落盘

用户需要可追溯文档时写入：

- 产品/架构向：`docs/design/YYYY-MM-DD--brainstorm.md`（或交给 `write-idea-docs` 升格为 `*-architecture.md`）
- 研究向：把结论摘要并入 `.research//artifacts/research-brief.json` 的 scope / evidenceTargets 草稿

落盘后快速自检：无 TBD、无自相矛盾、范围可执行、歧义已拍板。

### Step 6：交接（非强制链）

| 下一意图 | 交接 |
|----------|------|
| 写实现计划 | 用户确认后进入 `.cursor/plans/` 或写作计划流程 |
| 写设计文档 | `write-idea-docs` |
| 深度研究/选型 | `deep-research`（从 brief 起；brainstorm 不占 Spec state） |
| 直接编码 | 回到 `dev-workflow` 快速路径 |

**不要**把 brainstorm 当成必须接到 writing-plans / deep-research 的硬终端态。

## 与硬流水线的边界

- **不**新增 Spec state、gate、reducer 事件
- **不**在 stop hook 里强制跑 brainstorm
- **不**因「太简单」以外的原因默认拦截所有编码（与 Superpowers HARD-GATE 不同：此处为启发式）
- Visual companion / 浏览器 mockup：**可选**；无本地 companion 服务时用 Mermaid / 文字对比即可（`draw-mermaid-diagrams`）

## 产出检查（若落盘）

见 [references/heuristic-checklist.md](references/heuristic-checklist.md)。

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [JunfengRan](https://github.com/JunfengRan)
- **Source:** [JunfengRan/dev-env](https://github.com/JunfengRan/dev-env)
- **License:** MIT
- **Homepage:** https://github.com/JunfengRan/dev-env

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-junfengran-dev-env-brainstorm
- Seller: https://agentstack.voostack.com/s/junfengran
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.