别再让AI瞎写代码了:如何用Superpowers的brainstorming技能把模糊想法打磨成设计文档
【免费下载链接】superpowersAn agentic skills framework software development methodology that works - Claude Code task management support项目地址https://gitcode.com/gh_mirrors/sup/superpowers点击查看免费下载AI 写代码翻车多数时候不是模型不行而是没想清楚就动手。Superpowers 是一个面向 Claude Code 的 agentic 技能框架与开发方法论其中的brainstorming 技能专门解决从模糊想法到设计文档这一段强制 AI 先提问、再比方案、后出设计并设置一道未获批准不得写代码的硬门槛hard gate。读完本文你就能把一句帮我做个 XX打磨成一份可执行的设计文档。为什么 AI 总是瞎写代码常见的翻车路径是这样的你丢一句帮我加个导出功能AI 立刻开工它默默替你假设了一堆需求导出什么格式失败怎么办放哪个模块写完后你发现方向完全不对推倒重来浪费大量 token 和时间。Superpowers 的核心理念是流程优于猜测Process over guessing在实现之前先把假设逼出水面。brainstorming 技能正是这套流程的入口——它要求 AI 在动用任何实现类技能、写任何一行代码之前先和你把设计敲定。核心机制一批准之前禁止动手技能的 SKILL.md 里有一段明确的 HARD-GATE在告知人类伙伴你的意图并获得批准之前不得调用任何实现技能、写任何代码、搭任何脚手架。注意一个容易踩的误区太简单了不需要设计是最典型的反模式。哪怕是改一个配置项、加一个小开关AI 也必须把设计哪怕只有两句话摆出来等你点头。越简单的任务越容易藏着没被审视的假设。核心机制二三条路径按任务分量走brainstorming 技能要求 AI 在问第一个问题之前先分类并大声宣布走哪条路你可以随时推翻它路径适用场景产物Spike可行性试探能不能……快糙猛也行一份结论建议不写正式代码Bounded改动范围清晰、仓库里已有现成流程可循聊天里的短设计批准即可开工Architectural新项目、新子系统、改变组件关系的重构完整设计文档 实现计划规则是单向棘轮拿不准就走更重的路径任务中途发现隐藏复杂度必须停下来升级路径绝不降级。实操指南从一句话需求到设计文档的 4 步第 1 步直接提出需求即可。你说出想法后AI 会先探索项目现状文件、文档、近期提交然后宣布路径分类。如果需求横跨多个独立子系统建一个带聊天、存储、计费和统计的平台它会先帮你拆解子项目而不是硬着头皮细化。第 2 步一条条回答澄清问题。AI 每次只问一个问题优先用选择题聚焦三件事目的、约束、成功标准。这是把模糊想法变具体的关键环节。第 3 步看 2~3 个方案逐节过设计。AI 会给出带取舍的分析并亮出自己的推荐YAGNI 原则无情砍掉多余功能。随后按架构、组件、数据流、错误处理、测试分节呈现设计每一节都等你确认再继续。第 4 步设计文档落盘 双重审查。你批准后设计会写入 docs/superpowers/specs/YYYY-MM-DD-topic-design.md 并提交 git。之后 AI 先做一次换眼自检扫 TBD 占位符、检查内部矛盾、核对范围、消除歧义再把 spec 文件交给你终审——你说 OK才进入实现阶段。加分项Visual Companion 浏览器伴侣 聊界面布局、对比视觉方案时文字描述往往低效。brainstorming 内置了一个按需启用的浏览器伴侣只有当画出来比说出来清楚时AI 才会单独发一条消息征求你的同意同意后自动打开浏览器标签页你可以在页面上直接点击选择 mockup、线框图、并排对比方案纯文字类问题需求澄清、A/B/C 取舍仍留在终端处理。实现细节可参考 visual-companion.md 与 skills/brainstorming/scripts/ 下的服务脚本。设计文档之后交给 writing-plans 变成任务brainstorming 的终点是唯一且明确的Architectural 路径结束后下一步只会调用 writing-plans 技能把批准的设计拆成 2~5 分钟一个、带精确文件路径和验证步骤的小任务。下面两张截图展示了同一工作流的两种形态左vanilla任务只存在于 markdown 计划里右Extended CC原生任务管理器呈现依赖关系与实时进度也就是说brainstorming 负责想对writing-plans 负责拆细后续还有 TDD、code review 等技能接力形成完整的开发方法论闭环。安装与源码导航在 Claude Code 中安装插件/plugin marketplace add pcvelz/superpowers /plugin install superpowers-extended-ccsuperpowers-extended-cc-marketplace /superpowers-extended-cc:onboardonboard命令会引导你完成初始化配置。想本地研读源码的话也可以克隆仓库git clone https://gitcode.com/gh_mirrors/sup/superpowers。值得收藏的几个入口技能主文档skills/brainstorming/SKILL.md技能调用总规则skills/using-superpowers/SKILL.md任务格式参考skills/shared/task-format-reference.md工作流设计文档docs/user-gate-flow.md、docs/model-routing-flow.md下次再想让 AI直接开写时记得先让它 brainstorm 一轮——批准前的两分钟提问省下的是返工的两小时。✅赞分享【免费下载链接】superpowersAn agentic skills framework software development methodology that works - Claude Code task management support项目地址https://gitcode.com/gh_mirrors/sup/superpowers点击查看免费下载相关推荐Superpowers brainstorming 技能实战把模糊想法变成经批准的规格说明Superpowers brainstorming 技能实战把模糊想法变成经批准的规格说明 Superpowers 的 brainstorming 技能是该项AI 技能AI 插件开发工具enhance-prompt 技能实战把模糊 UI 想法打磨成 Stitch 高质量生成提示词enhance prompt 技能实战把模糊 UI 想法打磨成 Stitch 高质量生成提示词 在 Stitch 这类文本到 UI 的生成平台上提示词的质量AI 技能AI 插件从模糊想法到验证设计AAS 仓库 brainstorming 技能的设计协作工作流全解析从模糊想法到验证设计AAS 仓库 brainstorming 技能的设计协作工作流全解析 导读 本篇文章围绕 AASagentic awesome skilAI 技能AI 插件创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考