Fork me on Github

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 - 技能系统介绍

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
posted @ 2026-06-12 15:04  昂昂呀  阅读(52)  评论(0)    收藏  举报