---
name: 01-brainstorm
description: "需求发现与工业级规格定义。梳理产品定位、成功标准、明确做与不做边界、用户路径与状态矩阵，产出高质量需求规范文档。"
---

# 01-brainstorm: 需求发现与工业级规格定义

当用户提出新功能、新项目想法，或需要明确需求边界与技术方案时使用本技能。
本技能拒绝输出泛泛而谈的空洞大白话，必须产出**经得起工程推演的高质量需求规格书**。

## 核心目标

1. **挖掘需求本质与成功标准**：回答「做什么、不做什么、做成什么样才算成功」。
2. **多维度交互决策（按需灵活提问）**：
   - 涉及技术决策、范围确认或设计权衡时，调用 `ask_user_question`。
   - **自然选择提问形式**：
     - **互斥决策（单选）**：如方案 A vs B、架构选型，使用单选模式（`multiSelect: false`），用户按数字键 `1`–`9` 极速直选。
     - **组合选择（多选）**：如可选特性清单、支持的多端平台，设置 `multiSelect: true`，用户通过复选框勾选。
     - **开放问题（自定义输入）**：如业务背景或特殊限制，直接开放文本输入。
3. **固化高质量产物**：调用 `artifact_helper` 写入 `docs/brainstorms/YYYY-MM-DD-<topic>-requirements.md`。

## 需求规格说明书必须包含的 5 大板块

调用 `artifact_helper({ repoRoot: ".", artifactType: "brainstorm", topic: "<topic-name>", ensureDir: true })` 获取路径，文档必须具备以下深度：

### 1. 产品定位与成功标准 (Product Positioning & Success Criteria)
- **一句话定义**：用最精准的话说明这是个什么系统。
- **用户主任务**：用户打开该系统/特性的第一主线流程。
- **成功标准（人话定义）**：列出 3~5 条具体的成功表现（例如：“干净环境首次启动不报异常”、“网络中断时自动重试且不覆盖有效配置”）。

### 2. 参考与取舍 (References & Tradeoffs)
- 参考了哪些已有成熟方案或竞品？
- **采纳什么** vs **明确不采纳什么**（防止引入劣质模式或过度复杂的抽象）。

### 3. 严格范围与边界 (Scope & Non-Goals)
- **明确做 (In-Scope)**：本次迭代承诺交付的核心能力清单。
- **明确不做 (Explicit Non-Goals - 极其关键)**：明确拒绝的边缘需求与镀金功能，防止 AI 自作聪明过度设计。
- **与后续版本的边界**：哪些留待 v2 / 以后再做。

### 4. 关键用户路径与状态矩阵 (User Journeys & State Matrix)
- 至少推演 2 条核心路径，每条必须包含：
  - **初始/空状态** 长什么样
  - **进行/加载中** 长什么样
  - **成功与失败回退** 长什么样（失败时如何保护现场不崩溃）

### 5. 技术约束与平台边界 (Constraints & Platform Matrix)
- 语言版本、核心依赖库版本、跨平台支持矩阵（Windows / macOS / Linux 差异）。

## 流程结语
向用户展示产物核心摘要，并建议下一步：运行 `/skill:02-plan` 进入架构拆解与 TDD 计划制定。