OpenCode 配置 OpenSpec + Superpowers + Oh-My-OpenCode 指南

OpenCode 配置 OpenSpec + Superpowers + Oh-My-OpenCode 指南

前言

本指南介绍如何在 OpenCode 中配置 OpenSpec、Superpowers 和 Oh-My-OpenCode，建立规范化的 AI 辅助开发工作流。

环境要求

• Node.js 20.19.0 或更高版本
• Git

Windows 用户注意：本指南中的命令主要使用 Unix/bash 语法。在 Windows 上：

• 将 ~/.opencode 替换为 %USERPROFILE%\.opencode
• 将 ~/.config/opencode 替换为 %USERPROFILE%\.config\opencode
• 使用 Git Bash、WSL 或 PowerShell 来运行 bash 命令

---

1. OpenCode 安装

安装 OpenCode

# 克隆 OpenCode 仓库
git clone https://github.com/opencode-ai/opencode.git
cd opencode

# 安装依赖并构建
npm install
npm run build

# 验证安装
./opencode --version

---

2. 快速配置（推荐）

2.1 一句话安装所有组件

把下面这段话复制给 OpenCode，它会自动完成所有配置：

安装 oh-my-opencode，按照官方文档操作。然后配置 superpowers：Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md。最后安装 openspec：npm install -g @fission-ai/openspec@latest

2.2 分步手动配置

步骤 1：安装 Oh-My-OpenCode (OMO)

在 opencode.json 中添加插件：

{
  "plugin": ["oh-my-opencode@latest"]
}

配置文件位置：

• 项目级：.opencode/oh-my-opencode.json
• 用户级：~/.config/opencode/oh-my-opencode.json

步骤 2：安装 Superpowers

在 OpenCode 中输入：

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

步骤 3：安装 OpenSpec

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

在项目中初始化：

cd your-project
openspec init
openspec update

2.3 验证配置

安装完成后，测试以下命令：

# 测试 OMO
ulw 你好

# 测试 Superpowers
帮我计划实现用户认证功能

# 测试 OpenSpec
openspec --version

---

3. 配置速查表

组件	安装命令	配置文件位置
OMO	在 opencode.json 添加 plugin	.opencode/oh-my-opencode.json 或 ~/.config/opencode/
Superpowers	Fetch INSTALL.md	~/.opencode/skills/
OpenSpec	npm install -g @fission-ai/openspec	项目目录 openspec/

常用命令速查

# OMO
ulw <需求>                    # 懒人模式，自动完成
/ralph-loop "<任务>"          # 不完成不停止
/ulw-loop "<任务>"            # 最大火力模式
/init-deep                    # 生成代码知识图谱
/refactor <模块> --scope=file # 安全重构
/start-work                   # 执行计划

# Superpowers
帮我计划<需求>                # 激活 brainstorming
帮我debug                     # 激活 systematic-debugging

# OpenSpec
openspec propose "<功能>"    # 创建提案
openspec verify              # 验证实现
openspec update              # 更新

---

4. Oh-My-OpenCode (OMO) 详细介绍

4.1 为什么选择 OMO

单纯 OpenCode 本身的局限：

• 前端开发：审美可能不太行
• 调试 Bug：容易原地打转
• 搜索文档：可能漏掉关键信息
• 任务做到一半：它觉得差不多了就停了

OMO 的解决方案：不是找一个更强的 AI，而是一支 AI 团队。

4.2 设计理念

原则	含义
人类干预 = 失败信号	如果需要手动修复 AI 的代码，那是 AI 的失职
代码不可区分	AI 写的代码应该和高级工程师写的一样好
Token 换生产力	多用 Token 换取效率提升是值得的

4.3 核心角色：Sisyphus

OMO 的主智能体叫 Sisyphus（西西弗斯）。寓意是：它会不断推动任务，直到完成为止。

“If Claude Code does in 7 days what a human does in 3 months, Sisyphus does it in 1 hour.”

---

5. OMO 智能体团队

5.1 核心智能体

智能体	职责	特点
Sisyphus	主编排器	规划、委派、执行，不完成不停止
Oracle	架构顾问	只分析诊断，不动手写代码
Librarian	文档专家	查官方文档、找开源实现、搜索代码
Explore	代码探索	快速搜索代码库
Multimodal-Looker	视觉分析	PDF、图片、图表分析

调用智能体

方式一：直接 @提及

问 @oracle 这个架构设计合不合理？
问 @librarian 这个库怎么用？
问 @explore 找一下用户认证相关的代码

方式二：通过 delegate_task 工具

delegate_task(agent="oracle", prompt="帮我分析这个设计")
delegate_task(agent="librarian", prompt="查一下 React Query 的最佳实践")

5.2 规划智能体

智能体	职责	特点
Prometheus	战略规划	访谈模式，问清楚再做
Metis	计划顾问	识别隐藏风险、歧义
Momus	计划评审	验证计划是否清晰、可验证、完整
Atlas	任务协调	执行 Prometheus 生成的计划

---

6. OMO 工作模式

6.1 Ultrawork 模式（懒人模式）

不想细想、直接干的时候用它。

激活方式：在提示词里加 ulw 或 ultrawork

ulw 给我的 Next.js 应用添加用户认证

特点：

• 自动探索代码库，理解现有代码模式
• 让 Librarian 研究最佳实践
• 按照代码规范实现功能
• 用诊断和测试验证结果
• 如果有问题就修，没问题才算完
• 并行执行：多个智能体同时工作

6.2 Prometheus 模式（精确控制模式）

复杂任务或关键变更时用它。

激活方式：按 Tab 键

Prometheus 会像产品经理一样访谈你：

• 你想实现什么功能？
• 有什么约束条件？
• 技术选型有偏好吗？
• 需要兼容现有的什么模块？

生成的计划保存在 .sisyphus/plans/ 目录。

执行计划：输入 /start-work

---

7. OMO 命令详解

命令速查

命令	说明	典型场景
/init-deep	生成代码库知识图谱	接手新项目
/ralph-loop	不完成不停止	实现完整功能
/ulw-loop	最大火力不停止	大型任务
/cancel-ralph	停下来	不想继续了
/refactor	安全重构	改代码不敢瞎改
/start-work	执行计划	Prometheus 规划后

/init-deep

生成代码库知识图谱，在每个目录下自动生成 AGENTS.md 文件。

/init-deep

执行后项目结构：

project/
├── AGENTS.md              # 项目级说明
├── src/
│   ├── AGENTS.md          # src 目录说明
│   └── components/
│       └── AGENTS.md      # 组件目录说明

大型项目可以限制深度：

/init-deep --max-depth=3

/ralph-loop

OMO 最核心的命令：不完成不停止。

# 实现完整功能
/ralph-loop "实现完整的用户认证系统，包含注册、登录、JWT、刷新令牌"

# 修复所有问题
/ralph-loop "修复所有 TypeScript 类型错误"

/ulw-loop

ralph-loop 和 ultrawork 的组合，最大火力输出。

# 全自动搭建项目
/ulw-loop "从零搭建一个 Next.js 电商网站"

# 大规模重构
/ulw-loop "将整个项目从 JavaScript 迁移到 TypeScript"

/refactor

安全重构，用 LSP 和 AST-grep 进行精确重构。

# 重构指定模块
/refactor auth --scope=module

# 重构单个文件
/refactor src/utils/helpers.ts --scope=file

安全机制：

• 每步变更后自动运行 lsp_diagnostics 检查
• 每步变更后自动运行测试
• 发现问题立即停止

/start-work

执行 Prometheus 生成的计划。

# 执行最近生成的计划
/start-work

# 从某个任务开始（跳过已完成的）
/start-work --from=task-3

---

8. 魔法关键词

只要在提示词里包含这些词，就能激活对应模式。

关键词	效果
ultrawork / ulw	最大并行，后台任务，深度探索
ultrathink	深度思考模式，适合复杂问题
search / find	增强搜索模式
analyze / investigate	深度分析模式

最简单的用法：

ulw 帮我实现一个完整的用户认证系统

---

9. OMO 内置技能

技能	用途
playwright	浏览器自动化：测试、截图、表单填写、网页爬取
frontend-ui-ux	UI/UX 设计任务，带设计师人格
git-master	Git 操作，原子提交原则

Git Master 原子提交

文件改动数	最少提交数
3+ 文件	2+ 个提交
5+ 文件	3+ 个提交
10+ 文件	5+ 个提交

---

10. OMO 任务分类

分类	用途
visual-engineering	前端、UI/UX、设计
ultrabrain	复杂推理、架构决策
artistry	创意、设计
quick	快速简单任务
writing	文档、技术写作

delegate_task(category="visual-engineering", prompt="设计一个响应式导航栏")

---

11. OMO 内置 MCP

服务	用途
websearch	实时网络搜索（Exa AI）
context7	查官方文档
grep_app	搜 GitHub 代码

---

12. OMO Hooks

Hook	功能
todo-continuation-enforcer	强制完成待办列表
comment-checker	防止过多注释
keyword-detector	检测魔法关键词
session-recovery	会话崩溃自动恢复

禁用 Hook：

{
  "disabled_hooks": ["comment-checker"]
}

---

13. OMO LSP 和 AST 工具

LSP 工具

• lsp_diagnostics - 获取错误和警告
• lsp_goto_definition - 跳转到定义
• lsp_find_references - 查找所有引用
• lsp_rename - 跨项目重命名
• lsp_symbols - 获取文件大纲

AST-Grep

• ast_grep_search - AST 感知搜索（25+ 语言）
• ast_grep_replace - AST 感知替换

---

14. OMO 配置示例

{
  "agents": {
    "oracle": { "model": "openai/gpt-5.2" },
    "librarian": { "model": "anthropic/claude-haiku-4-5" }
  },
  "categories": {
    "quick": { "model": "anthropic/claude-haiku-4-5" }
  },
  "disabled_hooks": ["comment-checker"]
}

---

15. Superpowers 配置详情

自动安装

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md

手动安装

mkdir -p ~/.opencode/skills
git clone https://github.com/obra/superpowers.git ~/.opencode/skills/superpowers

cd ~/.opencode/skills
for skill in brainstorming using-git-worktrees writing-plans test-driven-development requesting-code-review finishing-a-development-branch subagent-driven-development systematic-debugging verification-before-completion; do
  ln -s superpowers/skills/$skill skills/$skill
done

技能列表

测试相关

• test-driven-development - RED-GREEN-REFACTOR

调试相关

• systematic-debugging - 四阶段根因分析
• verification-before-completion - 完成前验证

协作相关

• brainstorming - Socratic 设计细化
• writing-plans - 详细实现计划
• executing-plans - 分批执行与检查点
• dispatching-parallel-agents - 并发子代理
• requesting-code-review - 代码审查前检查
• receiving-code-review - 响应代码审查
• using-git-worktrees - 并行开发分支
• finishing-a-development-branch - 合并/PR 决策
• subagent-driven-development - 双阶段审查

元技能

• writing-skills - 创建新技能
• using-superpowers - 技能系统介绍

omo集成superpower

.config/opencode/oh-my-opencode.json中增加以下配置

  "default_skills": [
	  "superpowers/skills/test-driven-development",    // 对应目录 test-driven-development
	  "superpowers/skills/receiving-code-review",      // 对应目录 receiving-code-review
  ]

---

16. OpenSpec 配置详情

安装

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

初始化

cd your-project
openspec init
openspec update

常用命令

openspec propose "add-user-authentication"  # 创建提案
openspec verify                             # 验证实现
openspec sync                               # 同步变更
openspec archive                            # 归档

---

17. 组合使用建议

场景	推荐命令
快速开发	ulw <需求>
大型任务	/ulw-loop "<任务>"
复杂规划	[按 Tab] 定义需求 -> /start-work
调试修复	/ralph-loop "修复问题"
安全重构	/refactor <模块> --scope=module
代码审查	使用 Superpowers requesting-code-review

---

常见问题

Q1: OMO 和 Superpowers 会冲突吗？

不会。官方声明 Claude Code Compatible，所有 hook、command、skill、MCP、plugin 都能正常工作。

Q2: 配置后不工作？

1. 重启 OpenCode
2. 检查配置文件语法
3. 确认 Node.js 版本 >= 20.19.0

---

参考资源

• OpenSpec 官方文档
• Superpowers 官方仓库
• OpenCode 官方仓库
• Oh-My-OpenCode 官方仓库

---

文档版本：1.2
最后更新：2026-03-01