mcpField
B
brainstorming

brainstorming

github.com/vudovnAgent 工作流8.2k215 次安装9 周前更新
代码仓库

关于 brainstorming

供 Agent 处理复杂、模糊或变更请求时使用的沟通与头脑风暴技能。它要求在实施前澄清范围,并指导进度更新和错误响应。

主要功能

  1. 01实施前澄清需求
  2. 02检查过往决策记忆
  3. 03围绕决策生成问题
  4. 04报告任务进度状态
  5. 05结构化说明错误

适用场景

  1. 01澄清新功能需求
  2. 02确认变更请求的范围
  3. 03汇报任务执行进度
  4. 04说明故障并提供选项

安装

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

$npx skills add https://github.com/vudovn/ag-kit --skill brainstorming

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

附带文件dynamic-questioning.md

详细介绍

头脑风暴与沟通协议

强制要求: 用于复杂/模糊的请求、新功能和更新。


🛑 苏格拉底式关卡(强制执行)

何时触发
模式操作
未提供细节的“构建/创建/制作[事物]”请求🛑 提出 3 个问题
复杂功能或架构🛑 实施前先澄清
更新/更改请求🛑 确认范围
需求模糊🛑 询问目的、用户和限制条件
🧠 记忆检查(2026.5.13 — 提问前)

提问前,检查是否存在过往上下文:

0. CHECK MEMORY — Does .agents/memory/MEMORY.md exist?
   → YES: Read index. Apply relevant past decisions silently.
          Skip questions already answered in memory.
   → NO: Proceed with standard Socratic Gate.
🚫 强制要求:实施前先问 3 个问题
  1. 停止 - 不要开始编写代码
  2. 检查 - 阅读 .agents/memory/,查找此主题的过往上下文
  3. 提问 - 至少提出 3 个问题(记忆中已有答案的问题可跳过):
    • 🎯 目的:你要解决什么问题?
    • 👥 用户:谁会使用它?
    • 📦 范围:哪些是必需项,哪些是锦上添花?
  4. 等待 - 收到回复后再继续
  5. 保存 - 头脑风暴结束后,保存关键决策:/remember [decision]

🧠 动态生成问题

⛔ 切勿使用固定模板。 阅读 dynamic-questioning.md,了解相关原则。

核心原则
原则含义
问题揭示后果每个问题都关联一项架构决策
先了解上下文,再了解内容先判断是全新项目、功能开发、重构还是调试
最少必要问题每个问题都必须排除一些实现路径
获取数据,而非臆测不要猜测——通过询问了解不同方案的权衡
问题生成流程
1. Parse request → Extract domain, features, scale indicators
2. Identify decision points → Blocking vs. deferable
3. Generate questions → Priority: P0 (blocking) > P1 (high-leverage) > P2 (nice-to-have)
4. Format with trade-offs → What, Why, Options, Default
问题格式(强制要求)
### [PRIORITY] **[DECISION POINT]**

**Question:** [Clear question]

**Why This Matters:**
- [Architectural consequence]
- [Affects: cost/complexity/timeline/scale]

**Options:**
| Option | Pros | Cons | Best For |
|--------|------|------|----------|
| A | [+] | [-] | [Use case] |

**If Not Specified:** [Default + rationale]

有关特定领域的问题库和算法的详细信息,请参阅:dynamic-questioning.md


进度报告(基于原则)

原则: 透明沟通有助于建立信任。状态必须清晰可见且可采取行动。

状态面板格式
Agent状态当前任务进度
[Agent Name]✅🔄⏳❌⚠️[Task description][% or count]
状态图标
图标含义用法
✅已完成任务已成功完成
🔄运行中正在执行
⏳等待中受阻,正在等待依赖项
❌错误执行失败,需要处理
⚠️警告存在潜在问题,但不会阻塞

错误处理(基于原则)

原则: 错误是清晰沟通的契机。

错误响应模式
1. Acknowledge the error
2. Explain what happened (user-friendly)
3. Offer specific solutions with trade-offs
4. Ask user to choose or provide alternative
错误类别
类别响应策略
端口冲突提供备用端口,或关闭现有服务
缺少依赖项自动安装或征求许可
构建失败显示具体错误和建议的修复方法
错误不明确询问具体信息:截图、控制台输出

完成消息(基于原则)

原则: 庆祝成功,并指引后续步骤。

完成结构
1. Success confirmation (celebrate briefly)
2. Summary of what was done (concrete)
3. How to verify/test (actionable)
4. Next steps suggestion (proactive)

沟通原则

原则实施方式
简洁不提供不必要的细节,直入主题
直观使用表情符号(✅🔄⏳❌),方便快速浏览
具体说“约 2 分钟”,而不是“等一会儿”
提供替代方案遇到阻碍时,提供多种选择
积极主动完成后建议下一步操作

反模式(避免)

反模式原因
未了解情况就直接提出解决方案把时间浪费在错误的问题上
不询问就假定需求导致输出不符合要求
首个版本过度设计延误价值交付
忽视限制条件产出无法使用的解决方案
使用“我觉得”之类的措辞表示不确定 → 应改为提问

评论

支持 Markdown