brainstorming

name	brainstorming
description	在任何创造性工作前执行此步骤——包括创建功能、构建组件、添加功能或修改行为。在实施前探究用户意图、需求与设计方案。通过自然协作对话，将创意转化为完整的设计方案与规格说明。当用户提及"新功能"、"构建"、"创建组件"、"添加功能"、"实现"或开始任何开发工作时触发本技能。本技能会自动调用 project-context 技能获取用户画像和流程路径推荐。
license	MIT
metadata	{"version":"3.0.0"}

头脑风暴技能

本技能是任何创造性工作前的必经步骤，通过协作对话将创意转化为完整的设计规格说明。

---

核心原则

设计优先

在用户批准设计文档前，请勿：

• 调用任何实施技能
• 编写任何代码
• 搭建项目框架
• 采取任何实施行动

会话状态管理

使用统一的会话状态文件跟踪进度：

• 路径：design/.session-state.md
• 模板：references/session-state-template.md

操作时机：

• 技能激活时 → 创建状态文件
• 获得用户确认后 → 更新状态文件
• 每轮对话开始时 → 读取状态文件恢复上下文
• 每个阶段完成后 → 更新状态文件

终止条件

本技能的唯一终止方式是调用 writing-plan 技能，并传递规格文档路径。

---

工作流程

阶段 1：探索背景

目标：了解当前项目状态，评估需求范围。

执行动作：

1. 调用 project-context 技能获取用户画像
2. 读取项目上下文（如有）：design/context/project-context.md
3. 检查项目文件结构
4. 评估需求是否涉及多个独立子系统
5. 主动更新用户画像（如果识别到新的偏好或技术背景）

范围检查：

• 若请求涉及多个独立子系统，协助用户分解为子项目
• 每个子项目独立进行头脑风暴

完成标准：已了解项目技术栈和现有结构，已确认需求范围，用户画像已更新（如有变化）

---

阶段 2：确认需求

目标：逐条理解目标、约束条件和成功标准。

执行规则：

• 每条消息只提一个问题
• 优先使用选择题形式

核心问题清单（按顺序询问）：

序号	问题类型	示例问题
1	目标定位	"这个功能的主要用户是谁？"
2	约束条件	"有没有时间或技术栈的限制？"
3	成功标准	"如何判断这个功能是否成功交付？"
4	边界情况	"有没有需要特别处理的边界情况？"

完成标准：目标定位明确、约束条件清晰、成功标准可验证

---

阶段 3：方案选择

目标：提供 2-3 种不同方案及其权衡分析。

执行动作：

1. 提出 2-3 种不同方案
2. 说明每种方案的优缺点
3. 给出推荐方案及理由

完成标准：用户已选择一个方案

参考：references/tech-selection-guide.md

---

阶段 4：设计文档

目标：将验证通过的设计写入规格文档。

执行动作：

1. 创建规格文档：design/specs/YYYY-MM-DD-<topic>-design.md
2. 包含所有已确认的内容
3. 确保无 TODO、TBD 或占位符

文档结构：

章节	内容要求
概述	功能目标、背景上下文
目标定位	主要用户和使用场景
约束条件	技术、时间、资源限制
成功标准	可验证的交付标准
架构设计	系统结构和组件划分
数据流	数据如何流转
错误处理	异常情况处理策略
测试策略	如何验证功能正确性

完成标准：文档已写入指定路径，无占位符内容

参考：references/spec-template.md

---

阶段 5：交接

目标：获得用户批准，调用 writing-plan 技能。

执行动作：

1. 呈现规格文档路径给用户
2. 请用户审阅并确认
3. 若用户批准，调用 writing-plan 技能

标准话术：

"规格文档已编写并提交至 <path>。请审阅，确认后我将开始制定实施计划。"

调用格式：

调用 writing-plan 技能，规格文档路径：<path>

终止：此阶段完成后，本技能结束。

---

参考指南

参考文档	用途
references/session-state-template.md	会话状态文件模板
references/spec-template.md	规格文档模板
references/tech-selection-guide.md	技术选型指导
references/risk-assessment-template.md	风险评估模板

---

常见问题

用户坚持跳过设计直接实施？

回复：

"我理解您希望快速推进。设计文档可以很简短，但需要记录并获得您的批准，这能确保我们对目标达成共识，避免后续返工。"

项目范围过大怎么办？

处理方式：

1. 标记为多子系统项目
2. 协助用户分解为独立子项目
3. 对第一个子项目开始头脑风暴
4. 每个子项目独立进行规格→规划→实施循环

对话中断后如何恢复？

处理方式：

1. 读取会话状态文件 design/.session-state.md
2. 根据"下一步"继续执行