AI编程02：Claude Code + OpenSpec + Superpowers 集成指南AI编程02：Claud

AI编程02：Claude Code + OpenSpec + Superpowers 集成指南

工具 / 模式	核心定位	备注	核心能力范围
OpenSpec	需求与规格的 “契约书”	建筑师的蓝图与施工规范	负责明确目标和原因，产出API文档、架构决策和任务清单，是所有工作的基础。
Claude Code	智能编码的 “主力程序员”	熟练的高级工程师	负责根据Spec编写和修改代码，并解释代码。它能理解项目结构，支持自动补全、重构及解析复杂逻辑。
Superpower	工程化的 “质量宪兵队”	严格的测试与审核团队，比较重，skill触发，token 消耗会增加很多	负责确保代码既正确又高质量，包括采用测试驱动开发、代码审查、风格检查和性能优化等工程实践。

第一步：安装 Claude Code

在使用任何插件之前，你需要先安装 Claude Code 命令行工具。npm方式claude官方已标记为过时，这里使用推荐的方式好安装。

macOS / Linux

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

Windows
在 PowerShell 中运行：

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

验证与登录

在你的项目文件夹所在位置claude启动：

claude

第二步：环境准备与插件安装

进入 Claude Code 交互界面后，我们需要安装 OpenSpec 和 Superpowers。

安装 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 Code，然后重新启动 Claude。

这时就可以使用 Superpowers 相关能力了。

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

/plugin update superpowers

第三步：项目初始化

进入你的项目目录，将 OpenSpec 的能力注入到 Claude Code 中。

进入项目

cd your-project

2. 初始化集成
在本地终端执行以下命令：

openspec init

在交互式向导中：

- 直接回车即可

- 集成工具：空格选择 Claude Code，然后回车。
- 根据提示好复制提示词到claude code粘贴

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

第四步：规范先行 (OpenSpec)

在 Claude Code 中，先定义“做什么”，再生成代码。

常见流程：

/opsx:propose（新建提案，生成规范与任务） -> /opsx:apply（应用提案，执行任务） -> /opsx:archive（归档提案）

You: /opsx:propose add-dark-mode
AI:  Created openspec/changes/add-dark-mode/
     ✓ proposal.md — why we're doing this, what's changing
     ✓ specs/       — requirements and scenarios
     ✓ design.md    — technical approach
     ✓ tasks.md     — implementation checklist
     Ready for implementation!

You: /opsx:apply
AI:  Implementing tasks...
     ✓ 1.1 Add theme context provider
     ✓ 1.2 Create toggle component
     ✓ 2.1 Add CSS variables
     ✓ 2.2 Wire up localStorage
     All tasks complete!

You: /opsx:archive
AI:  Archived to openspec/changes/archive/2025-01-23-add-dark-mode/
     Specs updated. Ready for the next feature.

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

利用 Superpowers 将 OpenSpec 生成的任务转化为高质量代码。目前Superpowers会通过skill触发流程。输入openspec相关的命令也会触发superpower的skill.

/openspec:apply