Claude Code Superpowers 与 OpenCode OpenSpec 对比指南
1. 概述
1.1 核心概念对比
| 维度 | Superpowers | OpenSpec |
|---|---|---|
| 定位 | Claude Code 的“施工队工作手册”/执行方法论工具 | 规范驱动开发（SDD）框架 |
| 核心作用 | 强制执行结构化工作流（先思考→再计划→后执行） | 将需求转化为结构化规范文档 |
| 类比 | 施工队工作手册、工程监理 | 建筑蓝图、施工变更单 |
| 适用场景 | 复杂功能开发、长链路任务、需要严格流程控制 | 需求评审、架构设计、规范建设、团队协作 |
来源：知乎专栏对两类工具的定位分析，Builder.io对Superpowers的详细介绍，掘金对比文章
1.2 两者关系
这两个工具并非替代关系，而是互补关系：
- OpenSpec = 施工蓝图：定义“做什么、为什么做、做到什么标准”
- Superpowers = 施工团队：解决“怎么高效、规范地执行”
最佳实践：OpenSpec 作为规范底座 → Superpowers 作为执行增强层
2. 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 关键命令
| 命令 | 说明 |
|---|---|
brainstorm | 强制头脑风暴阶段，生成设计规范文档 |
write-plan | 编写详细实施计划，包含完整代码和测试 |
execute-plan | 按计划执行任务 |
review | 代码审查，检查是否符合规范 |
2.5 计划文件示例
一个完整的 Superpowers 计划包含：
- 文件映射表：明确每个文件的职责
- 任务拆解：每个任务包含：
- 确切的文件路径
- 完整的失败测试代码
- 最小化实现代码
- Git commit message
- 验收标准：每个任务如何验证
2.6 局限性
- 无法处理环境调试：macOS vs Linux 的 shell 差异无法在计划阶段预判，需要跳出工作流手动修复
- 计划继承规范错误：如果设计文档有误，计划会沿袭同样的错误
- 学习成本较高：适合“进阶装备”，不是“新手村标配”
3. OpenSpec 安装与使用
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
(探索) (创建) (逐步创建) (实施) (归档)
核心命令详解
| 命令 | 阶段 | 说明 |
|---|---|---|
/opsx:explore | 探索 | 思考想法、研究问题、明确需求（规划用） |
/opsx:new | 创建 | 开始新的变更，创建 proposal |
/opsx:continue | 规划 | 逐步创建下一个工件（specs/design/tasks） |
/opsx:ff | 快速创建 | 一次性创建所有规划工件 |
/opsx:apply | 实施 | 按 tasks.md 执行编码任务 |
/opsx:verify | 验收 | 检查实施与规范的一致性 |
/opsx:sync | 同步 | 将变更同步到主规格 |
/opsx:archive | 归档 | 标记完成，移动到 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. 核心差异对比
4.1 功能维度对比表
| 对比维度 | Superpowers | OpenSpec |
|---|---|---|
| 核心定位 | 执行方法论 / 流程强制 | 规范管理 / 需求结构化 |
| 工作流特征 | 线性四步强制关卡 | 灵活动作 OPSX 工作流 |
| 状态管理 | 依赖对话上下文 + Git commit | 基于文件目录（changes/archive） |
| 可复用性 | 低（单次执行，对话关闭后无法追溯） | 高（规范文档可导出、可分享、可追溯） |
| 适用AI | Claude Code、OpenCode、Codex | 20+ AI 编码助手 |
| 学习成本 | 中到高 | 中 |
| 团队落地难度 | 中到高（灵活度高，统一难度大） | 中（模板化，可培训） |
| GitHub Stars | 107k+ | 23.7k+ |
| 适用阶段建议 | 第三阶段（进阶增强） | 第一阶段（规范底座） |
4.2 工作流哲学差异
Superpowers 哲学：
- “不信任AI的自发性”
- 强制人类在每个关键节点批准
- 适合：复杂功能、长链路任务、零容忍错误场景
OpenSpec 哲学：
- “信任规范，而非信任记忆”
- 规范即代码，随项目演进
- 适合：团队协作、需求评审、架构设计、规范建设
4.3 状态持久化差异
| 方面 | Superpowers | OpenSpec |
|---|---|---|
| 进度保存 | 依赖 Git commit + 对话历史 | 文件系统中的 tasks.md 复选框 |
| 会话恢复 | 需手动指定恢复点 | /opsx:continue [change-name] 自动恢复 |
| 长期追溯 | 较难（依赖对话上下文） | 容易（archive/ 归档 + Git 版本控制） |
5. 协同使用建议
5.1 推荐组合：OpenSpec + Superpowers
两者结合可实现“规范先行、高效落地”：
OpenSpec（规范层） Superpowers（执行层）
│ │
▼ ▼
┌─────────────┐ ┌─────────────┐
│ project.md │ ──提供规范──→ │ brainstorm │
│ specs/ │ │ write-plan │
│ changes/ │ ←──执行反馈── │ execute │
└─────────────┘ └─────────────┘
5.2 企业团队落地路径
根据知乎专栏建议的优先顺序：
第一阶段：OpenSpec → 建立规范底座
第二阶段：GSD/Task Master → 增强执行与任务管理
第三阶段：Superpowers → 生态增强（可选）
5.3 场景选择指南
| 场景 | 推荐工具 | 理由 |
|---|---|---|
| 新项目从零开始 | OpenSpec | 建立规范文档，团队统一认知 |
| 现有项目重构 | OpenSpec | “棕地优先”，渐进式引入规范 |
| 复杂功能开发 | Superpowers | 强制流程，避免方向漂移 |
| 多人协作项目 | OpenSpec | 规范可共享、可评审 |
| 个人实验性开发 | Superpowers | 快速执行，流程自动 |
| 企业级落地 | OpenSpec + Superpowers | 规范底座 + 执行增强 |
6. 常见问题
Q1: 可以只用其中一个吗？
可以。两者独立工作，但结合使用效果更好。Superpowers 适合追求执行效率的个人开发者；OpenSpec 适合需要规范管理的团队。
Q2: 哪个更适合团队推广？
OpenSpec。它有模板化的工作流、可培训的操作步骤、可复用的规范文档，统一推广成本较低。
Q3: 学习成本哪个更高？
Superpowers 学习成本更高。它的强制关卡和子代理机制需要一定适应期；OpenSpec 的命令更直观，文档更完善。
Q4: 两者会互相冲突吗？
不会。它们是互补关系，可以同时安装使用。常见做法：用 OpenSpec 管理规范，用 Superpowers 执行任务。
Q5: OpenCode 和 Claude Code 是什么关系？
OpenCode 是一个独立的开源 CLI 工具，可以融合多种 AI 模型（Claude Code、iFlow、Copilot、国内模型等）。它与 Claude Code 不是替代关系，而是可以配合使用。
7. 参考资源
| 资源 | 链接 |
|---|---|
| OpenSpec GitHub | github.com/Fission-AI/… |
| OpenSpec 官网 | openspec.dev |
| Superpowers GitHub | github.com/obra/superp… |
| Superpowers 文档 | www.mintlify.com/obra/superp… |
| OpenCode 官网 | opencode.ai |
| OpenCode 文档 | opencode.ai/docs |
