SuperAPI AI 工具集

workflows-brainstorm

智能体与模型

查看项目

更新于 10-16 07:29

技能介绍

用途

workflows-brainstorm 是一个用于“头脑风暴”的工作流技能,目标是在动手规划实现之前,通过协作式对话把需求与可行方案探索清楚。它回答的是“要构建什么(WHAT)”,而“如何构建(HOW)”由后续的 /workflows:plan 负责。

主要能力

  • 需求清晰度评估:根据功能描述判断是否真的需要头脑风暴。若已提供具体验收标准、可参照的现有模式、明确的预期行为、范围受限且定义清晰,则提示用户可直接进入规划。
  • 轻量级仓库调研:运行快速仓库扫描,了解与功能相关的现有模式,重点关注相似功能、既有约定与 CLAUDE.md 指引。
  • 协作式对话:使用 AskUserQuestion 工具一次只问一个问题,优先提供多选项;先宽泛(目的、用户)后收窄(约束、边界情况),显式验证假设并询问成功标准。
  • 方案探索:基于调研与对话提出 2-3 个具体方案,每个方案给出 2-3 句简述、优缺点与最适用场景,并优先推荐更简单的方案(遵循 YAGNI 原则)。
  • 设计记录:将头脑风暴文档写入 docs/brainstorms/YYYY-MM-DD-<topic>-brainstorm.md,写入前确保目录存在。文档关键部分包括:要构建什么、为何采用该方案、关键决策、待解决问题。
  • 待解决问题处理:在进入交接阶段前,若文档中存在待解决问题,必须逐一用 AskUserQuestion 询问用户,解决后移入“已解决问题”部分。
  • 交接选项:提供“结构化自审与完善”“进入规划”“继续提问”“暂时结束”等后续选择。选择“继续提问”时回到协作对话阶段继续追问;选择“自审与完善”时加载 document-review 技能对文档进行审查。

使用方式

该技能以工作流形式运行,包含以下阶段:

  • 阶段 0:评估需求清晰度。若需求已足够清晰,建议改用 /workflows:plan 或继续探索。
  • 阶段 1:理解想法。先做轻量级仓库调研,再进入协作式对话,直到想法清晰或用户表示“proceed”。
  • 阶段 2:探索方案。提出 2-3 个方案并让用户选择偏好。
  • 阶段 3:记录设计。写入头脑风暴文档,并处理其中的待解决问题。
  • 阶段 4:交接。展示下一步选项。

若功能描述为空,会先询问用户想探索什么,在获得描述前不继续。

适用场景

适用于在实现规划之前需要澄清需求、比较多种实现思路、记录关键决策与待解决问题的功能或改进类任务。

限制

  • 该技能明确要求“绝不写代码”,只做探索与决策记录。
  • 每段输出控制在 200-300 字以内。
  • 实现细节属于规划阶段,不在本技能范围内。
  • 文档中若存在待解决问题,必须先逐一询问用户后才能进入规划。

输出摘要

完成时展示:头脑风暴完成、文档路径、关键决策列表,以及下一步运行 /workflows:plan 的提示。