企业官网建设流程全解析

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 在问第一个问题之前先"分类"，并大声宣布走哪条路（你可以随时推翻它）👇

规则是单向棘轮：拿不准就走更重的路径；任务中途发现隐藏复杂度，必须停下来升级路径，绝不降级。

实操指南：从一句话需求到设计文档的 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-cc@superpowers-extended-cc-marketplace /superpowers-extended-cc:onboard

onboard命令会引导你完成初始化配置。想本地研读源码的话，也可以克隆仓库：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 一轮——批准前的两分钟提问，省下的是返工的两小时。✅