Brainstorming

头脑风暴技能

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

---

核心原则

设计优先

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

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

会话状态管理

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

• 路径：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--design.md
2. 包含所有已确认的内容
3. 确保无 TODO、TBD 或占位符

文档结构：

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

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

> 参考：references/spec-template.md

---

阶段 5：交接

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

执行动作：

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

标准话术：

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

调用格式：

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

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

---

参考指南

| 参考文档 | 用途 | | ---------------------------------------- | ---------------- | | 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. 根据"下一步"继续执行

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: supper-skills
• Source: supper-skills/develpment-skills
• License: MIT

Install and usage instructions live in the source repository linked above.