SuperAPI AI 工具集

brainstorming

编程与开发

查看项目

更新于 10-26 16:20

技能介绍

这是一个 Claude 插件中的“头脑风暴”技能,用于在创建功能、组件或添加功能时,先通过结构化提问完善需求,再进入 APEX Analyze 阶段。其核心原则是设计优先,在获得设计批准前不写代码。

适用场景:新功能、重大变更、组件创建时执行完整的六步头脑风暴流程;对于 1-3 行的琐碎修复、拼写错误或简单重命名,则直接跳过头脑风暴进入 APEX。

强制智能体工作流:在进行任何头脑风暴会话之前,需并行生成智能体,每个带名称的 Agent 调用各一个:fuse-ai-pilot:explore-codebase 用于理解项目上下文、模式与约束;fuse-ai-pilot:research-expert 用于获取最佳实践与文档。设计批准后,过渡到 APEX Analyze 阶段,并在交接中一并传递 explore-codebase 与 research-expert 的发现(不仅是设计文档)。APEX Analyze 默认会重新运行相同的智能体,因此携带此处已收集的成果可避免重复研究。

六步流程:

第 1 步:探索项目上下文。提问前先收集上下文,包括 git log --oneline -20 查看近期变更与方向、既有代码模式与约定、相关文档与既往决策、技术栈与依赖约束。

第 2 步:逐个提出澄清问题。按顺序提出聚焦问题,等待每个回答后再问下一个。问题类别包括目的、约束、成功标准、用户、集成。

第 3 步:先发散,再收敛到 2-3 个方案。通过命名技术(SCAMPER / 逆向头脑风暴 / 类比)生成至少 6-8 个截然不同的方案,暂缓判断,而不是同一想法的三种规模。然后收敛到 2-3 个,并以表格形式列出权衡(方案、优点、缺点、建议)。始终给出明确建议及理由。

第 4 步:展示设计以供批准。将设计拆分为易理解的章节:架构概览、关键组件与职责、数据流与状态管理、边界情况与错误处理。等待用户明确批准后再继续。

第 5 步:保存设计文档。将批准的设计保存到 docs/plans/YYYY-MM-DD-<topic>-design.md。

第 6 步:过渡到 APEX。将批准的设计作为输入交接给 APEX Analyze 阶段。

参考指南:工作流参考 workflow.md,用于问题类别、提案格式、设计模板;反模式参考 anti-patterns.md,用于识别跳过头脑风暴的合理化借口。

关键规则:设计批准前绝不写代码;问题一次只问一个,不要一次抛出 10 个问题;始终提出替代方案,至少 2 个带权衡的方案;保存设计文档,以创建审计线索与共享参考;获得明确批准(如“看起来不错”或类似表述)后再继续。