大家好，我是讯享网，很高兴认识大家。这里提供最前沿的Ai技术和互联网信息。



1.1 核心概念对比

来源：知乎专栏对两类工具的定位分析，Builder.io对Superpowers的详细介绍，掘金对比文章

1.2 两者关系

这两个工具并非替代关系，而是互补关系：

• OpenSpec = 施工蓝图：定义“做什么、为什么做、做到什么标准”
• Superpowers = 施工团队：解决“怎么高效、规范地执行”

**实践：OpenSpec 作为规范底座 → Superpowers 作为执行增强层

---

2.1 简介

Superpowers 是由 Jesse Vincent（obra）开发的 Claude Code 插件/方***具包，上线3个月获超10万GitHub Stars。它通过强制四步工作流（头脑风暴→分支隔离→编写计划→执行）解决AI编码中的“方向漂移”问题。

核心理念：在写任何代码之前，先确保设计和计划获得人类批准。

2.2 安装步骤

前置条件

• Bash/Zsh shell（macOS/Linux）或 PowerShell（Windows）
• Claude Code 已安装并配置

Claude Code 安装（推荐方式）

# 在 Claude Code 会话中执行 /plugin marketplace add obra/superpowers-marketplace /plugin install superpowers@superpowers-marketplace # 验证安装 /help 

看到 brainstorm、write-plan、execute-plan 三个命令即表示安装成功。

OpenCode 手动安装

# 1. 克隆仓库 git clone https://github.com/obra/superpowers.git ~/.config/opencode/superpowers # 2. 创建目录并建立符号链接 mkdir -p ~/.config/opencode/plugins ~/.config/opencode/skills ln -s ~/.config/opencode/superpowers/.opencode/plugins/superpowers.js ~/.config/opencode/plugins/superpowers.js ln -s ~/.config/opencode/superpowers/skills ~/.config/opencode/skills/superpowers # 3. 重启 OpenCode 

2.3 核心工作流

Superpowers 强制执行四个硬性关卡：

┌─────────────────────────────────────────────────────────────┐ │ Superpowers 四步工作流 │ ├─────────────────────────────────────────────────────────────┤ │ 1. Brainstorm（头脑风暴） │ │ └─ 生成设计文档 → 必须获得人类批准 → 才能进入下一步 │ │ │ │ 2. Git Worktree（分支隔离） │ │ └─ 创建独立工作分支，绝不触碰主分支 │ │ │ │ 3. Write Plan（编写计划） │ │ └─ 拆解为2-5分钟可执行任务 → 包含完整代码 │ │ │ │ 4. Execute（执行） │ │ └─ 子代理按任务清单执行 → 每步后双重审查 │ └─────────────────────────────────────────────────────────────┘ 

2.4 关键命令

2.5 计划文件示例

一个完整的 Superpowers 计划包含：

• 文件映射表：明确每个文件的职责
• 任务拆解：每个任务包含：
  • 确切的文件路径
  • 完整的失败测试代码
  • 最小化实现代码
  • Git commit message
• 验收标准：每个任务如何验证

2.6 局限性

1. 无法处理环境调试：macOS vs Linux 的 shell 差异无法在计划阶段预判，需要跳出工作流手动修复
2. 计划继承规范错误：如果设计文档有误，计划会沿袭同样的错误
3. 学习成本较高：适合“进阶装备”，不是“新手村标配”

---

3.1 简介

OpenSpec 是由 Fission-AI 开发的轻量级规范驱动开发（SDD）框架，支持20+ AI编码助手。最新版本使用 OPSX 工作流，GitHub Stars 23.7k+。

核心理念：在投入编码前，确保人与AI对最终目标达成共识，从源头避免方向性错误。

“棕地优先”（brownfield-first）：特别擅长引入到大型现有项目中。

3.2 安装步骤

前置条件

• Node.js 20.19.0 或更高版本
• npm/pnpm/bun/yarn

全局安装（推荐）

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

项目初始化

# 进入项目根目录 cd your-project # 初始化 OpenSpec openspec init 

初始化时会提示选择 AI 环境，支持：

• Claude Code
• Cursor
• OpenCode
• Windsurf
• GitHub Copilot
• Amazon Q Developer
• 等20+工具

3.3 目录结构

初始化后生成以下结构：

openspec/ ├── AGENTS.md # AI助手使用指南（自动生成） ├── project.md # 项目专属上下文（技术栈、编码规范） ├── specs/ # 权威基准：当前已部署的功能 │ └── [capability]/ │ ├── spec.md # 需求说明与场景描述 │ └── design.md # （可选）技术实现模式 ├── changes/ # 提案集：进行中的工作 │ ├── [change-name]/ │ │ ├── proposal.md # 提案背景、内容与影响评估 │ │ ├── tasks.md # 实现任务清单 │ │ ├── design.md # （可选）架构决策 │ │ └── specs/ # 增量规格说明 │ └── archive/ # 已完成变更的历史归档 └── config.yaml # 项目配置（可选） 

3.4 OPSX 工作流与命令

OpenSpec 采用灵活动作的 OPSX 工作流，而非固定阶段：

/opsx:explore ──→ /opsx:new ──→ /opsx:continue ──→ /opsx:apply ──→ /opsx:archive (探索) (创建) (逐步创建) (实施) (归档) 

核心命令详解

3.5 三阶段开发流程

阶段一：创建变更（提案）

/opsx:new add-user-login 

生成文件：

• proposal.md - 为什么做、做什么
• specs/spec.md - 功能规范（Given/When/Then格式）
• design.md - 技术设计（可选）
• tasks.md - 实施任务清单

使用 /opsx:continue 逐个创建工件，或 /opsx:ff 一键生成所有。

阶段二：实施

/opsx:apply 

AI 会：

• 遍历 tasks.md 中的任务
• 逐一实现代码和测试
• 实时更新任务状态（- [ ] → - [x]）

恢复进度：如果会话中断，使用 /opsx:continue [change-name] 自动恢复。

阶段三：归档

/opsx:verify add-user-login # 验收检查 /opsx:archive add-user-login # 归档到 archive/ 

归档后，规范增量自动合并到 openspec/specs/，成为项目“活文档”。

3.6 与 OpenCode 的集成

当 OpenSpec 与 OpenCode 配合时，OpenCode 会在 .opencode/command/ 下生成 opsx:* 命令文件。

启动流程：

# 1. 确保 OpenCode 已安装 curl -fsSL https://opencode.ai/install | bash # 2. 安装 OpenSpec npm install -g @fission-ai/openspec@latest # 3. 项目初始化 openspec init # 选择 OpenCode 作为环境 # 4. 启动 OpenCode opencode 

---

4.1 功能维度对比表

4.2 工作流哲学差异

Superpowers 哲学：

• “不信任AI的自发性”
• 强制人类在每个关键节点批准
• 适合：复杂功能、长链路任务、零容忍错误场景

OpenSpec 哲学：

• “信任规范，而非信任记忆”
• 规范即代码，随项目演进
• 适合：团队协作、需求评审、架构设计、规范建设

4.3 状态持久化差异

---

5.1 推荐组合：OpenSpec + Superpowers

两者结合可实现“规范先行、高效落地”：

OpenSpec（规范层） Superpowers（执行层） │ │ ▼ ▼ ┌─────────────┐ ┌─────────────┐ │ project.md │ ──提供规范──→ │ brainstorm │ │ specs/ │ │ write-plan │ │ changes/ │ ←──执行反馈── │ execute │ └─────────────┘ └─────────────┘ 

5.2 企业团队落地路径

根据知乎专栏建议的优先顺序：

第一阶段：OpenSpec → 建立规范底座 第二阶段：GSD/Task Master → 增强执行与任务管理 第三阶段：Superpowers → 生态增强（可选） 

5.3 场景选择指南

---

Q1: 可以只用其中一个吗？

可以。两者独立工作，但结合使用效果更好。Superpowers 适合追求执行效率的个人开发者；OpenSpec 适合需要规范管理的团队。

Q2: 哪个更适合团队推广？

OpenSpec。它有模板化的工作流、可培训的操作步骤、可复用的规范文档，统一推广成本较低。

Q3: 学习成本哪个更高？

Superpowers 学习成本更高。它的强制关卡和子代理机制需要一定适应期；OpenSpec 的命令更直观，文档更完善。

Q4: 两者会互相冲突吗？

不会。它们是互补关系，可以同时安装使用。常见做法：用 OpenSpec 管理规范，用 Superpowers 执行任务。

Q5: OpenCode 和 Claude Code 是什么关系？

OpenCode 是一个独立的开源 CLI 工具，可以融合多种 AI 模型（Claude Code、iFlow、Copilot、国内模型等）。它与 Claude Code 不是替代关系，而是可以配合使用。

---