用途:brainstorming 是一套“先设计后编码”的方法论,主张理解先于实现,在动手写代码前先通过协作对话把想法转化为完整的设计与规格。适用于创建新功能、构建新组件、添加重要功能、修改核心行为,以及任何耗时超过 30 分钟的任务;简单且解法明确的缺陷修复、文档更新和琐碎配置变更可跳过。
主要能力:流程分为四阶段。第一阶段理解想法,先查看相关文件、文档、近期提交与既有模式,再用 AskUserQuestion 工具一次只问一个问题,聚焦目的、约束、成功标准与边界情况。第二阶段探索方案,始终给出 2-3 种带取舍的方案并说明推荐理由。第三阶段分段呈现设计,每段 200-300 字,逐段确认。第四阶段把设计写入 docs/plans/YYYY-MM-DD-<topic>-design.md 并提交到 git。
必要用法:所有提问必须使用 AskUserQuestion 工具,尽量提供多选项,开放式问题也走该工具(用户可用 Other 选项),每次工具调用只问一个问题。设计文档模板包含问题陈述、目标与非目标、架构、组件、数据流、错误处理、测试策略、开放问题与决策日志。
限制与要求:设有“幻觉防火墙”要求,推荐任何第三方库前必须用 npm info 或等价方式验证,并至少提供一个反方架构(steel-man)来挑战主推荐。需避免一次问多个问题、直接跳到实现、假设需求、一次呈现上千字设计、忽略取舍、跳过边界情况等反模式。可与 @planning-mastery、@git-worktrees、@tdd-mastery、@clean-code 等技能衔接,也可通过 /maestro design [feature description] 显式触发。