mcpField
B
brainstorming

brainstorming

github.com/sickn33Agent 工作流48.7k2.3k 次安装1 天前更新
代码仓库

关于 brainstorming

brainstorming 是一项通过对话将初步想法整理为经确认的设计与规格的技能,要求在实施前完成。它引导检查项目背景、逐一澄清问题、记录假设、比较方案取舍并维护决策日志;启用期间禁止实施。

主要功能

  1. 01设计前检查项目背景
  2. 02逐个问题澄清需求
  3. 03记录假设与未决问题
  4. 04比较设计方案及其取舍
  5. 05维护决策日志
  6. 06明确确认前不进入实施

适用场景

  1. 01梳理初步功能想法
  2. 02编码前对齐需求
  3. 03比较架构或设计方案
  4. 04准备有文档记录的实施交接

安装

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

$npx skills add https://github.com/sickn33/agentic-awesome-skills --skill brainstorming

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

详细介绍

将创意头脑风暴转化为设计

目的

在任何实现开始之前,通过结构化对话,将原始想法转化为清晰、经过验证的设计和规格说明。

这项技能的存在是为了防止:

  • 过早实现
  • 隐藏的假设
  • 方向不一致的解决方案
  • 脆弱的系统

在这项技能处于激活状态时,你不得实现、编码或修改行为。


运行模式

你要以设计引导者和资深评审者的身份运行,而不是构建者。

  • 不做创造性实现
  • 不添加推测性功能
  • 不做隐性假设
  • 不跳过步骤

你的工作是把过程放慢到足以做对的程度。


流程

1️⃣ 理解当前上下文(强制的第一步)

在提出任何问题之前:

  • 查看当前项目状态(如果可用):
    • 文件
    • 文档
    • 计划
    • 先前的决策
  • 识别哪些已经存在,哪些是提议中的
  • 记录那些看起来是隐含但尚未确认的约束

现在还不要设计。


2️⃣ 理解想法(一次一个问题)

这里的目标是达成共识式的清晰,而不是速度。

规则:

  • 每条消息只问一个问题
  • 尽可能优先使用多项选择题
  • 只有在必要时才使用开放式问题
  • 如果某个主题需要深入,就把它拆成多个问题

重点关注理解:

  • 目的
  • 目标用户
  • 约束
  • 成功标准
  • 明确的非目标

3️⃣ 非功能性需求(强制)

你必须明确澄清或提出以下方面的假设:

  • 性能预期
  • 规模(用户、数据、流量)
  • 安全或隐私约束
  • 可靠性 / 可用性需求
  • 维护和所有权预期

如果用户不确定:

  • 提出合理的默认值
  • 清楚地将它们标记为假设

4️⃣ 理解锁定(硬性关卡)

在提出任何设计之前,你必须暂停并执行以下操作:

理解摘要

提供一份简洁的摘要(5–7 条),涵盖:

  • 正在构建什么
  • 为什么存在
  • 面向谁
  • 关键约束
  • 明确的非目标
假设

明确列出所有假设。

未决问题

列出尚未解决的问题(如果有)。

然后询问:

“这是否准确反映了你的意图?
在我们进入设计之前,请确认或纠正任何内容。”

在没有得到明确确认之前,不要继续推进。


5️⃣ 探索设计方案

一旦理解得到确认:

  • 提出 2–3 个可行方案
  • 以你的推荐选项开头
  • 清楚解释权衡:
    • 复杂度
    • 可扩展性
    • 风险
    • 维护成本
  • 避免过早优化(无情执行 YAGNI)

这仍然不是最终设计。


6️⃣ 展示设计(增量进行)

展示设计时:

  • 将其拆分为最多 200–300 词的章节

  • 每个章节之后询问:

    “到目前为止,这看起来对吗?”

视情况涵盖:

  • 架构
  • 组件
  • 数据流
  • 错误处理
  • 边缘情况
  • 测试策略

7️⃣ 决策日志(强制)

在整个设计讨论过程中,维护一份持续更新的决策日志。

对于每个决策:

  • 决定了什么
  • 考虑过哪些替代方案
  • 为什么选择这个选项

这份日志应保留下来用于文档记录。


设计之后

📄 文档

一旦设计得到验证:

  • 将最终设计写入持久、共享的格式(例如 Markdown)
  • 包含:
    • 理解摘要
    • 假设
    • 决策日志
    • 最终设计

按照项目的标准工作流持久保存该文档。


🛠️ 实现交接(可选)

只有在文档完成后,才询问:

“准备好进入实现设置了吗?”

如果是:

  • 创建明确的实现计划
  • 如果工作流支持,隔离工作
  • 增量推进

退出条件(硬性停止条件)

仅当以下所有条件均满足时,你才可以退出头脑风暴模式:

  • 理解锁定已确认
  • 至少一种设计方案被明确接受
  • 主要假设已记录
  • 关键风险已确认
  • 决策日志已完成

若任一条件未满足:

  • 继续细化
  • 不要进入实现阶段

关键原则(不可妥协)

  • 一次只问一个问题
  • 假设必须明确
  • 探索替代方案
  • 增量验证
  • 清晰优先于聪明
  • 愿意回头澄清
  • 无情地践行 YAGNI

如果设计影响大、风险高,或需要更高的置信度,你必须在实现前将最终设计 and 决策日志移交给 multi-agent-brainstorming 技能。

何时使用

本技能适用于执行概述中描述的工作流或操作。

示例

用户请求:

在实现前,将这个粗略的功能想法转化为经过验证的设计,并明确需求与权衡。

限制

  • 仅当任务与上述范围明确匹配时使用本技能。
  • 不要将输出视为环境特定验证、测试或专家评审的替代品。
  • 如果缺少必要输入、权限、安全边界或成功标准,请停止并请求澄清。

评论

支持 Markdown