⚡

头脑风暴Skill brainstorming

此技能用于将粗略想法转化为可实施的设计文档，通过结构化协作对话澄清需求、探索选项，并生成架构、BDD规范等。适用于软件开发、产品管理和需求分析，关键词包括：头脑风暴、设计文档、BDD规范、协作、软件开发、架构设计、需求澄清、测试优先。

架构设计 0 次安装 0 次浏览 更新于 3/16/2026

name: 头脑风暴 description: 当用户有新想法、功能请求或模糊需求时使用此技能。它澄清需求、探索选项，并在实施开始前生成坚实的设计文档和BDD规范。 user-invocable: true version: 2.1.0

将想法转化为设计

通过结构化协作对话，将粗略想法转化为可实施的设计。

初始化

  1. 上下文检查: 确保阅读了 CLAUDE.md 和 README.md 以理解项目约束。
  2. 代码库索引: 验证是否访问代码库并能运行搜索。

核心原则

  1. 顺序收敛: 澄清 → 比较 → 选择 → 设计 → 提交 → 过渡
  2. 上下文优先: 探索代码库后再提问
  3. 增量验证: 每个阶段验证后再进行下一步
  4. 严格遵循YAGNI: 仅包括明确需要的内容
  5. 测试优先思维: 始终包括BDD规范 - 加载 superpowers:behavior-driven-development 技能

阶段1: 发现

先探索代码库，然后提问澄清需求。

动作:

  1. 探索代码库 - 使用读取/搜索/全局查找相关文件和模式
  2. 审查上下文 - 检查文档、README.md、CLAUDE.md、最近提交
  3. 识别差距 - 确定代码库中不清楚的内容
  4. 提问 - 使用AskUserQuestion工具，每次调用只问一个问题
    • 倾向于多项选择（2-4个选项）
    • 一次问一个，不要捆绑
    • 基于探索差距

输出: 清晰的需求、约束、成功标准和相关模式。

参见 ./references/discovery.md 获取详细模式和问题指南。 参见 ./references/exit-criteria.md 获取阶段1验证检查表。

阶段2: 选项分析

研究现有模式，提出可行选项，并获得用户批准。

动作:

  1. 研究 - 搜索代码库中的类似实现
  2. 识别选项 - 提出基于代码库现实的2-3个选项，或解释“无替代方案”
  3. 展示 - 以对话方式写作，首选推荐选项，解释权衡
  4. 获取批准 - 使用AskUserQuestion，一次问一个问题直到明确

输出: 用户批准的方法，理解原理和权衡。

参见 ./references/options.md 获取比较和展示模式。 参见 ./references/exit-criteria.md 获取阶段2验证检查表。

阶段3: 设计创建

并行启动子代理进行专门研究，集成结果，并创建设计文档。

核心子代理（始终需要）:

子代理1: 架构研究

  • 重点: 代码库中现有模式、架构、库
  • 使用WebSearch获取最新最佳实践
  • 输出: 架构建议和代码库参考

子代理2: 最佳实践研究

  • 重点: 网络搜索最佳实践、安全、性能模式
  • 加载 superpowers:behavior-driven-development 技能
  • 输出: BDD场景、测试策略、最佳实践总结

子代理3: 上下文和需求合成

  • 重点: 合成阶段1和阶段2结果
  • 输出: 上下文总结、需求列表、成功标准

额外子代理（根据项目复杂性启动）:

为不同、研究密集型方面启动额外专门子代理。每个代理应有单一、明确职责，并接收完整上下文。

集成结果: 合并所有发现，解决冲突，创建统一设计。

设计文档结构:

docs/plans/YYYY-MM-DD-<话题>-设计/
├── _index.md              # 上下文、需求、原理、详细设计、设计文档部分（必须）
├── bdd-specs.md           # BDD规范（必须）
├── architecture.md        # 架构细节（必须）
├── best-practices.md      # 最佳实践和注意事项（必须）
├── decisions/             # ADRs（可选）
└── diagrams/              # 视觉工件（可选）

关键: _index.md 必须包括设计文档部分，带有引用:

## 设计文档

- [BDD规范](./bdd-specs.md) - 行为场景和测试策略
- [架构](./architecture.md) - 系统架构和组件细节
- [最佳实践](./best-practices.md) - 安全、性能和代码质量指南

输出: 创建设计文件夹，所有文件已保存。

参见 ./references/design-creation.md 获取子代理模式和集成工作流。 参见 ./references/exit-criteria.md 获取阶段3验证检查表。

Git提交

将设计文件夹提交到git，使用适当消息格式。

参见 ../../skills/references/git-commit.md 获取详细模式、提交消息模板和要求。

关键要求:

  • 提交整个文件夹: git add docs/plans/YYYY-MM-DD-<话题>-设计/
  • 前缀: docs:（小写）
  • 主题: 少于50个字符，小写
  • 页脚: Co-Authored-By，包括模型名称 参见 ./references/exit-criteria.md 获取阶段4验证检查表。

阶段4: 过渡到实施

  1. 提问: “准备好为实施设置吗？”
  2. 调用 superpowers:writing-plans 使用技能工具，传递设计文件夹路径
    • 必须: 创建详细实施计划
    • 禁止: 不要使用平台规划功能
    • 禁止: 不要直接开始实施

质量检查

参见 ./references/exit-criteria.md 获取:

  • 所有阶段的完整验证检查表
  • 高质量头脑风暴会话的成功指标
  • 要避免的常见陷阱

参考

每个阶段的详细指南:

  • ./references/core-principles.md - 指导工作流的核心原则
  • ./references/discovery.md - 探索模式和问题指南
  • ./references/options.md - 选项比较和展示模式
  • ./references/design-creation.md - 子代理模式、集成工作流、设计结构
  • ../../skills/references/git-commit.md - Git提交模式和要求
  • ./references/exit-criteria.md - 验证检查表、成功指标、常见陷阱