AI编程01：告别“Vibe Coding”！用Claude Code + OpenSpec + Superpowers打造工程级代码

AI编程01：告别“Vibe Coding”！用Claude Code + OpenSpec + Superpowers打造工程级代码

这份实战指南基于公开资料编制而成，旨在为用户提供从Claude Code的安装到与OpenSpec及Superpowers集成的详细步骤指导。对于具体的操作流程，请参阅各工具提供的官方文档以获取最准确的信息。

工具概览

OpenSpec

核心功能定位：作为需求与规格之间的“契约”。

说明：类似于建筑设计中的蓝图和施工规范。

能力范围：专注于定义项目的需求与目标，即明确项目要“做什么”及其背后的原因。其输出成果包括但不限于API文档、架构决策记录(ADR)以及任务列表等，这些内容构成了后续开发工作的基础，并为团队提供了重要的参考资料。

Claude Code

核心功能定位：智能编码领域的“核心开发者”。

说明：相当于一位资深的高级软件工程师。

能力范围：根据既定的技术规范直接编写或修改代码，并能清晰地解释背后的逻辑思路。此外，它还具备理解整个项目框架的能力，支持自动完成代码片段、重构等功能，同时能够解析复杂的代码结构并给出合理建议。

Superpower

核心功能定位：质量保证环节中的“守护者”。

说明：象征着一个严格而全面的质量管理体系，启用该工具可能会显著增加计算资源（例如token）的使用量。

能力范围：致力于确保开发过程中的准确性与代码质量，涵盖测试驱动开发(TDD)、代码审查、风格一致性验证以及性能调优等多个维度，最终目标是交付达到高标准要求的产品。

第一步：安装 Claude Code

在开始使用插件之前，请先确保已安装 Claude Code 命令行工具。

macOS / Linux

请执行以下命令进行安装：

curl -fsSL https://claude.ai/install.sh | bash

Windows

请在 PowerShell 中运行以下命令：

irm https://claude.ai/install.ps1 | iex

验证与登录

完成安装后，请按照提示进行验证和登录。

claude

第二步：环境配置与插件安装

在进入 Claude Code 的交互界面后，首先需要对开发环境进行必要的配置，并安装 OpenSpec 和 Superpowers 两个工具。

1. 安装 OpenSpec（命令行工具）

请在本地终端（注意：不是 Claude Code 内部的终端）中执行以下命令以完成 OpenSpec 的安装：

npm install -g @fission-ai/openspec@latest

确保所有依赖项均已正确安装，以便后续操作能够顺利进行。

安装 Superpowers (Claude Code 插件)

回到Claude Code的交互界面中，依次执行以下内容：

/plugin marketplace add obra/superpowers-marketplace

/plugin install superpowers@superpowers-marketplace

请按照以下步骤操作：首先，退出 Claude 应用程序；然后，重新启动该应用程序。完成上述步骤后，您将能够访问 Superpowers 的相关功能。

当您更新插件时，技能更新会自动更新：

/plugin update superpowers

__

第三步：项目初始化

请导航至您的项目目录，并将OpenSpec的功能集成到Claude Code中。

进入项目目录

请在终端中执行以下命令以进入您的项目根目录：

cd /path/to/your-project

初始化集成

在本地终端中运行以下命令以启动OpenSpec的初始化过程：

openspec init

随后，您将被引导进入一个交互式设置向导。对于大多数默认选项，直接按回车键确认即可。

希望以上步骤能帮助您顺利完成项目的初始化配置。

- **集成工具**：空格选择 **Claude Code，然后回车**。<img src="https://cdn.nlark.com/yuque/0/2026/png/40570957/1775728816770-848c3d26-78ac-4072-99c6-d9c0c66711de.png" width="787" title="" crop="0,0,1,1" id="u1ff1002a" class="ne-image">

- **根据提示好复制提示词到claude code粘贴**<img src="https://cdn.nlark.com/yuque/0/2026/png/40570957/1775728874602-d3fbc52e-89a6-4f7a-af3d-1aec7969fb30.png" width="723" title="" crop="0,0,1,1" id="u76ec1614" class="ne-image">

- <img src="https://cdn.nlark.com/yuque/0/2026/png/40570957/1775728966685-afeb312e-a68d-4630-984d-22719bc6bf5d.png" width="902" title="" crop="0,0,1,1" id="u5a48d594" class="ne-image">

完成后，项目中通常会生成 openspec 目录、AGENT.md 和 CLAUDE.md。

第四步： OpenSpec流程介绍

1. 提案创建

当您有一个新的功能或改进想法时，第一步是使用/opsx:propose命令来正式提出您的提案。这一步骤要求详细描述所提议的功能是什么、为什么需要它以及预期的效果等信息。

用户输入：/opsx:propose add-dark-mode

AI响应：

创建一个新的文件夹openspec/changes/add-dark-mode/来存放所有相关文档。

在该目录下生成几个关键文件如proposal.md,specs/,design.md, 和tasks.md，用于分别记录提案概要、具体规格说明、设计方案和技术实现步骤。

确认提案已准备好进入下一阶段：“准备就绪，可以开始实施！”

2. 提案实施

一旦提案被定义清楚并得到批准后，就可以通过/opsx:apply命令启动具体的开发工作了。这包括但不限于编写代码、测试功能直至达到预期效果。

用户输入：/opsx:apply

AI响应：

根据tasks.md文件中的指导逐一完成各项任务。

每完成一个里程碑都会更新状态报告，直到所有指定的任务都已完成。

最终确认：“所有任务已完成！”

3. 任务归档

最后，在项目成功完成后，使用/opsx:archive将其归档。这不仅有助于保持良好的文档组织结构，也为未来可能的维护工作提供了便利。

用户输入：/opsx:archive

AI响应：

将整个项目（包括所有的文档和代码）移动到openspec/changes/archive/目录下的适当位置。

更新任何相关的官方文档以反映最新变化。

发布消息：“准备好迎接下一个特性。”

这种标准化的工作流不仅提高了团队协作效率，也保证了软件开发过程中的透明度和可追溯性。对于希望采用类似方法管理自己项目的开发者来说，这是一个非常值得参考的最佳实践模式。

第五步：工程化落地 (Superpowers)

借助 Superpowers 平台，我们能够将 OpenSpec 中定义的任务转化为高质量的代码产出。这一转换过程目前由特定技能（skill）触发的工作流自动化完成。

/openspec:apply