- name
SKILL.md
技能文件保留在发布者的仓库中。
在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add jnMetaCode/superpowers-zh --skill brainstorming -a cursor -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add jnMetaCode/superpowers-zh --skill brainstorming -a claude-code -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add jnMetaCode/superpowers-zh --skill brainstorming -a codex -y在终端中粘贴复制的命令。它会把这个 SKILL.md 安装到对应的智能体中。
npx skills add jnMetaCode/superpowers-zh --skill brainstorming -a grok -y在 Grok Bot 聊天中发送复制的消息。Bot 会从 GitHub 获取这个 SKILL.md,并添加到你所有 Bot 共享的技能中。
Install this skill: https://github.com/jnMetaCode/superpowers-zh/tree/HEAD/skills/brainstorming来自发布者
你非常擅长构建。你会去构建你认为你的人类伙伴想要的东西,而这个"认为"通常比你感觉到的要单薄。这个技能的用途,是在动手构建任何东西之前,弄清他们真正想要什么、以及为什么。
人们常常还没想清楚自己想要什么。好的问题能帮他们把它想透。当你理解了背后的原因,那上百个他们从没提过的决定,你就会按他们自己会做的方式去做。
回复之前,先问自己:关于他们想要什么、为什么想要,我知道些什么?
开始实现之前,你必须按顺序完成:
如果第一条消息时没有未决事项,而且只有一条合理路径,第 1 到第 3 步可以在这条消息里完成(见「你的第一条消息」)。
两件事不属于这里说的实现:他们同意的一次性 spike(见「用 spike 摸一摸」),以及他们明确选择跳过提问后,按请求去做。
在已有项目里,或他们已经提供了背景(规格、计划、交接材料、指定文件、之前的对话)时,在第一条消息之前先深入看。阅读他们提到的东西和相关代码或材料,继续读,直到你能解释相关部分现在怎样工作、这次改动会碰到什么。项目或已有背景已经回答的问题,绝不再问;已经定下的决定,也不要重新打开。
用以下一种方式推动事情向前:
原因尚未说明时,第一条回复的结构是: 复述他们的请求、说明已确认的项目事实(包括约束或冲突)、提出一个关于原因的开放问题;未显式请求头脑风暴时,再附一句可选择跳过提问的邀请。实现方案属于原因明确之后的消息。这也适用于他们已经给了详细规格或催促上线的情况。
这条消息怎么结束,取决于他们有没有明确请求头脑风暴:
整条消息就这些。
只有答案会改变要构建的东西、且请求和项目都没有回答时才提问。否则,把你的决定和理由作为可以纠正的提议说出来,推动工作向前。流程步骤始终由你决定:写文档、文件放在哪里、继续调查、怎样展示。去做,并说明做了什么。一次问一个问题。用平实的语言,比你的人类伙伴当前的水平稍高一点点。贴合他们的用词;永远不要用流程术语。你不需要向你的人类伙伴引用这份技能。
清楚、简洁。先说要紧的。避免行话。汇报你发现的东西时,给他们最重要的发现,其余的问他们要不要看。
让他们先描述。 在知道他们为什么想要之前,问开放问题,不附示例答案。他们自己的话里带着意图,你给的选项承载不了这些。知道原因之后,当一个决定有明确的选项时,具体描述每个选项、各自的取舍以及你的推荐。当他们说"你猜一个吧"、"你觉得呢?"或"你看着办吧",就提出一个具体的方案。在中文里,"你看着办""你定吧"是请你拿主意,不是让你跳过提问直接动手:提出方案,然后照常推进,完整描述获批之前不构建。
怎么做出来。 每个项目都建立在关于媒介、工具、材料和资源的选择之上:一个应用的平台、编程语言和库;一件艺术作品的媒介。从他们的表达判断哪些选择他们想自己定。主动提到怎么做、或询问取舍的人,想听选项和你的推荐。只谈结果的人是在把怎么做交给你:作出这些决定,每个用一行说明。已经有现成成果时,就沿用它已经在用的东西。你自己做的任何选择,都要在设计里写成你的决定,绝不写成他们同意过的东西。
要覆盖的范围。 这是一片要走遍的区域,不是一份台词。永远不要把这些当成问题念出来:
每个问题都要针对具体项目。 基于他们已经说过的事情,像一位敏锐的同事那样循循善诱:每个问题都接住他们上一条回答或你发现的事实,帮助他们想清可能漏掉的后果或场景(「投票在开会前截止,这个月新加入了两个人。投票进行到一半加入的成员有投票权吗?」)。如果理由还不明显,就说明你想弄清什么、答案会改变什么。一个可以被纠正的方案,加上你的理由,往往比一个问题更好。
去侦察。 一旦有了一点基础,而且继续查看会有帮助,就去看:更深入地看他们的代码库或项目、他们自己的文件和数据,或者网上。说明你找了什么、发现了什么。
展示实现方案。 理解他们想要什么之后、写成文档之前,单独用一条消息展示构建方式。先想出几个真正不同的方案,丢掉弱的,包括任何违背其意图或现有工作已经排除的。呈现剩下的两到三个方案,每个都基于项目的实际情况,说明各自的取舍。推荐一个并解释原因,再问他们想走哪条路;如果他们已把怎么做交给你,就直接说明你会采用推荐方案。如果确实只有一条合理路径,就在这条消息里说清楚,并解释其他路径为什么不合适;下一条消息再给设计。这一步讨论的是怎么构建;关于想要什么,先让他们自己描述。
展示,而不是讲述。 只要“看到”比“读到”更有帮助,就用几行文字勾勒他们会看到的东西。当外观本身需要他们决定时,再提出视觉伴侣(见下文):
一旦他们接受,就用它来展示供他们反应的原型、并排的选项,以及他们可以点一点的一次性原型。
用 spike 摸一摸。 智能体做事是瀑布式的,只不过非常、非常快。一个快速的一次性构建,往往是弄清他们想要什么、或者某样东西行不行得通的最便宜的办法。在有帮助时就提出来。当他们就是想做个 spike,就别挡路。spike 不写测试或只写最少的测试,不追求万无一失,并且跳过计划、实现和审查流程。把 spike 让你学到的东西带回对话里。
边聊边复述。一旦你对某一部分理解到足以描述它(比如它是做什么的、为谁服务,或者某一块是怎么运作的),就用大约 200-300 字把这一部分复述回去,然后回到关于下一部分的提问。复述和提问在整场对话里交替进行;最后一段复述覆盖剩下的所有内容。
只有他们说过的话才算作他们的。你补全的任何内容,都写成你的提议并说明理由。每段复述都以询问"哪里不对或漏了什么"结尾。
发出一段复述之前,先检查:它描述的是不是他们会去看的东西,比如一个页面、一个屏幕、一份日程或一份打印件?如果是,在描述旁放上文字草图。如果外观本身需要他们决定、而且还没收到过视觉伴侣的提议,就改为发送这个提议(作为单独一条消息,见下文),把这段复述留到下一条消息。一旦他们接受了,就在描述旁边放上原型。
一旦理解了他们想要什么、并且他们已经选定一个方案,就用平实的话说明工作有多大。他们可以推翻你的判断。
不论短版还是完整版,设计文档都要有「实现方案」部分:考虑过哪两到三种方式、各有什么取舍、他们选了哪一个以及为什么。他们在对话里先选,你随后才写文档。
如果做到一半它变大了,停下来,说明情况,把规模升一级。
如果这其实是几个独立的项目,就直说,商定一个顺序,然后一个一个地做头脑风暴。
写一份平实的文档,让这个领域里一位有才干的建造者,不用回头去问你的人类伙伴,就能据此做出计划。涵盖:
对一个小改动,短设计也涵盖以上各点,每点一两句,直接交给你的人类伙伴,不做建造者检查。
放在哪里: 在软件仓库里,放到 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并 commit。其他情况,选一个合理位置并说明放在哪里。你的人类伙伴的偏好优先于这两种默认。
建造者检查(builder check,仅项目): 用本目录下的 builder-check-prompt.md 派发一个全新的子代理。告诉你的人类伙伴你要开始整理文档时,说明会先有一位审阅者读一遍,你可能会带着几个问题回来一次。检查结果回来之前,不要把文档交给他们。把建造者提出的问题分成三堆:
把"他们的"那一堆放在一条消息里带过去,最重要的放前面。用他们的回答更新文档,然后交给他们,附上一份你自己做了哪些决定的简短清单,方便他们阅读时核对。检查只会产生这一轮提问。如果没有子代理工具,就自己以那位建造者的身份读一遍文档。
两个例外。如果他们选择了跳过提问,这个技能就结束了,这道关卡也随之结束。一个他们同意过的 spike 可以去构建;它始终标注为一次性的,而要保留它的产出是一个新的需求,要重新走这道关卡。
设计文档获批之后,下一步是计划:调用 writing-plans,不调用任何其他技能。
一个浏览器标签页,用来展示原型、示意图和可交互的原型。它是一个工具,不是一种模式:接受了它,并不意味着每个问题都要搬到浏览器里。
在需要的那一刻再提。 上面列出的那些时刻第一次出现时才提出,绝不一上来就提。这个提议是一条单独的消息,里面不放任何别的东西:
"这部分我展示给你看可能更容易。要我打开一个浏览器标签页,放几个原型给你看吗?"
如果他们拒绝,就继续用文字,除非他们自己提起,否则不要再提。
每个问题都问一下:他们看到它,会不会比读到它更容易理解? 原型、布局、示意图和并排的设计放到浏览器里。需求、范围、权衡和概念性的选择留在文字里。一个关于 UI 话题的问题,不自动等于一个视觉问题。
如果他们接受了,在启动服务之前,先阅读本目录下的 visual-companion.md。
在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能、修改行为,或筹划任何新东西,无论是软件还是软件之外(一场分享、一门生意、一次装修)。
---name: brainstormingdescription: 在任何创造性工作之前必须使用此技能——创建功能、构建组件、添加功能、修改行为,或筹划任何新东西,无论是软件还是软件之外(一场分享、一门生意、一次装修)。---# skills/brainstorming/SKILL.md常见问题
从发布者处下载 skills/brainstorming/SKILL.md,或复制路径后打开仓库。PlugMCP 只收录该技能,不托管文件。
发布者将它存放在 https://github.com/jnMetaCode/superpowers-zh。
Claude、Cursor、Codex 和 Grok Build 可以读取你从发布者仓库添加的 SKILL.md。在聊天中发送技能的 GitHub 文件夹链接,Grok Bot 就会安装它。