mcpField
B
brainstorm

brainstorm

github.com/btrautAgent 工作流7128 次安装5 周前更新
代码仓库

关于 brainstorm

通过检查项目现状并逐个提出聚焦问题,帮助将初步想法整理为设计规格。随后分节呈现设计供审核,并支持交接到 beads 或计划制定。

主要功能

  1. 01提问前检查项目上下文
  2. 02每条消息只问一个聚焦问题
  3. 03提供带推荐项的选择题
  4. 04分节编写便于审核的设计
  5. 05准备 beads 与计划交接

适用场景

  1. 01梳理早期项目想法
  2. 02在不同设计方向间做选择
  3. 03审核拟定的规格
  4. 04为计划制定准备范围明确的工作

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/btraut/skills --skill brainstorm

安装后在 Claude Code 中输入/brainstorm确认已加载。

附带文件agents/openai.yamlVERSION

详细介绍

头脑风暴

使用此技能,通过一次提出一个有针对性的问题,引导用户从粗略想法逐步形成清晰的设计/规格;首先检查项目状态。

工作流

  1. 扫描项目上下文

    • 检查工作目录,了解当前状态、限制,以及现有文档或代码。
    • 只有在有助于引出下一个问题时,才用 2-4 句话概述你看到的内容。
  2. 提出细化问题(每条消息一个)

    • 每次回复只提出一个问题。
    • 优先使用包含 3-5 个选项的选择题;适用时加入“其他:____”选项。
    • 对于选择题,恰好标记一个推荐选项,让用户明确默认选择。
    • 在 Codex request_user_input 中,通过在选项标签末尾添加 (Recommended) 标记推荐选项。在 Claude AskUserQuestion 中,如果可用,请使用明确的 recommended 标记;否则清楚地标明一个选项为推荐选项。
    • 只有当选项会造成误导时,才使用开放式问题。
    • 按不确定性从高到低的顺序安排问题。
    • 不要询问通过检查代码库或使用可用工具就能轻易回答的问题;先查明。
    • 问题范围要明确,聚焦于决策。
    • 对于 Claude,请通过 AskUserQuestion 提问。
  3. 逐步明确需求

    • 一旦想法已足够清晰,可以描述设计/规格,就停止提问。
    • 明确说明你将从提问转为描述设计。
  4. 分节描述设计

    • 按章节提供设计/规格,每节约 200-300 个词。
    • 每节结束后,先询问用户目前是否认可,再继续下一节。
    • 纳入用户反馈,并据此修改下一节。
  5. Beads + 规划交接

    • 最后一节规格获得认可后,将规格总结为 bead 字段:title、description、design、acceptance。
    • 提出一个涵盖下一步的选择题(Beads 和/或规划),并标记一个推荐选项。例如:创建单个 bead、创建史诗 + 里程碑、仅继续规划,或暂停。
    • 如果用户要求创建 Beads,但粒度不明确,则提出一个后续问题,让用户在单个 bead 和包含里程碑 bead 的史诗之间选择。
    • 粒度决策规则:
      • 单个 bead:需要 1-3 次工作会话,流程连贯,交接最少。
      • 史诗 + 里程碑:工作周期较长或存在明确检查点,即使步骤是顺序执行也适用。如果步骤必须按顺序完成,请使用线性依赖关系。
    • 如果用户要求制定计划,请提供简洁的规格摘要(目标、非目标、用户体验、数据/逻辑、限制、验收标准),作为计划的基础。
    • 如果之后制定了计划,请在 bead 的 design 字段中链接该计划。

风格规则

  • 每条消息只提出一个问题。
  • 保持推进节奏:不要写冗长的铺垫或多段引言。
  • 使用具体措辞,避免填充语。
  • 不要宣布技能,也不要使用“我将使用头脑风暴技能,因为……”之类的元陈述作为开场。
  • 询问 Beads/计划时,使用一个选择题;只有在需要确定 bead 粒度时才追问。
  • 对于每道选择题,确保恰好有一个选项明确标记为推荐。

评论

支持 Markdown