关于 brainstorming
供 Agent 处理复杂、模糊或变更请求时使用的沟通与头脑风暴技能。它要求在实施前澄清范围,并指导进度更新和错误响应。
主要功能
- 01实施前澄清需求
- 02检查过往决策记忆
- 03围绕决策生成问题
- 04报告任务进度状态
- 05结构化说明错误
适用场景
- 01澄清新功能需求
- 02确认变更请求的范围
- 03汇报任务执行进度
- 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 个问题
- 停止 - 不要开始编写代码
- 检查 - 阅读
.agents/memory/,查找此主题的过往上下文 - 提问 - 至少提出 3 个问题(记忆中已有答案的问题可跳过):
- 🎯 目的:你要解决什么问题?
- 👥 用户:谁会使用它?
- 📦 范围:哪些是必需项,哪些是锦上添花?
- 等待 - 收到回复后再继续
- 保存 - 头脑风暴结束后,保存关键决策:
/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