brainstorming

brainstorming Skill 多维度简评

来源：obra/superpowers 类别：工程方法 / 设计门禁

一、核心定位与价值

这是 superpowers 7 步工作流的第 1 步——也是最容易跳过的。

很多 AI 编程助手最常见的失败模式是：用户说”做个登录功能”，AI 立刻开始写代码。结果 90% 的情况下，方向是错的。

brainstorming Skill 通过苏格拉底式提问 + 强制设计门禁，在写代码之前把需求彻底澄清。

二、核心机制：Hard-Gate（硬门禁）

门禁规则

在用户批准设计之前，不得调用任何实现技能、编写任何代码、搭建任何项目或采取任何实现行动。

这是”硬”门禁，不是”软”建议。即使需求”看起来很简单”，也要走完整流程。

为什么需要？

真实场景：

• 用户说”加个支付功能”
• AI 立即开始写代码
• 写了 500 行后用户说：“我要的不是这个”
• 返工

brainstorming Skill 的做法：

• 强制 AI 在写代码前提出 5-10 个澄清问题
• 强制 AI 提供 2-3 种方案对比
• 强制 AI 分段展示设计并获取确认
• 强制 AI 把设计文档沉淀下来

三、9 步自动工作流（完整版）

根据官方 SKILL.md，brainstorming 包含 9 个步骤：

1. 探索项目上下文 — 检查文件、文档、最近提交
2. 提供视觉伴侣（如涉及视觉问题）— 独立消息
3. 逐个提出澄清问题 — 一次一个问题，了解目的/约束/成功标准
4. 提出 2-3 种方案 — 包含权衡和推荐
5. 分段展示设计 — 按复杂度分段，每段获取用户确认
6. 写设计文档 — 保存到 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并提交
7. Spec 自查 — 快速检查占位符、矛盾、模糊、范围
8. 用户审查 spec — 让用户审查 spec 文件
9. 转到实现 — 调用 writing-plans skill 创建实现计划

四、实战示例

用户输入

帮我做一个用户登录接口。

brainstorming Skill 自动执行

AI 提问 1：

这个登录接口的主要使用场景是什么？

• Web 端 SPA？
• 移动 App？
• 第三方系统？

用户回答：

Web 端 SPA，React + Next.js。

AI 提问 2：

认证方式选择哪个？

• JWT（推荐）
• Session + Cookie
• OAuth 2.0

用户回答：

JWT。

AI 提问 3：

需要支持第三方登录（Google / GitHub / 微信）吗？

用户回答：

暂时不需要，但留接口。

AI 提问 4：

密码加密用什么算法？

• bcrypt（推荐）
• argon2
• scrypt

用户回答：

bcrypt。

AI 提问 5：

JWT 有效期多久？需要 refresh token 吗？

用户回答：

access token 1 小时，refresh token 7 天。

AI 提问 6：

登录失败几次锁定账号？

用户回答：

5 次，锁定 30 分钟。

AI 输出设计：

# 用户登录接口设计文档

## 1. 概述
实现 Web 端 SPA 的用户登录认证，使用 JWT。

## 2. 技术栈
- 前端：Next.js 14
- 后端：Next.js API Routes
- 数据库：PostgreSQL
- 加密：bcrypt
- 认证：JWT（jsonwebtoken）

## 3. API 设计

### POST /api/auth/login
**请求**：
```json
{
  "email": "user@example.com",
  "password": "password123"
}

响应（成功）：

{
  "accessToken": "eyJ...",
  "refreshToken": "eyJ...",
  "user": {
    "id": "u_123",
    "email": "user@example.com",
    "name": "Test User"
  }
}

响应（失败）：

{
  "error": "INVALID_CREDENTIALS",
  "message": "邮箱或密码错误"
}

4. 安全要求

• 密码 bcrypt 加密（cost=12）
• 登录失败 5 次锁定账号 30 分钟
• access token 有效期 1 小时
• refresh token 有效期 7 天
• HTTPS only
• HttpOnly cookie 存储 refresh token

5. 测试策略

• 单元测试：密码验证、JWT 生成/解析
• 集成测试：完整登录流程
• 安全测试：SQL 注入、暴力破解

请 review 设计，确认后进入实现阶段。

---

## 五、反模式（Anti-pattern）

### ❌ "这太简单了，不需要设计"

**反驳**：在"简单"需求里跳过澄清往往更容易踩坑。即使是 todo list、单函数工具、配置变更——全部走这个过程。设计可以短（真正简单项目就几句话），但必须展示并获得批准。

### ❌ "用户说得够清楚了"

**反驳**：用户说"做个登录"，但实际可能需要 OAuth、JWT、Session、MFA、SSO 等各种组合。

### ❌ "我直接开始写，有问题再问"

**反驳**：成本对比：
- 写 100 行错误代码再修：2 小时
- 多问 3 个问题：10 分钟

---

## 六、与 superpowers 其他 Skill 的协作

brainstorming 是 superpowers 工作流的**第 1 步**：

brainstorming（设计） ↓ using-git-worktrees（隔离） ↓ writing-plans（计划） ↓ subagent-driven-development（实现） ↓ test-driven-development（TDD） ↓ requesting-code-review（审查） ↓ finishing-a-development-branch（收尾）

**所有 Skill 必须在 brainstorming 完成后才能调用**。

---

## 七、安装

```bash
# superpowers 套装安装后自动包含
/plugin install superpowers@claude-plugins-official

# 单独使用
npx skills add obra/superpowers --skill brainstorming

八、6 条实战建议

1. 不要嫌烦：每多问一个问题，节省 30 分钟返工
2. 一次一问：信息过载会让用户乱回答
3. 多方案对比：不是只给一个方案
4. 分段确认：不要一次性甩整篇设计
5. 写设计文档：沉淀团队知识资产
6. 复杂任务必须用：简单任务可酌情

九、常见 Q&A

Q: 简单任务也要 brainstorming 吗？ A: 官方建议是”所有创作型工作”都用。但 1 行 Bug 修复不用。

Q: 问多少个问题合适？ A: 5-10 个问题，覆盖核心设计决策点。

Q: 用户不耐烦怎么办？ A: 用户可以输入”直接按推荐方案做”，绕过 brainstorming。

Q: 设计文档要写到多详细？ A: 团队能据此实现即可。不需要 100% 详细。

Q: 怎么跳过？ A: 输入”skip-brainstorming”或”直接实现”。

十、总结

brainstorming Skill 是 AI 编程从”写代码”升级到”做工程” 的第一步。

核心价值：

• 强制澄清需求
• 强制多方案对比
• 强制设计文档沉淀

适用人群：

• ✅ 复杂功能开发（必用）
• ✅ 多人协作（避免误解）
• ✅ 长期项目（沉淀设计）

本文基于官方文档和公开资料整理，未经过 MagicNetWorld 实测。

参考资料

• obra/superpowers 官方仓库 — GitHub 官方仓库
• brainstorming SKILL.md 源码 — 官方 Skill 定义
• Superpowers 方法论详解 (CSDN) — 中文技术文章
• Superpowers for Claude Code: Complete Guide — 完整指南
• b-lab.team: Superpowers 深度解析 — 方法论分析