拒绝无效返工！Brainstorming帮你理清需求再写代码，Cursor写码绝配🔥

你是否经历过一上来就狂写代码，最后发现需求理解偏差不得不推倒重来的崩溃时刻？💡 Brainstorming Agent 就是为了终结这种“低效勤奋”而生的。作为一个强制“设计先行”的智能辅助工具，它不像其他AI那样急于生成代码，而是扮演一位严谨的技术Tech Lead，按住你想敲代码的手，先通过深度对话帮你理清思路、确定架构，最终生成完美的设计文档。这才是资深工程师该有的工作流！

核心功能

Brainstorming Agent 的核心逻辑非常清晰，它通过一套严格的流程控制，确保在写下第一行代码前，你的设计是无懈可击的。

• 全上下文感知：自动读取项目当前的文件结构、文档和最近的提交记录，比你更懂项目的现状。
• 苏格拉底式发问：它不会直接给答案，而是通过“一次一个问题”的方式，引导你思考需求背后的目的、约束条件和成功标准。
• 多方案权衡：针对你的需求，它会主动提出2-3种技术实现路径，并详细列出每种方案的优缺点（Trade-offs），帮你做出最优选择。
• 强制设计关卡（Hard-Gate）：这是它最独特的地方——在设计方案得到你明确批准之前，它绝对禁止调用任何代码生成工具，从根源上杜绝了“想当然”的编程习惯。
• 自动生成设计文档：确认方案后，它会自动在 `docs/plans/` 目录下生成规范的Markdown设计文档，让你的思路有迹可循。

适用平台

该 Skill 经过精心调优，完美适配主流 AI 编程助手，尤其在 Cursor, GitHub Copilot, Claude Code, OpenAI Codex, Gemini Code Assist, 文心快码, 腾讯云 CodeBuddy, 华为云 CodeArts 等环境中表现卓越。它能极大增强这些 IDE 的上下文理解能力，让 AI 从“代码补全工具”进化为“架构设计伙伴”。

实操代码示例

Brainstorming Agent 的产出不仅仅是对话，而是实实在在的工程文件。当你与 Agent 完成交互后，它会标准化地生成如下路径的设计文档：

docs/plans/2023-10-27-user-auth-refactor-design.md

文档内容的结构通常如下所示（自动生成）：

# User Authentication Refactor Design

## Overview
Refactoring the auth flow to support OAuth2 providers...

## Architecture
- New Service: AuthService
- Database: Add `oauth_provider` column to `users` table

## Data Flow
1. Client requests login URL
2. Server generates state and redirects...

## Testing Strategy
- Unit tests for token parsing
- E2E tests for login flow

优势分析

相比于直接让 AI 写代码，使用 Brainstorming Skill 有着降维打击般的优势：

• 拒绝 YAGNI：它会 ruthlessly（无情地）砍掉不需要的功能，确保你只做最有价值的事。
• 消除隐性假设：通过不断的追问，把那些你脑海中模糊的“应该大概是这样”变成了明确的“必须是这样”。
• 文档即代码：自动沉淀的技术文档，不仅方便当前开发，更为后期的维护和团队协作留下了宝贵的资产。
• 无缝衔接实现：设计一旦确认，它可以直接无缝调用 `writing-plans` Skill，进入具体的实施阶段，整个过程行云流水。

应用场景

• 新功能开发：当你接手一个模糊的需求（如“做一个积分系统”）时，用它来拆解业务逻辑。
• 复杂重构：在修改遗留代码前，利用它梳理现有逻辑和重构风险，避免牵一发而动全身。
• Bug 修复：对于逻辑复杂的 Bug，先分析根本原因（Root Cause Analysis），再设计修复方案。
• 技术选型：当你在犹豫是用 Redis 还是 Memcached 时，让它帮你列出优劣对比。

最佳实践

为了最大化 Brainstorming Agent 的威力，建议遵循以下工程化规范：

• 保持耐心：不要嫌它问的问题多，每一个问题都是在帮你排雷。
• 多做选择题：在回答 Agent 提问时，尽量要求它提供选项，这样沟通效率更高。
• 文档归档：建议将生成的 `docs/plans` 目录纳入 Git 版本控制，作为项目的“决策日志”。
• 循序渐进：如果功能很复杂，请引导 Agent 分模块（Section）展示设计，确认一块再进行下一块，不要试图一口气吃成胖子。

想体验这种“Tech Lead”级别的结对编程吗？为了帮大家更规范地管理开发流程，建议直接使用 Skill优仓 获取 Brainstorming 以及配套的 Implementation Skills，让你的开发效率和代码质量同步起飞！🚀