SuperAPI AI 工具集

brainstorming

智能体与模型

查看项目

更新于 10-14 06:41

技能介绍

用途

Brainstorming 是 obra/superpowers 中的一项技能,要求在任何创作性工作之前使用,包括创建功能、构建组件、添加功能、修改行为或规划任何新内容。其目的是在开始构建之前,弄清用户实际想要什么以及为什么想要。

技能文档指出:人们往往并未完全想清楚自己要什么,好的问题能帮助他们理清思路。当理解了“为什么”,就能按照用户本人的方式做出那些他们从未提及的众多决定。

主要能力

判断已知与未知:回复前先自问对该需求及其原因了解多少。若请求本身已足够清楚(如“把图标做成矢车菊蓝”),则直接执行并说明;若缺少重要信息,则开启对话。

首条消息:包含两部分,按顺序为——一句话告知用户可以跳过提问直接开始;一个开放式问题,引导用户描述真实场景或具体画面。

对话机制:每条消息以一个问题结尾,使用平实语言,匹配对方的用词,避免流程术语。先开放提问,让用户用自己的话表达意图;仅在对方卡住时才给出简短选项。

弄清实现方式:尽早了解在媒介、工具、材料和资源方面的选择(如应用的平台、编程语言、库,或艺术作品的媒介),分清哪些由用户决定、哪些委托给执行者,以及已有条件。

需要覆盖的领域(作为范围而非脚本):这是什么类型的东西及其特别之处;为什么是现在、成功的样子;目标、非目标与反目标;先前案例(喜欢或讨厌的);现状与已尝试的方案;用户在意的细节。

提议侦察:在有一定基础且查看有帮助时,提议查看用户的代码库、项目、文件、数据或网络,并说明会查找什么,由用户决定是否执行。

私下广泛思考:提出方案前先想若干想法并淘汰弱的,仅在有助于决策时展示对比。

可视化辅助:当“看到”比“读到”更有帮助时(如屏幕、页面、打印稿、标志;布局或排列;流程或步骤序列;外观不同的选项;比文字更易看的结构如示意图、时间线、地图),提议使用浏览器标签页展示。该提议单独成一条消息:“这个用展示的方式可能更容易理解。要我打开一个浏览器标签页放一些草图吗?”用户拒绝则保持文字方式,不再主动提议。

快速试验(Spike):当快速的一次性构建是了解需求或验证可行性的最省成本方式时,提议进行。用户同意后即放手进行;spike 不做测试或只做最少测试,不保证健壮,跳过计划、实现和评审流程,其产出为一次性,保留产出属于新需求,需重新走流程。

逐步复述:一旦理解某部分并足以描述,就用约 200-300 字复述该部分,然后回到关于下一部分的问题。复述与提问在整个对话中交替进行。推测的内容标记为猜测,只有用户说过的才算用户的。每段复述以询问“哪里不对或缺少什么”结束。

判断工作规模:理解需求后,以平实语言选定规模,用户可覆盖:快速明确的任务(直接做);小改动(在对话中描述,用常规流程构建);有书面设计的项目(写设计文档,再做完整计划,软件项目调用 superpowers:writing-plans)。若任务中途变大,停下来说明并升级规模。若实为多个独立项目,说明并商定顺序,逐个进行头脑风暴。

书面设计文档:针对项目,撰写一份平实文档,使该领域有能力的构建者无需再询问用户即可规划。内容涵盖:意图与原因;目标、非目标、反目标;约束;用户已决定的“如何做”部分;留给构建者的部分。软件仓库中存放于 docs/superpowers/specs/YYYY-MM-DD-<topic>-design.md 并提交;否则询问位置。用户偏好优先。

构建者检查:派发一个新的子代理,使用本目录中的 builder-check-prompt.md。构建者的问题分三类:对话或项目已解答的(写入文档);次要的(可自行决定并在文档中标记为自己的决定);只有用户能回答且会改变构建内容的(一次性以一条消息呈现,最重要在前)。更新文档后交付,并附上所做决定的简短清单。该检查只产生一轮问题。若无可用的子代理工具,则自行以构建者视角阅读文档。

两个例外:若用户选择跳过提问,技能结束,检查环节一并取消;用户同意的 spike 可以构建,但保持“一次性”标记,保留其产出属于新需求,需重新经过该环节。项目文档获批后,下一步是计划;软件项目调用 superpowers:writing-plans,不调用其他技能。

使用方式

按对话流程推进:先判断已知信息,发送首条消息(跳过选项 + 一个开放问题),在对话中交替提问与复述,弄清实现方式与各领域信息,必要时提议侦察或可视化辅助,最后判断规模并产出相应成果。

适用场景

任何创作性工作开始之前:创建功能、构建组件、添加功能、修改行为、规划新内容。也适用于需要先明确需求再动手的软件或非软件项目。

限制与注意事项

技能包含一组“红旗”提示,纠正常见误区:不要用选项代替用户描述;默认值要明确说出;不必先解释流程;对想法的“听起来不错”不等于对未写出的描述已获批准;spike 能跑不代表可继续在其上构建。可视化辅助是工具而非模式,接受它不会把每个问题都转到浏览器;需求、范围、权衡和概念选择仍留在文字中。文档中提及的 visual-companion.md 和 builder-check-prompt.md 为技能目录内的文件,具体内容暂未提供。