简介
日常开发中，即使是看似简单的修改，未经推敲的假设也往往会导致大量无效劳动。brainstorming 技能正是为了解决“需求未明确就动手写代码”的痛点。它作为一个强制性的前置设计关卡，要求 AI 在编写任何逻辑前，必须先与开发者进行结构化的沟通，将模糊的意图转化为确定的设计规范（Spec）。这不仅避免了方向性错误，也为后续的实现提供了清晰的依据。
理念
先设计，后实现。强制要求 AI 在动手写代码前了解项目背景、澄清约束条件，并输出规范的设计文档。用低成本的早期沟通，替代高昂的代码重构成本。
安装使用
有很多种方法可以安装 skill：
- 安装方法1：在 OpenClaw 或 Hermes Agent 的聊天窗口，直接告诉 Agent：请帮我安装
brainstorming技能。（最简单） - 安装方法2：访问 skillhub 网站，先安装 skillhub 商店，然后再安装对应的技能。（适用于中国用户）
- 安装方法3：访问 Skills.sh 网站，在首页搜索对应技能的名称，然后使用网站提供的命令安装。（适用于有技术经验的用户）
- 安装方法4：访问 Clawhub 网站，在首页搜索对应技能的名称，点击下载按钮下载压缩包，解压后放到 OpenClaw 的 skills 目录下。
Skill 工作流程剖析
- 探索项目背景：在提问前，强制 AI 检查工作区现有的文件、文档和最近的提交记录，确保对项目上下文有初步了解。
- 提供视觉辅助（可选）：如果讨论涉及界面或布局，AI 会单独发送一条消息询问是否需要启动基于浏览器的视觉预览工具（Visual Companion），将视觉确认与逻辑确认解耦。
- 单步澄清机制：严格限制 AI 每次只能抛出一个问题。这避免了信息过载，确保开发者能针对每个约束条件或成功标准给出准确的反馈。
- 提供多维方案：禁止 AI 直接采用第一直觉。它必须提供 2 到 3 种具备不同技术权衡（Trade-offs）的架构选项，并附上推荐理由，帮助开发者跳出思维定势。
- 渐进式设计确认：将复杂的系统设计拆解为小模块（如架构、组件、数据流）。开发者确认一个模块后，再推进下一个模块，构建安全的验证闭环。
- 生成并自审设计文档：沟通结束后，AI 会生成一份 Markdown 格式的物理设计文档（Spec），并进行内联自检，排除任何“待定（TBD）”、占位符或含糊不清的描述。
- 强制阻断与衔接：整个流程的最终节点，必须是调用下一个规划技能（
writing-plans）。这是一个硬性关卡（Hard Gate），彻底杜绝 AI 绕过规划直接写代码的可能。