socratic-brainstorm

苏格拉底式头脑风暴——先澄清，再编码

灵感来自 obra/superpowers。目标： 在任何实现开始之前，先进行一轮有针对性的提问，避免很快就把错误的东西写出来。

黄金法则： 提问花 30 秒，错误开发则要花 3 天。

苏格拉底式方法：5 类问题

在动代码之前提出。每次不必全部提问——根据上下文选择最相关的问题。

1. 关于问题的问题

• 要解决的真正问题是什么？（而不是假定的解决方案）
• 为谁解决？用户画像／用户角色是什么？
• 什么都不做的代价是什么？
• 如何衡量成功？（KPI、指标）
• 有没有更简单的解决方案，能满足 80% 的需求？

2. 关于约束的问题

• 业务约束：法律规则、合规要求、SLA？
• 技术约束：指定的技术栈、依赖项、遗留系统？
• 时间约束：截止日期、外部依赖？
• 资源约束：基础设施预算、人力资源、长期维护？
• 有什么东西是绝对不能破坏的？

3. 关于替代方案的问题

• 有哪些可行方案？（至少 3 种）
• 为什么选这个方案，而不是其他方案？
• 我们已经尝试／考虑过什么？
• 是否存在现成的解决方案（库、SaaS）？
• 能否不写代码（配置、手动处理、流程）？

4. 关于假设的问题

• 有哪些未经验证的假设？
• 预期的规模／流量是多少？
• 实际使用模式是什么？（95% 的常见情况／5% 的边缘情况）
• 涉及哪些外部参与方？（第三方 API、团队、用户）
• 如果这个假设不成立，会发生什么？

5. 关于后果的问题

• 最终用户会受到什么影响？
• 对其他功能／模块有什么影响？
• 运营成本有哪些？（基础设施、监控、支持）
• 如果进展不顺，如何回滚？
• 这个方案 1 年、3 年后会如何演进？

预期产出

头脑风暴阶段结束后，最多产出一页内容，包括：

1. 用 1-2 句话重新表述问题
2. 主要约束（最多 5 条）
3. 选定方案 + 2 个被否决的替代方案及理由
4. 实现开始时需要验证的关键假设
5. 已识别的风险 + 缓解措施

黄金法则

以下情况不要跳过此阶段：

• 初始需求中包含“也许”“可能”“我认为”
• 提出需求的人不是最终用户
• 第一眼看上去就有多种可行方案
• 功能涉及遗留代码或复杂领域

以下情况可以跳过此阶段：

• 明显的 Bug，且只有一种可行修复方式
• 拼写／格式／文档
• 范围简单、耗时 < 10 分钟的任务

反模式

反模式	解决方案
头脑风暴无限延长，始终无法决策	将时间限制在最多 30 分钟
提出反问式问题（答案显而易见）	提出开放且有用的问题
不提问，自己作答	真正向需求提出者提问
因为“很紧急”就跳过头脑风暴	紧急造成的代价是省略头脑风暴的 10 倍
把答案记在脑子里	写下来 = 可见、可复查、可版本管理

与 Claude Craft 集成

• /workflow:analyze — BMAD 分析阶段从此 skill 开始
• /workflow:plan — PRD 必须回答这 5 类问题
• Agent @product-owner — 可与需求提出者一起开展头脑风暴
• Skill atomic-tasks — 将头脑风暴的产出拆分为原子任务
• Skill architect — 架构类功能应在头脑风暴之后进行设计

快速变体：“5 Whys”

对于 Bug 或根本原因分析，使用 Toyota 的 5 Whys：

Bug: "Le paiement échoue"
Why 1: Pourquoi ? → L'API retourne 500
Why 2: Pourquoi ? → Timeout DB
Why 3: Pourquoi ? → Requête sans index
Why 4: Pourquoi ? → Colonne ajoutée sans migration d'index
Why 5: Pourquoi ? → Pas de checklist PR pour les migrations

根本原因： 缺少检查清单，而不是 500 错误。

Ressources

• obra/superpowers
• Socratic Method - Wikipedia
• 5 Whys - Toyota
• Skill atomic-tasks, architect

---

Date de dernière mise à jour : 2026-04-15 Version : 1.0.0