Brainstorming 技能
在编写实现代码前,把初步想法整理为双方认可的设计。
社区 · Jesse Vincent / Prime Radiant| 作者 | Jesse Vincent / Prime Radiant |
|---|---|
| 许可证 | MIT |
| 来源 | obra/superpowers · GitHub 上的 SKILL.md |
| 项目官网 | primeradiant.com/superpowers |
| 适用于 | Claude Code · Codex、Gemini CLI、Cursor、Copilot |
| 读取源文件日期 |
brainstorming 技能先了解你想构建什么以及原因,再以现有项目为背景提出方案。小改动可在对话中确认,大项目则形成书面设计。
它将设计确认与实现分开。完整流程会加入独立开发者检查,再将已认可的设计交给 writing-plans,不会直接开始开发。
摘自该技能的 SKILL.md: brainstorming
功能
- 检查项目背景,澄清目标并比较方案。
- 展示与任务规模相称的设计并处理反馈。
- 较大项目保存已认可的设计,交给规划阶段。
产出内容
- 双方认可的设计;较大项目使用 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md。
适用场景
- 探索行为和范围尚未明确的功能。
不适用的场景
- 需求已完全确认、仅需实现的任务。
所需条件
- 能读取项目文件的编码代理。完整开发者检查需要支持子代理的环境。
- 可选可视化助手需要 Node.js 及本地浏览器服务器;普通讨论无需这些。
技能包含的文件
| 文件或文件夹 | 用途 |
|---|---|
SKILL.md | 设计探索与确认流程。 |
builder-check-prompt.md | 由全新开发者视角审阅设计。 |
visual-companion.md | 可选浏览器协作与服务器生命周期。 |
scripts/server.cjs | 本地可视化助手服务器。 |
2026-11-19 在仓库中查到的许可证:MIT。
示例提示词
安装后输入下面任意一条;在提示词中点名技能,可确保它被使用。
- 构思一个团队排班功能。先阅读现有项目,比较两种方案。
- 帮我界定一个设置小改动的范围,保持设计简洁适度。
- 将此设计交给 writing-plans 前先检查。
如何安装 brainstorming
安装与权限
安装完整 Superpowers 插件以保留规划和审阅衔接。只复制 SKILL.md 会遗漏可视化助手及开发者检查提示。
可选助手默认从发布方加载带插件版本的标志图。设置 SUPERPOWERS_DISABLE_TELEMETRY 可退出遥测;使用前请审查服务器脚本。
技能(Skill)是一个包含 SKILL.md 文件的文件夹。只需安装一次;智能体会在每次会话开始时读取它的简短描述,只有请求匹配时才加载完整说明。选择你使用的环境:
Claude Code:从插件市场安装
- 在终端中用
claude启动 Claude Code。 - 该插件位于 Anthropic 官方插件市场,Claude Code 首次启动时会自动为你添加。
- 安装插件。Claude Code 会先显示插件详情:确认它会添加哪些内容(技能、Hooks、MCP 服务器),然后选择安装给你自己、给该仓库的所有人,还是仅在该仓库中给你自己使用。
/plugin install superpowers@claude-plugins-official - 输入 / 查找
/superpowers:brainstorming,或直接提出任务。
也可以不进入会话,直接在 shell 中运行:
claude plugin install superpowers@claude-plugins-officialClaude Code:把文件夹复制到技能文件夹
把技能文件夹放到 ~/.claude/skills/,可在这台电脑的所有项目中使用;放到仓库内的 .claude/skills/,则与在该仓库工作的所有人共享(记得提交)。
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p ~/.claude/skills
cp -R superpowers/skills/brainstorming ~/.claude/skills/Claude Code 会在会话期间识别这些文件夹中新增或修改的技能。如果会话开始时技能文件夹还不存在,请运行一次 /reload-skills。然后输入 /brainstorming,或直接描述任务。
在 Windows 上,请在 Git Bash 或 WSL 中运行这些命令,或用文件资源管理器把文件夹复制到同样的位置。
Codex、Gemini CLI、Cursor 和 GitHub Copilot
这些智能体读取同样的 SKILL.md 文件夹。四者在项目中都认可的文件夹是 .agents/skills/,所以下面的命令把技能复制到那里:
git clone --depth 1 https://github.com/obra/superpowers.git
mkdir -p .agents/skills
cp -R superpowers/skills/brainstorming .agents/skills/| 智能体 | 项目文件夹 | 用户文件夹 | 说明 |
|---|---|---|---|
| OpenAI Codex | .agents/skills/ | ~/.agents/skills/ | 输入 $ 或运行 /skills 来选择技能;当任务匹配时,Codex 也会自动选用。 |
| Gemini CLI | .agents/skills/.gemini/skills/ | ~/.agents/skills/~/.gemini/skills/ | 也可以用 gemini skills install <git URL> --path <folder> --consent 从 Git 安装。2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代 Gemini CLI,面向免费层级和 Google One 用户;Antigravity 在项目中使用 .agents/skills/,个人使用 ~/.gemini/config/skills/。 |
| Cursor | .agents/skills/.cursor/skills/ | ~/.agents/skills/~/.cursor/skills/ | 在 Agent 聊天中输入 / 选择技能。Cursor 也会读取 Claude Code 的 .claude/skills/ 文件夹。 |
| GitHub Copilot | .github/skills/.agents/skills/.claude/skills/ | ~/.copilot/skills/~/.agents/skills/ | 适用于 Copilot CLI、云端智能体,以及 VS Code、Visual Studio 和 JetBrains 中的智能体模式(IDE 支持取决于版本)。也可以运行 gh skill install OWNER/REPOSITORY SKILL(公开预览版,需 GitHub CLI 2.90.0 或更高版本)。 |
这些步骤的来源
已于 2026-11-14 对照各厂商的文档核实:
先有设计,再列任务
在调整成本仍低时比较方案。设计应充分说明行为、约束及范围,让其他开发者据此规划。
认可仅针对所展示的设计,不授权无关实现或发布。
关于 brainstorming 的常见问题
brainstorming 会实现功能吗?
产出是已认可的设计,规划和实现属于后续独立阶段。
每个想法都必须生成长文档吗?
不必。来源明确区分小改动和需要书面设计的项目。
必须使用可视化助手吗?
不必。它是可选功能,需要本地服务器,并有已说明的遥测退出方式。
会自动提交文件吗?
上游流程包括保存和提交设计文档,但提交仍受项目权限及明确指示约束。
更多 AI 技能
相关技能
Writing Plans 技能
社区 · Jesse Vincent / Prime Radiant把已认可的设计转成可审阅的工程任务,明确接口与验证方式。Subagent-Driven Development 技能
社区 · Jesse Vincent / Prime Radiant通过全新执行者、限定范围的审阅及任务记录执行已认可计划。planning-with-files 技能
社区 · OthmanAdi把长期任务计划及进度留在项目文件中,钩子能力依宿主而定。To-Spec 技能
社区 · Matt Pocock把已认可决定整理成项目规格,并发布到配置的任务系统。To-Tickets 技能
社区 · Matt Pocock把规格拆成可演示的纵向切片,并明确阻塞依赖。n8n 自托管技能
社区 · Romuald Członkowski用 Docker 部署和维护 n8n,配置 Caddy HTTPS、私有服务并验证备份。