告别Vibe Coding!用Superpowers让Claude Code写出工程级代码,一次通过零报错!遵循TDD最佳实践!支持Codex和OpenCode!从需求澄清到代码审查 AI超元域 2026-01-11

在之前的视频中,我为大家演示过多种与 Claude CodeCodeX 相关的开发工作流,包括 OpenAI 等。最近,我发现了一个更加工程化、更完整的开源工作流:Superpowers。它是一个面向AI编程助手的完整软件开发工作流系统。它支持 Claude Code,还支持 OpenAICodeX,并且支持开源的AI编程助手 Open Code

我曾使用 SuperpowersClaude Code 中开发了一款 iOS 的时间线笔记原生应用。在这个应用中,我们可以记笔记,输入标签,还可以选择图像。点击发布后,笔记会以时间线方式显示在最顶部,下方是之前发布的笔记内容。我们还可以对笔记进行编辑、删除,或放大图像。

Superpowers 的核心功能并非让AI随心所欲地写代码(即我们常说的 vibe coding),而是将一整套接近专业工程团队的开发方法论固化下来,让AI编程助手在写代码时能够自动遵循最佳的实践,包括先澄清需求、编写计划、分步实现,并且每一步都有检查点,从而避免AI编程助手采用 vibe coding 的方式将项目越搞越乱。

它最大的特色是测试驱动开发(TDD)贯穿始终,作为铁律强制执行。每个任务都会委派一个新的sub-agent,这样就不会造成上下文污染。它的实现方式是将研发流程打包成一组可组合的 skills 与启动指令,并通过指令、技能库和工作流编排的组合,让AI在不同阶段按流程做正确的事。

本期视频,我们将结合实际项目,带大家测试 Superpowers 这个开源工作流的使用方式和效果。由于 SuperpowersClaude Code 的支持更好,在 Claude Code 中,它能借助 Claude Code 原生支持的 skills 功能以及插件功能,实现一键安装、加载与自动触发。因此,本期视频将重点在 Claude Code 中测试这个开源工作流项目。

安装与配置

Claude Code 中使用 Superpowers 这个插件非常简单。首先,打开终端命令行,进入 Claude Code,然后复制官方给出的一条命令,粘贴到 Claude Code 中并执行。接着,复制官方给出的第二条命令,粘贴到 Claude Code 中直接执行。

CodeX 中安装也非常简单。我们只需要复制官方给出的提示词,在 CodeX 中直接粘贴并执行即可。

Open Code 中安装同样简单。我们直接复制官方给出的提示词,然后在 Open Code 中粘贴并运行即可。

Superpowers 工作流概览

安装完成后,我们就可以在 Claude Code 中输入斜杠命令 /superpowers。这时,我们可以看到 Superpowers 支持的三条命令:

  1. 头脑风暴 (Brainstorming):我们只需要简单描述要开发的内容,与AI进行苏格拉底式对话,从而帮助我们厘清真正的需求。
  2. 编写开发计划 (Write Development Plan):它能实现编写2到5分钟的小任务,包含精确的文件路径、完整的代码片段,以及明确的验证步骤。
  3. 执行计划 (Execute Plan):这是最终的执行命令。

Superpowers 的整体执行流程非常简单:

  • 头脑风暴:首先进行需求澄清。
  • 工作区隔离:它会创建新的分支来隔离开发环境。
  • 项目初始化:进行项目的基础设置。
  • 验证测试基线:确保初始状态可测试。
  • 编写计划:生成详细的开发计划。
  • 子代理开发:将计划分配给sub-agent进行开发。

它的核心原则是测试驱动开发(TDD)循环,包括写(代码)、失败(测试)、测试、最小实现,最后清理优化。其特点是两阶段代码审查:第一阶段是规格符合性审查,第二阶段是代码质量审查。

演示:iOS笔记应用开发

设置好 Superpowers 后,下面我们用一个实际例子来测试其开发流程和效果。

在开始执行之前,我们可以在 Xcode 中初始化一个 iOS 项目,然后用 cd 命令进入我们创建的路径,再启动 Claude Code。我们可以直接用斜杠命令 /superpowers brainstorm 来开启 Superpowers 的头脑风暴模式。然后,直接输入开发需求,它就会自动激活头脑风暴 skill

我这里输入的开发需求是:“开发一个个人时间线笔记的 iOS 应用,像 X(推测为Twitter/X)一样能够发布短笔记,按时间线浏览,还能支持图片和标签。”

我们直接运行,先看一下效果。这里提示使用头脑风暴这个 skill,我们允许它执行。这样,不需要我们去执行具体命令,只需要输入开发需求,它就能自动激活 Superpowers 的头脑风暴 skill

AI 识别到我们刚才创建了一个空的 Xcode 项目,并需要查看项目结构。它提示这是一个新的 Xcode 项目,并表示理解了我们想创建一个时间线笔记 App。

接下来,它需要我们来澄清几个问题:

  1. 如何创建笔记?

    • 选项一:采用类似 X 右下角的加号按钮,点击即可打开撰写窗口。
    • 选项二:顶部撰写栏,时间线顶部始终可见的输入框,直接输入即可发布。
    • 选项三:下拉撰写,在时间线上拉即可显示撰写区域。 我们选择第一项,输入“1”。

    AI 很快输出了回答:“悬浮按钮既方便,又能保持时间线的简洁。”

  2. 笔记在时间线上应该如何显示?

    • 选项一:卡片样式,每条笔记以圆角卡片的形式呈现。
    • 选项二:扁平列表形式,类似 X
    • 选项三:气泡形式,类似聊天气泡的显示方式。 我们选择第一种,让它实现这种圆角卡片的风格,输入“1”。
  3. 笔记中的图片应该如何显示?

    • 选项一:内嵌式展开,图片在卡片内全框显示,类似于 X 风格。
    • 选项二:缩略图网格,多张图片显示为小缩略图,点击展开。
    • 选项三:单张预览。如果有更多图片,则显示徽章。 我们选择第二项,实现缩略图的网格,输入“2”。
  4. 标签如何运作?

    • 选项一:在笔记中内嵌标签。
    • 选项二:单独的标签选择器。
    • 选项三:两者兼备。 我们选择第一种,输入“1”(像 X 中一样,输入井号键就能填写标签)。
  5. 点击标签后会发生什么?

    • 选项一:筛选时间线,仅显示带有该标签的笔记。
    • 选项二:标签详情页,跳转到专门的页面。
    • 选项三:快速筛选栏,将标签添加到顶部的筛选栏,可以组合多个标签。 我们选择第二项,输入“2”(点击标签后跳转到专门的页面)。
  6. 是否需要搜索功能?

    • 选项一:全文搜索。
    • 选项二:仅标签搜索。
    • 选项三:搜索加标签建议。 我们选择第三项,输入“3”。
  7. 笔记编辑和删除应该如何操作?

    • 选项一:向左滑动删除,向右滑动编辑。
    • 选项二:长按来显示编辑、删除或复制的选项。
    • 选项三:点击查看详情,在详情中包含删除按钮。 我们选择第三项,输入“3”。
  8. 是否需要数据的备份?

    • 选项一:不需要备份(为了快速开发)。 我们选择第一项,输入“1”。

AI 生成了一个最终方案,并分析了设计。最后询问数据模型是否正确,我们直接输入“正确”并发送。

AI 紧接着输出了第二部分:项目的结构和导航,包含详细的交互设计。我们让它继续执行。

AI 又输出了 UI 设计,包括时间线和笔记卡片。我们让它继续执行。

AI 生成了项目结构,并询问是否合理、是否准备执行。我们输入提示词:“这个结构看起来很好,请按照 Superpowers 的工作流继续执行,先让它创建隔离的工作区,然后再使用这个 skill 创建详细的 TDD 实现计划。”

AI 提示它将先保存设计文档,然后继续执行工作流。它需要执行 git 命令,我们让它继续执行。

AI 开始使用“创建工作区”的 skill。我们允许它执行。它询问将在哪里创建独立开发的工作区。我们直接按照它给出的推荐的第一项,输入“1”并运行。

这样,它就执行到了创建工作区,包含创建新分支、隔离开发环境、项目初始化,以及验证测试基线。现在开始运行到了“写计划”的步骤,我们直接让它执行。

AI 提示调用了 writing plans 这个 skill,它会创建一个综合性的 TDD 执行计划。

AI 提示这个执行计划已经存入到了文件中。在这里,它给出了两种选择方式:第一种是使用 sub-agent 驱动的。我们选择第一种,输入“1”并发送。

AI 提示它需要调用这个 skill,我们允许它执行。它将使用 sub-agent driver 来执行我们这个计划。

现在生成了这些任务,一共生成了13个任务。这样就进入了 sub-agent 开发的步骤。在这个步骤中,每个任务都会有一个 sub-agent,并且会进行刚才提到的两阶段检查,包括规格检查和代码质量检查,通过 TDD 循环直到通过为止。

在等待了大约1多分钟之后,它执行到了这一步。它需要调用 skills,我们允许它执行。

AI 提示在执行第一步验证测试。测试成功。

下面它需要执行第二步。

AI 开始执行第三步。这里给出了三个选项。第一个选项是“本地合并回主分支”。我们就选“1”,让它合并回主分支。

我们允许它执行命令。AI 提示执行完成,合并到了主分支。这时就提示我们可以运行这个项目了。

最终成果验证

下面我们来测试一下。在 Xcode 中打开这个项目,然后我们运行。AI 提示构建成功。

打开应用后,我们就看到了它为我们生成的时间线笔记界面。我们可以先添加一个测试笔记。点击发布,这里我们就看到了我们发布的笔记。

我们再测试一下图片功能。点击图片库,点击添加一个图像,查看一下。这里我们随便添加一个,然后我们再添加一个图像,点击发布。这里我们就看到了我们发布的第二篇笔记。我们再添加一个,再添加几张图像,然后点击发布。这样的话,图像就按照缩略图的方式进行了显示。

然后我们就可以向下滑动来查看我们所发布的这些笔记。

我们再选一篇笔记,点击进入详情。这样的话,就进入到了这个笔记的详情页。

下面我们点一下这个标签,看一下。这里就将带有这个标签的所有笔记显示在了这里。

然后我们点击第二篇笔记,然后测试一下删除。我们点击这个删除,然后确认。

这里删除成功。

这样的话,我们就在 Claude Code 中使用 Superpowers 为我们完成了这个时间线风格的笔记应用的开发,而且一次就通过了测试,没有出现任何报错。

本期视频就做到这里,欢迎大家点赞、关注和转发,谢谢大家观看。

📌 文中提及的人物和组织

公司/组织: OpenAI, Claude Code

产品/模型: Superpowers, CodeX, Open Code

关键字: ai-coding-assistants test-driven-development software-development-workflows code-generation prompt-engineering