← Back to Skills Marketplace
sipoon

Brainstorming

by Sipoon · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ Security Clean
44
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sipoon-brainstorming
Description
自动追问澄清模糊需求,分步确认设计方案,确保代码实现前需求明确,降低返工风险,支持分块确认与TDD流程。
README (SKILL.md)

brainstorming

借鉴来源:Superpowers (obra/superpowers) 的 brainstorming skill

在动手写代码之前,先通过追问把需求搞清楚,展示设计方案给用户确认,再动手。

核心理念:写代码前不问清楚 = 返工成本 10x。


触发条件

满足以下任一场景时自动激活,无需用户调用:

  • 用户要求创建一个新的功能/模块/项目
  • 用户描述了一个需求,但没有明确的范围边界
  • 用户说"帮我做个 XXX"(模糊请求)
  • 用户要求实现某个功能,但没有说明输入/输出/边界条件

不适用于:纯搜索、纯阅读、简单确认、快速修复已知 bug。


工作流程

Step 1:追问澄清(不跳步)

遇到模糊需求,按以下清单追问:

[需求澄清]
1. 用户故事:谁在什么场景下需要这个功能?
2. 输入:数据从哪来?格式是什么?
3. 输出:期望的结果是什么?格式是什么?
4. 边界:什么情况算成功?什么情况算失败?
5. 优先级:这个功能的核心价值是什么?MVP 是什么?
6. 约束:有没有技术限制?性能要求?兼容性要求?

规则

  • 一次问 2-3 个最重要的问题,不要一次问完(减少用户认知负担)
  • 用户回答后继续追问,直到需求明确
  • 如果用户拒绝回答,告诉用户这会影响实现质量,让他决定是否继续

Step 2:产出设计文档(分块展示)

需求明确后,产出设计文档,但不要一次性全部展示,分块展示:

## 设计草案 v0.1

### 模块结构
[文字描述]

### 风险点
[列出 1-2 个最需要用户确认的点]

---
请确认以上方向是否正确,我会继续细化。

原则:每次展示用户能在 30 秒内读完的分量。

Step 3:用户确认 → 产出实施计划

用户确认设计后,产出实施计划:

## 实施计划(简化版)

| 阶段 | 任务 | 验收标准 |
|------|------|---------|
| Phase 1 | [任务描述] | [标准] |
| Phase 2 | [任务描述] | [标准] |

每个 Phase 完成后再进入下一个。

Step 4:TDD 循环(用户说"go"之后)

进入此步之前,必须先通过 grill-me 确认

  • 每个任务:先写失败测试 → 再实现 → 再验证
  • 每完成一个任务,主动报告进度
  • 遇到阻塞,立刻报告,不要等
  • 完成后 → 调用 skill-compounding 检查是否值得沉淀

关键原则

原则 说明
不猜需求 有歧义就问,不要假设
用户决策权 设计方向用户定,AI 只执行
分块确认 不一次性给完整方案,分段确认
先测试后实现 TDD 循环,减少返工
阻塞即升级 遇到问题立刻报告,不沉默

下一跳(Skill 链式调用)

brainstorming 是入口技能,完成后按以下路径自动调用:

brainstorming → grill-me → [implementation]
              ↘ agent-teams(需要多角度审查时)
              ↘ conductor(大型项目/多阶段任务)

下一跳触发条件

  • 设计确认后 → 自动调用 grill-me 做实施前最后确认
  • 需要多角色并行审查 → 调用 agent-teams
  • 项目规模大/多阶段 → 调用 conductor 接管后续流程
  • 解决方案有复用价值 → 调用 skill-compounding

与其他 Skill 的配合

  • skill-compounding:如果这个需求的解决方案值得复用,在完成后提取为 Skill
  • refactoring:如果发现现有代码结构不合理,先讨论再改
  • test-specialist:测试用例设计有疑问时调用

触发命令

自动触发,不需要用户手动调用。当检测到模糊需求时主动激活。

Usage Guidance
Install this if you want the agent to pause on unclear development requests, ask clarifying questions, and produce a staged plan before implementation. Avoid it if you prefer the agent to act directly on vague feature requests without a planning gate, and review any downstream skill handoff before letting it continue.
Capability Assessment
Purpose & Capability
The skill's stated behavior is coherent: clarify vague feature or project requests, produce small design drafts, wait for confirmation, and then guide implementation planning.
Instruction Scope
The activation language is broad and the skill says it can automatically chain to other planning/review skills, so users should expect it to take over ambiguous development requests with questions and staged planning.
Install Mechanism
The artifact contains only SKILL.md and a small _meta.json file; static scan found no executable scripts, dependency packages, or suspicious install behavior.
Credentials
No network access, credentials, local file indexing, account access, or external services are requested; the behavior is limited to conversational workflow guidance.
Persistence & Privilege
The skill mentions calling a skill-compounding step after completion to check whether work should be preserved as a reusable skill, but it does not itself persist data, install anything, or grant elevated privileges.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install sipoon-brainstorming
  3. After installation, invoke the skill by name or use /sipoon-brainstorming
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
- Initial release of the "brainstorming" skill, inspired by Superpowers' approach. - Automatically triggers when user needs are unclear or ill-defined, especially for new features or modules. - Guides users through iterative clarification, asking key questions in small batches to define requirements. - Produces step-by-step design drafts and implementation plans with user confirmation at each stage. - Integrates with other skills (grill-me, agent-teams, conductor, skill-compounding) for advanced workflows. - Focuses on minimizing rework by requiring clear, confirmed requirements and TDD-based implementation.
Metadata
Slug sipoon-brainstorming
Version 0.1.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Brainstorming?

自动追问澄清模糊需求,分步确认设计方案,确保代码实现前需求明确,降低返工风险,支持分块确认与TDD流程。 It is an AI Agent Skill for Claude Code / OpenClaw, with 44 downloads so far.

How do I install Brainstorming?

Run "/install sipoon-brainstorming" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Brainstorming free?

Yes, Brainstorming is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Brainstorming support?

Brainstorming is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Brainstorming?

It is built and maintained by Sipoon (@sipoon); the current version is v0.1.0.

💬 Comments