关于 brainstorming
面向需要在实现前探索方案、梳理需求的协作式头脑风暴技能,适用于产品、设计和工程角色。它通过提问与方案比较形成设计文档,并要求用户批准后才进入后续步骤。
主要功能
- 01按指定角色开展讨论
- 02逐步澄清目标与约束
- 03比较方案并给出建议
- 04批准前不进入实现
- 05按选择保存讨论文档
适用场景
- 01将初步想法整理为设计方案
- 02在实施前比较不同技术或产品方向
- 03为路线图或任务梳理目标与待决问题
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ jsonlee12138/ agent-team --skill brainstorming安装后在 Claude Code 中输入/brainstorming确认已加载。
附带文件agents/openai.yaml
详细介绍
将想法转化为设计
概述
通过协作对话,将想法转化为清晰且获认可的头脑风暴文档。
始终支持基于角色的头脑风暴:
- 如果用户指定了角色,就从该角色的视角出发(例如:产品经理、前端架构师、后端架构师、UX 设计师)。
- 如果未指定角色,则使用
general strategist角色。
范围规则
当用户希望在实施前专门探索设计、比较方案或梳理需求时,使用此流程。
对于简单的实现请求、小型修复或明确指定的变更,不要强行套用完整的头脑风暴流程。 如果只需要轻量的设计帮助,就保持简短,只询问消除歧义所需的最少问题。
检查清单
选择最符合请求的精简检查清单。
标准流程
- 探索项目背景:仅检查与主题相关的文件、文档和近期变更。
- 提出澄清问题:仍有歧义时,优先一次聚焦一个问题。
- 存在权衡时,提出 2-3 种方案;并给出推荐方案。
- 用简洁的章节呈现设计,只涵盖请求涉及的方面。
- 如果主题侧重规划,明确询问头脑风暴针对哪个目标对象:
roadmap、milestone、phase或generic topic。 - 相关时,询问头脑风暴是否应基于现有对象或参考资料集展开。
- 如果用户希望保存文档,写入前先询问保存位置。
- 交付头脑风暴结果后即停止,除非用户明确要求继续。
轻量流程
针对范围较窄的需求梳理,使用此精简流程:
- 确认目标和关键约束。
- 首先给出推荐方案。
- 只有在会实质性改变范围、风险或成本时,才提及其他方案。
- 直接在对话中给出结果,除非用户要求保存。
流程
digraph brainstorming {
"Explore project context" [shape=box];
"Ask clarifying questions" [shape=box];
"Propose 2-3 approaches" [shape=box];
"Present design sections" [shape=box];
"User approves design?" [shape=diamond];
"Choose save location" [shape=box];
"Write brainstorming doc" [shape=box];
"Deliver doc and stop" [shape=doublecircle];
"Explore project context" -> "Ask clarifying questions";
"Ask clarifying questions" -> "Propose 2-3 approaches";
"Propose 2-3 approaches" -> "Present design sections";
"Present design sections" -> "User approves design?";
"User approves design?" -> "Present design sections" [label="no, revise"];
"User approves design?" -> "Choose save location" [label="yes"];
"Choose save location" -> "Write brainstorming doc" [label="default / custom"];
"Choose save location" -> "Deliver doc and stop" [label="skip saving"];
"Write brainstorming doc" -> "Deliver doc and stop";
}
终止状态为 Deliver doc and stop。
除非用户明确要求进行下一步,否则不要继续制定实现计划或开展实现工作。
保存位置规则(必需)
写入任何文件之前,始终先询问用户希望将头脑风暴文档保存在哪里。
标准选项
- 默认目录:
docs/brainstorming/ - 自定义目录:用户提供的路径
- 跳过保存:不写入任何文件
规划层级目标的额外选项
如果头脑风暴目标是 roadmap、milestone 或 phase,还应提供以下选项:
4. 目标对象目录:仅当用户明确希望文档与目标对象放在一起时,才将头脑风暴文档保存在目标对象主文件所在目录。
判断规则
- 如果用户没有要求将文档与目标对象放在一起,优先使用默认目录
docs/brainstorming/。 - 只有当用户明确希望头脑风暴文档附属于相应的路线图、里程碑或阶段时,才使用目标对象目录。
- 只有当用户明确提供自定义目录时,才使用该目录。
- 如果用户选择跳过保存,则不要写入任何文件。
文件名规则
如果用户选择默认目录、自定义目录或目标对象目录,请使用:
<topic>-YYYY-MM-DD-brainstorming.md
对于默认目录,完整路径为:
docs/brainstorming/<topic>-YYYY-MM-DD-brainstorming.md
对于目标对象目录,保留相同的文件名格式,并将文件放入该对象的目录中。
将主题放在文件名开头,这样在浏览目录时,相关的头脑风暴文档会更自然地归类在一起,同时仍保留日期以便按时间顺序排列。
对于自定义目录,请写入用户提供的确切目录,并使用相同的文件名格式。
如果用户选择跳过保存,则不要写入任何文件——仅在聊天中直接输出文档内容。
提问规则
- 每条消息只问一个问题。
- 尽可能优先使用选择题。
- 聚焦于目的、约束和成功标准。
- 如果回答含糊,请返回并再次澄清。
设计展示规则
- 只有在存在有意义的权衡时,才在最终确定前展示 2-3 种方案。
- 先介绍推荐方案并说明原因。
- 简单任务的每个部分应简洁,复杂任务则应详细。
- 对于轻量级头脑风暴,请一次性征求整体批准,而不是逐部分征求批准。
- 只有当设计规模较大、风险较高或存在重大歧义时,才逐部分征求批准。
文档内容指南
请包含:
- 头脑风暴所采用的角色(明确指定的角色或
general strategist) - 相关时注明目标对象(
roadmap、milestone、phase、task或generic topic) - 问题陈述和目标
- 约束和假设
- 备选方案及其权衡
- 推荐设计
- 对于规划层主题,明确重申
task仍是唯一的执行单元,规划产物是规划/展示对象 - 风险和缓解措施
- 验证/测试策略
- 未决问题(如有)
不要包含实现代码。
完成标准
只有在满足以下条件后才能结束:
- 用户已批准设计。
- 用户已为文档选择一个允许的保存位置(
docs/brainstorming/、适用时的目标对象目录、自定义目录,或跳过保存)。 - 头脑风暴文档已写入文件(默认目录/目标对象目录/自定义目录),或已直接输出(跳过保存),并已分享。