关于 brainstorm
通过检查项目现状并逐个提出聚焦问题,帮助将初步想法整理为设计规格。随后分节呈现设计供审核,并支持交接到 beads 或计划制定。
主要功能
- 01提问前检查项目上下文
- 02每条消息只问一个聚焦问题
- 03提供带推荐项的选择题
- 04分节编写便于审核的设计
- 05准备 beads 与计划交接
适用场景
- 01梳理早期项目想法
- 02在不同设计方向间做选择
- 03审核拟定的规格
- 04为计划制定准备范围明确的工作
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ btraut/ skills --skill brainstorm安装后在 Claude Code 中输入/brainstorm确认已加载。
附带文件agents/openai.yamlVERSION
详细介绍
头脑风暴
使用此技能,通过一次提出一个有针对性的问题,引导用户从粗略想法逐步形成清晰的设计/规格;首先检查项目状态。
工作流
-
扫描项目上下文
- 检查工作目录,了解当前状态、限制,以及现有文档或代码。
- 只有在有助于引出下一个问题时,才用 2-4 句话概述你看到的内容。
-
提出细化问题(每条消息一个)
- 每次回复只提出一个问题。
- 优先使用包含 3-5 个选项的选择题;适用时加入“其他:____”选项。
- 对于选择题,恰好标记一个推荐选项,让用户明确默认选择。
- 在 Codex
request_user_input中,通过在选项标签末尾添加(Recommended)标记推荐选项。在 ClaudeAskUserQuestion中,如果可用,请使用明确的recommended标记;否则清楚地标明一个选项为推荐选项。 - 只有当选项会造成误导时,才使用开放式问题。
- 按不确定性从高到低的顺序安排问题。
- 不要询问通过检查代码库或使用可用工具就能轻易回答的问题;先查明。
- 问题范围要明确,聚焦于决策。
- 对于 Claude,请通过 AskUserQuestion 提问。
-
逐步明确需求
- 一旦想法已足够清晰,可以描述设计/规格,就停止提问。
- 明确说明你将从提问转为描述设计。
-
分节描述设计
- 按章节提供设计/规格,每节约 200-300 个词。
- 每节结束后,先询问用户目前是否认可,再继续下一节。
- 纳入用户反馈,并据此修改下一节。
-
Beads + 规划交接
- 最后一节规格获得认可后,将规格总结为 bead 字段:title、description、design、acceptance。
- 提出一个涵盖下一步的选择题(Beads 和/或规划),并标记一个推荐选项。例如:创建单个 bead、创建史诗 + 里程碑、仅继续规划,或暂停。
- 如果用户要求创建 Beads,但粒度不明确,则提出一个后续问题,让用户在单个 bead 和包含里程碑 bead 的史诗之间选择。
- 粒度决策规则:
- 单个 bead:需要 1-3 次工作会话,流程连贯,交接最少。
- 史诗 + 里程碑:工作周期较长或存在明确检查点,即使步骤是顺序执行也适用。如果步骤必须按顺序完成,请使用线性依赖关系。
- 如果用户要求制定计划,请提供简洁的规格摘要(目标、非目标、用户体验、数据/逻辑、限制、验收标准),作为计划的基础。
- 如果之后制定了计划,请在 bead 的 design 字段中链接该计划。
风格规则
- 每条消息只提出一个问题。
- 保持推进节奏:不要写冗长的铺垫或多段引言。
- 使用具体措辞,避免填充语。
- 不要宣布技能,也不要使用“我将使用头脑风暴技能,因为……”之类的元陈述作为开场。
- 询问 Beads/计划时,使用一个选择题;只有在需要确定 bead 粒度时才追问。
- 对于每道选择题,确保恰好有一个选项明确标记为推荐。
评论
支持 Markdown