Back to Details

socratic-brainstorm

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Socratic Brainstorm — Clarifier avant de coder

苏格拉底式头脑风暴——编码前先澄清问题

Skill inspiré de obra/superpowers. Objectif : forcer une phase de questions ciblées avant toute implémentation, pour éviter de coder la mauvaise chose très vite.
Règle d'or : une question coûte 30 secondes, un faux développement coûte 3 jours.
本Skill灵感源自obra/superpowers。**目标：**在任何实现前强制进行针对性提问环节，避免快速开发出错误的功能。
**黄金法则：**一个问题耗时30秒，错误的开发耗时3天。

Méthode socratique : 5 familles de questions

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

À poser avant de toucher au code. Pas toutes à chaque fois — choisir les plus pertinentes selon le contexte.
需在触碰代码前提出。无需每次都问所有问题——根据上下文选择最相关的问题。

1. Questions sur le PROBLÈME

1. 关于问题的提问

  • Quel est le vrai problème à résoudre ? (pas la solution supposée)
  • Pour qui ? Quel persona / rôle utilisateur ?
  • Quel est le coût de ne rien faire ?
  • Comment mesurera-t-on le succès ? (KPI, métrique)
  • Y a-t-il une solution plus simple qui résout 80% du besoin ?
  • 真正需要解决的问题是什么？（而非假设的解决方案）
  • 为谁解决？目标用户角色/画像是什么？
  • 不采取任何行动的代价是什么？
  • 如何衡量成功？（KPI、指标）
  • 是否存在更简单的解决方案可以满足80%的需求？

2. Questions sur les CONTRAINTES

2. 关于约束条件的提问

  • Contraintes métier : règles légales, compliance, SLA ?
  • Contraintes techniques : stack imposée, dépendances, legacy ?
  • Contraintes temporelles : deadline, dépendances externes ?
  • Contraintes ressources : budget infra, RH, maintenance long terme ?
  • Que ne faut-il surtout pas casser ?
  • 业务约束：法律法规、合规要求、服务水平协议（SLA）？
  • 技术约束：指定的技术栈、依赖项、遗留系统？
  • 时间约束：截止日期、外部依赖？
  • 资源约束：基础设施预算、人力、长期维护？
  • 绝对不能破坏的内容是什么？

3. Questions sur les ALTERNATIVES

3. 关于替代方案的提问

  • Quelles sont les 3 approches possibles ? (minimum)
  • Pourquoi celle-ci plutôt qu'une autre ?
  • Qu'a-t-on déjà essayé / envisagé ?
  • Existe-t-il une solution off-the-shelf (lib, SaaS) ?
  • Peut-on ne rien coder (config, manuel, process) ?
  • 有哪3种可行的方案？（至少3种）
  • 为什么选择这个方案而非其他？
  • 已经尝试/考虑过哪些方案？
  • 是否存在现成的解决方案（库、SaaS）？
  • 是否可以无需编码（配置、手动操作、流程调整）？

4. Questions sur les HYPOTHÈSES

4. 关于假设的提问

  • Qu'est-ce qu'on suppose sans avoir vérifié ?
  • Quel est le volume / trafic attendu ?
  • Quel est le pattern d'usage réel (95% cas / 5% edge cases) ?
  • Quels acteurs externes impliqués ? (API tierces, équipes, utilisateurs)
  • Que se passe-t-il si cette hypothèse est fausse ?
  • 哪些是未经验证的假设？
  • 预期的流量/数据量是多少？
  • 实际的使用模式是什么（95%常规场景 / 5%边缘场景）？
  • 涉及哪些外部参与者？（第三方API、其他团队、用户）
  • 如果这个假设不成立会发生什么？

5. Questions sur les CONSÉQUENCES

5. 关于影响的提问

  • Qu'est-ce qui change pour l'utilisateur final ?
  • Impact sur les autres features / modules ?
  • Coûts d'exploitation (infra, monitoring, support) ?
  • Comment rollback si ça tourne mal ?
  • Comment évolue cette solution dans 1 an, 3 ans ?
  • 对最终用户有什么改变？
  • 对其他功能/模块有什么影响？
  • 运维成本（基础设施、监控、支持）如何？
  • 如果出现问题如何回滚？
  • 这个解决方案在1年、3年后会如何演进？

Output attendu

预期输出

Après la phase brainstorm, produire une page (max) avec :
  1. Problème reformulé en 1-2 phrases
  2. Contraintes principales (5 bullets max)
  3. Option retenue + 2 alternatives rejetées avec raison
  4. Hypothèses clés à valider en début d'implémentation
  5. Risques identifiés + mitigations
头脑风暴阶段结束后，生成一页（最多）文档，包含：
  1. 重新表述的问题（1-2句话）
  2. 主要约束条件（最多5条）
  3. 选定方案 + 2个被否决的替代方案及原因
  4. 需在开发初期验证的关键假设
  5. 已识别的风险 + 缓解措施

Règles d'or

黄金法则

NE PAS sauter cette phase si :

若出现以下情况，请勿跳过此阶段：

  • La demande initiale contient le mot "peut-être", "probablement", "je pense"
  • Le demandeur n'est pas un utilisateur final
  • Multiple solutions semblent possibles à première vue
  • La feature touche du code legacy ou un domaine complexe
  • 初始需求中包含“也许”“可能”“我认为”等词汇
  • 需求提出者不是最终用户
  • 乍一看有多种可行方案
  • 功能涉及遗留代码或复杂领域

SAUTER cette phase si :

若出现以下情况，可跳过此阶段：

  • Bug obvious avec un seul fix possible
  • Typo / formatage / doc
  • Tâche < 10 min avec périmètre trivial
  • 明显的Bug且只有一种修复方式
  • 拼写错误/格式调整/文档修改
  • 耗时<10分钟的简单任务

Anti-patterns

反模式

Anti-patternSolution
Brainstorm infini sans décisionTimebox 30 min max
Questions rhétoriques (réponse évidente)Questions ouvertes et utiles
Répondre soi-même sans demanderVraiment poser les questions au demandeur
Skip brainstorm "parce que c'est urgent"L'urgence coûte 10x le brainstorm évité
Noter les réponses dans sa têteÉcrire = visible, revisitable, versionable
反模式解决方案
无休止头脑风暴却不做决策设定最长30分钟的时间限制
反问句（答案显而易见）提出开放式且有用的问题
自问自答而不询问他人真正向需求提出者提问
以“紧急”为由跳过头脑风暴紧急情况的代价是跳过头脑风暴的10倍
仅在脑中记录答案书面记录 = 可见、可回顾、可版本化

Intégration Claude Craft

Claude Craft 集成

  • /workflow:analyze
     — phase d'analyse BMAD commence par ce skill
  • /workflow:plan
     — PRD doit répondre aux 5 familles de questions
  • Agent 
    @product-owner
     — peut conduire le brainstorm avec le demandeur
  • Skill 
    atomic-tasks
     — l'output du brainstorm se découpe en tâches atomiques
  • Skill 
    architect
     — vient APRÈS le brainstorm pour les features architecturales
  • /workflow:analyze
     — BMAD分析阶段从此Skill开始
  • /workflow:plan
     — 产品需求文档（PRD）需涵盖5类问题的答案
  • Agent 
    @product-owner
     — 可引导需求提出者进行头脑风暴
  • Skill 
    atomic-tasks
     — 头脑风暴的输出可拆解为原子任务
  • Skill 
    architect
     — 针对架构相关功能，需在头脑风暴之后使用

Variante rapide : "5 Whys"

快速变体：“5个为什么”

Pour bugs ou causes racines, utiliser les 5 Whys de Toyota :
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
Cause racine : absence de checklist, pas le 500.
针对Bug或根本原因，可使用丰田的5个为什么方法：
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
**根本原因：**缺少PR检查清单，而非500错误。

Ressources

参考资源

Date de dernière mise à jour : 2026-04-15 Version : 1.0.0
**最后更新日期：**2026-04-15 **版本：**1.0.0