Brainstorm 是一个“把想法变成设计”的头脑风暴工作流技能,宿主中立,按技能名 brainstorm 调用。其核心原则是:分析主题、动态选择相关智能体、并行探索备选方案、增量呈现设计。
【用途】 将粗略想法转化为成形设计,通过智能体选择与结构化探索完成。适用于需求尚不明确、存在多种可能方案、需要评估取舍的设计前期阶段。资料明确列出不适合使用的场景:需求已非常清晰具体、只有一种显而易见方案、用户已完成设计、时间敏感的紧急修复。
【主要能力】
- 七阶段流程:0 主题分析(分类关键词、选择 3-5 个智能体);1 记忆与上下文(搜索知识图谱、检查代码库、读取实验日志);2 发散探索(不加过滤地生成 10+ 个想法);3 保留/丢弃门(每个想法约 10 秒做二元可行性判断:保留、丢弃或崩溃);4 评估与评分(7 个维度 0-10 分,含简洁性,并设“魔鬼代言人”);5 综合(筛选出前 2-3 个,给出取舍表与每个方案的测试策略);6 设计呈现(按 200-300 字分段呈现,并记录到实验日志)。
- 参数解析:TOPIC 取完整参数字符串,例如“API design for payments”。
- MCP 探测与恢复:技能启动时探测一次 MCP 服务器并存储能力,可从先前崩溃的会话恢复;每个阶段输出 JSON 交接文件供下一阶段消费。
- 项目上下文发现:先加载上下文,检测项目层级(Interview、Hackathon、MVP、Growth、Enterprise、Open Source),作为下游所有决策的复杂度上限;置信度低时通过 AskUserQuestion 询问用户,用户可覆盖检测结果。
- 用户意图确认:通过 AskUserQuestion 澄清探索类型(开放探索、对比、快速构思、迭代优化)、约束偏好(无、沿用现有模式、最小化复杂度、固定需求)以及是否先做研究(Plan-first)。
- 编排模式选择:Agent Teams(网状,智能体实时辩论与互相挑战,推荐 3+ 智能体,约 400K tokens)或 Agent 工具(星型,全部向 lead 汇报,约 150K tokens,适合快速构思);可用 ORCHESTKIT_FORCE_TASK_TOOL=1 强制使用 Agent 工具;Agent Teams 出问题时回退到 Agent 工具。
- 努力感知的阶段缩放:读取 /effort 设置缩放深度,low 只跑阶段 0/2/5,high(默认)跑全部 7 个阶段,xhigh 增加额外的魔鬼代言人与综合轮次;用户在 STEP 0a 的显式选择始终覆盖缩放。
- 任务管理:强制创建主任务与各阶段子任务,并设置顺序依赖链(2→3→4→5→6→7→8)。
- 增量输出:每个阶段后立即向用户展示结果,阶段 2 的并行智能体返回一个就展示一个,便于用户及早调整方向。
- 可选扩展:阶段 6.4 Living Plan Playground(用户要求或综合产出多波次计划时,通过 visualize-plan 的 living-plan 路径生成可更新的 <slug>.html,一个计划一个文件);阶段 6.5 音频播客(当 composite≥8.0 且 approaches≥4 时,运行 scripts/post_synth_podcast.py 自动生成 brainstorm-podcast.m4a,非正常路径自动跳过)。
【使用方式】 按技能名 brainstorm 调用,传入主题参数。Claude Code 斜杠路由、YAML hook 加载器与 .claude/chain 位于 references/claude-code.md。技能启动时执行 MCP 探测与恢复检查,随后加载项目上下文(运行 prior-decisions-loader 与 brainstorm-instructions-loader 两个 hook),检测项目层级,确认用户意图,选择编排模式,再进入七阶段流程。详细阶段说明见 references/phase-workflow.md。
【适用场景与智能体选择示例】 API 设计:workflow-architect、backend-system-architect、security-auditor、test-generator;仪表盘 UI:workflow-architect、frontend-ui-developer、test-generator;RAG 管道:workflow-architect、llm-integrator、data-pipeline-engineer、test-generator;缓存策略、设计系统、事件溯源、定价策略、部署管道等各有对应智能体组合。始终包含 workflow-architect(系统设计视角)与 test-generator(可测试性评估)。
【限制】 AskUserQuestion 每题最多 4 个选项,仅使用 label 与 description,不使用 preview 字段。阶段 2 在所选模式需要时必须通过 Workflow 调用、Agent Teams 或 Agent 工具执行扇出;若均未生成智能体,则以 BLOCKED 结束并说明原因;跳过阶段 2 的模式(对比、迭代优化、约束设计)不算违规。完成标准是:顶级方案在全部七个维度上打分,并呈现取舍供用户选择。播客功能依赖 yg-mcp-core>=0.3.0(位于私有 pypi)与 hq-content MCP,不可用时自动跳过。