📚 工程方法 全难度 📦 Obra

brainstorming

苏格拉底式设计需求细化，先探索方案再写代码。

9 /10 ★★★★★
#免费#设计模式#编程#设计
📄 相关文章

📊 评分明细

📦 打包完整度
2.3 2.3 / 2.5
🎯 实用性
2.3 2.3 / 2.5
📖 文档清晰度
1.8 1.8 / 2
👥 社区影响力
1.4 1.4 / 1.5
🔗 集成度
1.4 1.4 / 1.5

🎯 适用场景

免费设计模式编程设计

brainstorming 快速入门

superpowers 套件里的”需求头脑风暴” Skill,逼着 AI 在写代码前用 Socratic 提问把需求聊透,生成设计文档。

这是什么?解决什么问题?

brainstorming 是 obra/superpowers 仓库里最常用的子 Skill 之一,也是入门 superpowers 流程的第一道门。它的核心是”Hard-Gate”设计门禁:任何新功能在动手写代码前,必须先经过 AI 抛出的 Socratic 式提问清单,需求收敛后生成设计文档,人工确认才能进入下一阶段。 对小白来说,这个 Skill 解决的是”我也不知道我想要什么,但 AI 已经动手写了”的问题。普通 AI 倾向于”接到任务立刻动手”,结果跑偏返工;装了 brainstorming,AI 会先反问 5-10 个问题——“目标用户是谁?性能要求?数据规模?异常处理策略?”——把模糊想法变成清晰需求,再决定动手。

准备工作

  • 支持 Agent:Claude Code(主推)、支持 Skills 协议的 Agent。
  • 运行环境:Claude Code 0.2+;无其他依赖。
  • 配套 Skills:建议与 using-superpowers 元 Skill、writing-plans、test-driven-development 配合使用。
  • 目标项目:任意新功能、新项目。

3 步快速上手

第 1 步:确认 Skill 已加载

ls ~/.claude/skills/superpowers/skills/brainstorming/
# 应看到 SKILL.md

第 2 步:在 Claude Code 中发起需求

claude

发起任务:

我想做一个命令行 TODO 工具。请用 superpowers 的 brainstorming Skill 先帮我厘清需求,再决定怎么做。

第 3 步:跟着 AI 的问题回答

AI 会拒绝直接动手,转而抛出 Socratic 提问清单:

  • 目标用户是开发者还是普通用户?
  • 需要支持多人协作还是单机?
  • 数据存储用 SQLite 还是 JSON 文件?
  • 优先级:P0 核心功能 vs P1 增值功能?
  • 与现有工具(taskwarrior、todo.txt)差异化在哪? 你回答完所有问题,AI 会自动生成 docs/designs/YYYY-MM-DD-todo-cli.md 设计文档,等你确认后进入 writing-plans 阶段。

常见踩坑

  1. 跳过 brainstorming 直接写代码:违反 Hard-Gate 协议,Skill 会反复要求先做需求对齐。
  2. 回答问题时偷懒:你说”随便都行”,AI 也没法继续,需求要尽量具体。
  3. 设计文档没存档:Skill 默认会写 markdown 到 docs/designs/,记得 git 跟踪,后续 code-review 有据可查。
  4. 不区分”trivial 任务”:一行 fix、文档勘误不需要 brainstorming,prompt 里说明 trivial 即可跳过。
  5. AI 提问太多:有时 AI 会问 20 个问题,这时你可以说”我目前能想到的就这些,你帮我补充剩下”。
  6. 把 brainstorming 输出当”终稿”:它只是设计起点,真到实现还要 writing-plans 拆任务。

初级用法

  • 新功能必走 brainstorm:在 CLAUDE.md 写明”任何新功能必须 brainstorming”。
  • PR 携带设计文档:把 brainstorming 输出的 markdown 链接到 PR 描述。
  • 团队设计评审:用 brainstorming 输出做团队会议讨论起点,效率提升明显。

高级玩法

  • 多轮迭代:第一轮需求对齐 → 写 design doc → 用户反馈 → 第二轮细化 → 定稿,Skill 支持多轮。
  • 与 using-superpowers 联动:元 Skill 自动调度,无需手动点名。
  • 自定义问题清单:在 SKILL.md 基础上加公司内部必须问的问题(合规、安全、隐私)。

小技巧

  • 回答时给”为什么不”的解释,AI 后续能给出更精准的方案。
  • 用 mermaid 语法画架构图,Skill 支持在设计文档中直接渲染。
  • 复杂项目可以拆成多个 brainstorming 轮次,每轮聚焦一个子模块。
  • 关注作者 blog.obra.dev 上的 brainstorming 实战案例。
  • 不要把”头脑风暴”误解为”漫无边际地聊”,它有明确的问题边界与收敛流程。

常见问题 FAQ

Q1: 这个 Skill 跟 brainstorming 有什么关系?必须装吗? A: Skill 是给 AI Agent 用的”技能包”,能告诉 Agent 怎么按特定规范工作。不是必须装——如果你的项目规模小、要求不高,不装也能用。但装上能让 Agent 输出的质量更高、更符合最佳实践,推荐装。

Q2: 这个 Skill 适合哪些 AI Agent?Cursor?Claude Code?其他? A: brainstorming 来自 Obra,主要面向支持 Skill 机制的 Agent。常见兼容 Agent 包括 Claude Code、Cursor、OpenCode、Windsurf 等。具体兼容性请查 Skill 官方文档。

Q3: 装了这个 Skill 后,会拖慢 Agent 响应吗? A: 会的——Skill 通常会增加 prompt 长度,导致响应变慢、token 消耗增加。但质量提升明显。建议:1) 只装项目必需的 Skill;2) 用 Skill 启动/加载/卸载机制按需加载;3) 定期清理不用的 Skill。

Q4: 怎么验证 Skill 装对了? A: 在 Agent 中输入”列出已加载的 Skill”或类似命令。如果 Skill 出现在列表里,说明装对了。然后用 Skill 跑一个相关任务,看输出是否符合 Skill 规范。

Q5: 这个 Skill 有许可证吗?能商用吗? A: 取决于 brainstorming 的许可证。常见许可证包括 MIT(完全自由)、Apache-2.0(自由但有专利条款)、源可用(可看不能用)、GPL(强开源)。商用前请查仓库 LICENSE 文件。

参考链接

brainstorming Skill 多维度简评

类别：工程方法 来源：obra/superpowers 定位：结构化头脑风暴，写代码前澄清需求、探索方案——Superpowers 14 步工作流的第一步。

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

一、核心定位与价值

brainstorming 是 obra/superpowers 框架的核心 Skill 之一，也是整个 Superpowers 工作流的起点。Superpowers 由 Jesse Vincent（obra）创建，是一个面向 AI 编码 Agent 的”技能框架 + 软件工程方法论”。

截至 2026 年 5 月，Superpowers 在 GitHub 上获得 177,000+ stars 和 15,700+ forks，已被 Anthropic 官方收录到 Claude Code 插件市场（安装命令：/plugin install superpowers@claude-plugins-official）。同时支持 Cursor、Codex、Gemini CLI、GitHub Copilot CLI 和 OpenCode 等六大 Agent 平台。

Superpowers 的核心理念是”先思考，再编码”——强制 Agent 在动手写代码之前，先进行需求澄清、方案对比和设计验证。brainstorming 就是这个理念的第一道关卡。

核心价值：通过 Socratic 式提问、方案 A/B/C 对比、YAGNI 原则和技术债评估，确保 Agent 在正确理解需求后才开始编码。

二、Superpowers 14 Skill 工作流

Superpowers 包含 14 个核心 Skill，按执行顺序排列：

阶段Skill作用
启动using-superpowers每个会话加载框架
设计brainstorming需求澄清、方案探索
规划writing-plans生成详细实施计划
执行executing-plans按计划逐步实施
并行subagent-driven / dispatching-parallel独立任务并行
开发TDD / test-driven测试驱动开发
调试systematic-debugging系统化排查
验证verification-before-completion提交前验证
审查requesting / receiving code-reviewPR 代码审查
收尾finishing-a-development-branch分支合并准备

硬性 Gate 原则：所有 implementation 类 Skill 之前必须先通过 brainstorming。违反此顺序意味着在错误方向上浪费时间。

三、安装与使用

# Claude Code 官方市场安装（推荐）
/plugin install superpowers@claude-plugins-official

# 或通过 npx
npx skills add obra/superpowers --skill brainstorming

# Cursor 安装
/add-plugin superpowers

安装后，当用户描述需要实现的功能时，Agent 会自动激活 brainstorming 模式，通过提问澄清需求，而非直接开始编码——这就是 Superpowers 区别于普通 Agent 的关键信号。

四、核心方法

方法说明
Socratic 提问通过层层追问澄清需求细节和边界条件
方案 A/B/C 对比为同一需求生成多种实现方案并对比优劣
YAGNI 原则严格遵循 “You Aren’t Gonna Need It”，避免过度设计
技术债评估在设计阶段评估各方案引入的技术债
决策记录（ADR）将关键设计决策记录为 Architecture Decision Record

五、使用场景

  • 新项目启动时需求不清晰
  • 有多种技术实现路径需要决策
  • 复杂功能需要先做设计评审
  • 团队希望统一”先设计后编码”的开发纪律

六、注意事项

  • Superpowers 需要 Claude Code v2.1.145 或更高版本
  • brainstorming 阶段设计文档会分块呈现，便于阅读和消化，而非一次性输出长文
  • Superpowers 采用 MIT 协议开源，可自由修改和分发

参考资料

📊 评分与标签

评分说明

总分 9.0/10 · P_优选

📊 可观测社区指标（数据核验日期：2026-07-07）

  • GitHub: obra/superpowers ★40k+
  • License: MIT · LICENSE
  • 官方描述: superpowers 套件里的”需求头脑风暴” Skill，Socratic 式提问 + Hard-Gate 设计门禁

📦 可安装性 2.5/2.5

  • npx skills add obra/superpowers 一键安装，或 git clone 后 cp -r 到技能目录，零编译零 API Key
  • 支持 Claude Code Marketplace 和 Git clone 双通道安装
  • 竞品对比 1：trailofbits/skills 需手动挑选单个 Skill，brainstorming 随 superpowers 套件一键安装
  • 竞品对比 2：anthropics/skills 通过官方 Skills API 装载，API 层门槛更高

🎯 实用性 2.5/2.5

  • 苏格拉底式需求细化：AI 在写代码前先反问 5-10 个问题（目标用户、性能要求、数据规模、异常处理策略），需求收敛后生成设计文档
  • Hard-Gate 设计门禁：任何新功能必须经过 brainstorming 才能进入 writing-plans 阶段，从机制上杜绝”AI 盲目动手”
  • 竞品对比 1：writing-plans 偏任务拆解，brainstorming 解决的是更上游的”需求是否对”问题
  • 竞品对比 2：Anthropic Skills docx/pptx 偏文档处理，brainstorming 专注工程方法论

📖 文档质量 1.5/2.0

  • Obra 官方维护，README 完善含安装和使用说明；Skill 目录附独立 SKILL.md 描述触发条件和工作流程
  • 作者博客 blog.obra.dev 定期发布 brainstorming 实战案例
  • 竞品对比 1：anthropics/skills 文档架构类似但侧重产品化教程
  • 竞品对比 2：trailofbits/skills 有安全审计博客背书，文档学术性更强

👥 社区活跃 1.5/1.5

  • GitHub ★40k+（superpowers 仓库整体），628 Commits；superpowers 生态核心 Skill 之一
  • 社区规模中等偏大，更新频率稳定，是 superpowers 入门第一道门
  • 竞品对比 1：trailofbits/skills ★6k，社区体量约为本仓库 1/7
  • 竞品对比 2：anthropics/skills ★158k，社区规模更大但偏通用

🔗 兼容性 1.0/1.5

  • MIT 许可完全自由商用；面向 Claude Code 优先的 Agent Skills 协议
  • 与其他 superpowers 子 Skill（writing-plans、systematic-debugging）无缝联动
  • 竞品对比 1：trailofbits/skills CC-BY-SA-4.0 有传染性要求，MIT 更宽松
  • 竞品对比 2：anthropics/skills Apache-2.0，专利条款对企业更友好

评分依据可追溯至公开来源，每项分数均有明确理由和数据支撑。

🏷️ 标签说明

  • 免费: MIT 开源，仓库全部内容免费获取与商用。来源：obra/superpowers
  • 设计模式: 提供 Hard-Gate 设计门禁和 Socratic 提问架构设计方法。来源：brainstorming SKILL.md
  • 编程: 以 AI 编程辅助为核心功能，在写代码前先做需求对齐。来源：superpowers 描述
  • 设计: Socratic 设计思维与方法论，面向产品/架构设计场景。来源：设计文档目录

📋 来源与核验记录