| name | sillyspec:brainstorm |
| description | 用于正式开始开发前的需求澄清和技术方案设计。适合用户提出新功能、新模块、架构调整、复杂改造，或说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"。产出结构化方案（design/proposal/requirements/tasks 四件套），但不直接写代码。 |
交互规范
当需要用户从多个选项中做出选择时，必须使用 Claude Code 内置的 AskUserQuestion 工具，将选项以参数传入。 不要用编号列表让用户手动输入数字。
何时使用
- 用户提出新功能、新模块、架构调整、复杂改造
- 用户说"先做需求分析、输出技术方案、创建变更前先梳理、帮我设计下"
- 产出：
design.md + proposal.md + requirements.md + tasks.md（四件套），不写代码
多变更说明
项目有多个活跃变更（.sillyspec/changes/ 下有多个目录）时，所有 sillyspec run 命令需加 --change <变更名> 指定操作目标；只有一个变更时可省略（CLI 自动检测）。建议变更名格式：YYYY-MM-DD-<简短描述>。
步骤生命周期（所有阶段通用）
sillyspec brainstorm 是 sillyspec run brainstorm 的顶层别名，两者等价。
sillyspec run brainstorm
sillyspec run brainstorm --done --output "摘要"
sillyspec run brainstorm --status
sillyspec run brainstorm --skip
sillyspec run brainstorm --reset
sillyspec run brainstorm --reopen --from-step N
sillyspec run brainstorm --wait --reason "..." --options "A,B"
sillyspec run brainstorm --continue --answer "..."
sillyspec run brainstorm --done --answer "..." --output "..."
通用参数（所有阶段适用）
| 参数 | 说明 |
|---|
--change <名> | 指定变更名（多活跃变更必填，单变更可省略自动检测） |
--spec-dir <path> | 指定规范目录（默认 <项目>/.sillyspec） |
--non-interactive | CI/脚本下禁用交互式 prompt |
--interactive | 强制交互（即便 stdin 非 TTY） |
--skip-approval | 跳过审批/校验门控（需明确意图） |
--json | 输出 JSON（程序化读取） |
brainstorm 特有：requiresWait 步骤
某些步骤（如"对话式探索"）需要用户输入。两种方式：
- 方式一（推荐）：AI 自行与用户交互后，一步完成：
sillyspec run brainstorm --done --change <名> --answer "用户回答" --output "需求已澄清"
- 方式二：分步——先
--wait 记录等待，再 --continue --answer，最后 --done：
sillyspec run brainstorm --wait --change <名> --reason "等待用户回答" --output "探索问题"
sillyspec run brainstorm --continue --answer "用户回答" --change <名>
sillyspec run brainstorm --done --change <名> --output "需求已澄清"
阶段流转
scan → brainstorm → plan
brainstorm 完成后（四件套齐 + 自审通过），运行 sillyspec run plan --change <变更名> 进入实现计划。
铁律
- 必须用 exec 工具（shell）执行 CLI，不要自己编造流程
- 只做当前步骤 prompt 描述的操作，不跳过、不自行扩展
- 产物写入 CLI 输出的
changeDir 目录（如 <changeDir>/design.md），不要自己拼路径
- 完成后立即
--done，不跳过
用户指令
$ARGUMENTS
