Spec-First

Brainstorm 详细指南 ​

Claude Code 使用 /spec:brainstorm，Codex 使用 $spec-brainstorm。契约见 spec-brainstorm。

Brainstorm 的职责是把一个方向或想法，收敛成 带边界和验收标准的需求。

输入与输出 ​

  • 输入：想法、问题或选定方向
  • 输出：docs/brainstorms/*.md

它负责定义：

  • 目标
  • 约束
  • 非目标
  • 验收标准

它不负责写实施计划，也不负责直接写代码。

什么时候运行 ​

适合：

  • 你已经知道大概要做什么，但边界还不清楚
  • 一个方向有多种做法，需要先讨论范围
  • 你想把模糊需求变成后续可规划的 artifact

如果方向都还没选好，先跑 Ideate 更合适。

使用方式 ​

Claude Code：

bash
/spec:brainstorm "给项目添加一个健康检查接口"

Codex：

bash
$spec-brainstorm "给项目添加一个健康检查接口"

执行逻辑图 ​

text
用户运行 /spec:brainstorm 或 $spec-brainstorm
  |
  v
读取想法、问题背景、现有 ideation、repo facts、standards 上下文
  |
  v
追问或整理不清楚的目标、约束、用户场景
  |
  v
明确目标、非目标、边界、验收标准
  |
  v
识别仍需留给 plan 或 implementation 的未知项
  |
  v
输出 docs/brainstorms/*-requirements.md
  |
  v
把 WHAT / WHY / 验收交给 spec-plan

你应该期待它产出什么 ​

一次好的 Brainstorm 结束后，应该得到一份能够支撑 Plan 的需求文档，而不是一堆零散对话。

理想结果通常包括：

  • 问题定义
  • 目标与限制
  • 非目标
  • 验收条件

它和 Plan 的边界 ​

Brainstorm 负责 ​

  • WHAT
  • WHY
  • 边界
  • 验收

Plan 负责 ​

  • HOW
  • 文件范围
  • 风险
  • 验证
  • 实施单元

常见误用 ​

  • 在 Brainstorm 里直接争论具体代码实现
  • 没有明确非目标，导致后续范围蔓延
  • 没有写清验收标准，导致 Plan 难以落地

下一步 ​