关于 brainstorm-workflow
brainstorm-workflow 是一个用于新功能设计到执行计划的技能,负责前置检查、设计文档路径确认和向 solve-workflow 移交。它将设计讨论委托给 brainstorming,并在获批后进入制定计划阶段,不负责编写代码。
主要功能
- 01检查所需技能是否已安装
- 02将缺陷根因分析转交其他工作流
- 03协调设计讨论并确认设计文档路径
- 04设计获批后移交制定计划
- 05支持手动与自动模式
适用场景
- 01将模糊的新功能需求整理为设计
- 02在编码前协作确定方案并形成规格
- 03把获批设计转换为执行计划
- 04将现有缺陷调查转交专用工作流
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ fudesign2008/ open-skills --skill brainstorm-workflow安装后在 Claude Code 中输入/brainstorm-workflow确认已加载。
附带文件reference.md
详细介绍
头脑风暴工作流
精简的设计到计划主机。设计对话由外部 Superpowers
brainstorming负责;实施计划由仓库内的solve-workflow「制定计划」负责。此主机负责前置条件检查、路径询问、终止阶段覆盖(不使用writing-plans)以及强制交接。它不是更严格的
solve-workflow。若要对 Bug 根因进行诊断或开展基于证据的排查 → 使用solve-workflow或opsx-solve-workflow。输出模板:reference.md。
定位
| 此主机 | 更适合的选择 |
|---|---|
| 新功能、需求模糊,或在编写代码前进行架构/设计 | — |
| 协作设计 → 已批准的规格说明 → 可执行计划 | — |
| Bug/回归问题/“为什么坏了?” | solve-workflow / opsx-solve-workflow |
| 已有获批计划,只需执行/验证 | 从「执行计划」开始使用 solve-workflow |
| 长时间无人值守地推进可验证目标 | goal-driven-workflow |
前置技能检查
启动时,检查 frontmatter 中的每一项 dependencies。如果有缺失项,则使用 reference.md 中的安装表中止——不得静默降级。
| 缺失的技能 | 安装 |
|---|---|
brainstorming | 安装 Superpowers(提供 brainstorming),例如从 https://github.com/obra/superpowers 安装平台插件;或者在 skills CLI 支持时运行 npx skills add https://github.com/obra/superpowers.git --skill brainstorming。目录/name 必须为 brainstorming。 |
solve-workflow | npx skills add FuDesign2008/open-skills -g --skill solve-workflow --yes |
**不得随仓库分发:**不要将 skills/brainstorming/ 添加到此仓库。
触发方式和模式
| 表述 | 模式 | 说明 |
|---|---|---|
| 「头脑风暴」「设计头脑风暴」「先设计再计划」「brainstorm workflow」 | 👤 手动 | 默认模式;在下方所列主机退出点暂停 |
| 「自动头脑风暴」「自动模式」+ 头脑风暴意图 | 🤖 自动 | 书面规格获批后,无需主机额外暂停,直接强制交接 |
**模式检测:**触发语包含「自动」→ 自动模式;否则为手动模式。运行期间可说「切换自动模式」/「切换手动模式」。
流程(仅主机编排)
0 Prerequisite check (brainstorming + solve-workflow)
1 Intent gate — if bug root-cause primary → redirect to solve / opsx-solve; abort this host
2 Load brainstorming — follow it for context → clarify → approaches → sectional design → write spec → self-review → user reviews written spec
Host overrides (MUST win over brainstorming defaults):
- Before write: ask save path; recommend docs/design/YYYY-MM-DD-<topic>-design.md
- After written-spec approval: do NOT invoke writing-plans
3 Hard handoff — load solve-workflow at「制定计划」(Make a Plan); skip solve stages 1–4; pass design path + summary
4 Stop at solve stage-5 exit (plan confirmation) — further execute/verify is solve-workflow, not this host
主机退出点
| 阶段 | 👤 手动 | 🤖 自动 |
|---|---|---|
| 意图检查后(需要重定向时) | 停止;告知用户使用 solve | 相同 |
| 编写设计前询问路径 | 等待用户提供路径/接受默认路径 | 如果用户已表示使用自动模式且主题明确,可接受推荐默认路径;但仍须说明所用路径 |
| 用户批准书面规格说明后 | 确认一次交接 | 直接强制交接 |
| 在 solve 的 Make a Plan 阶段内 | 遵循 solve-workflow 第 5 阶段规则 | 遵循 solve-workflow 自动模式规则 |
阶段详情
0–1. 检查
- 执行前置技能检查。
- 如果用户的主要目标是定位/修复现有行为中的缺陷(根因),则重定向至
solve-workflow/opsx-solve-workflow,并中止此主机(不要用头脑风暴代替analysis-core)。
2. 将设计工作交由 brainstorming
加载 brainstorming 并遵循其检查清单(探索上下文、每轮只问一个问题、提出 2–3 种方案、分阶段审批设计、编写设计文档、自行审查规格说明、请用户审阅书面规格说明)。
覆盖规则(以主机为准):
- 保存路径——编写设计文件前,询问保存位置。建议使用:
docs/design/YYYY-MM-DD-<topic>-design.md。用户偏好优先。除非用户选择该路径,否则不要静默使用docs/superpowers/specs/。 - 终止阶段——用户批准书面规格说明后,不要调用
writing-plans。直接强制交接(§3)。
Visual Companion 和 brainstorming 的其他可选工具仍按该技能的定义使用(仅基于意图;此主机不硬编码任何平台工具)。
3. 硬性交接至 solve-workflow 制定计划
- 加载
solve-workflow。 - 仅进入 Stage 5 — 制定计划(此工作项跳过 Stage 1–4)。
- 提供交接所需输入(reference.md § 交接载荷):已批准的设计路径、简短摘要(目标、选定方案、约束、非目标)。
- 按照
solve-workflow的 Stage 5 制定计划。此宿主绝不能编写业务代码或生产代码。
计划确认后,如果用户希望实现,可以在 solve-workflow 中继续(「执行计划」……)——这不属于此宿主的成功标准。
危险信号
- 用户要求分析 Bug 根因时却开始设计对话
- 设计获批后调用
writing-plans - 未询问路径便编写设计文档(除非用户已自动接受所公布的默认路径)
- 同一设计成功交接后,再次运行
solve-workflow的 Stage 1–4 - 缺少
brainstorming或solve-workflow时静默降级 - 将
brainstormingvendoring 到此代码库