OpenCode + Oh My OpenCode 完整学习路径

从零基础到专家级，系统掌握 AI 编程助手的完整学习指南

序言：为什么是 OpenCode

什么是 OpenCode

OpenCode 是一款开源的 AI 编程助手（AI Coding Assistant），专为开发者设计，旨在通过自然语言交互提升编程效率。它运行在终端环境中，能够直接读取、理解和修改你的代码文件，执行命令，自动化繁琐的开发任务。

简单来说，OpenCode 是你终端里的”AI 结对编程伙伴”——你可以用自然语言描述需求，它会帮你分析代码、实现功能、修复 Bug、重构项目，甚至管理你的开发工作流。

使用 OpenCode 的好处

1. 显著提升开发效率

快速理解代码：面对陌生代码库，几分钟内即可获得结构梳理和逻辑分析
自动化编码：自然语言描述需求，AI 自动生成可运行的代码
智能重构：安全地重构代码，保持功能不变的同时提升代码质量
Bug 快速定位：系统化分析错误原因，提供修复方案

2. 降低认知负担

减少上下文切换：无需在编辑器、浏览器、文档之间来回切换
记忆代码细节：AI 记住项目结构和上下文，无需你反复说明
统一工作流：从需求分析到代码实现再到测试，全流程在终端完成

3. 提升代码质量

最佳实践建议：内置丰富的编码规范和最佳实践
持续代码审查：AI 实时审查代码，发现问题并建议改进
自动生成测试：根据代码自动生成单元测试和集成测试

4. 支持团队协作

项目知识沉淀：通过 AGENTS.md 和规则文件固化团队规范
新人快速上手：新员工通过 OpenCode 快速理解项目代码
知识共享：Skill 系统封装团队专有知识，统一团队工作方式

OpenCode 的核心优势

1. 多模型支持（Model Agnostic）

OpenCode 不绑定单一模型，支持接入多种 AI 模型：

模型提供商	推荐场景	特点
智谱 GLM-4.7	国内用户日常使用	国内直连，速度快，性价比高
DeepSeek	复杂逻辑任务	推理能力强，适合算法实现
Claude	代码质量和架构设计	代码理解能力强，输出质量高
OpenAI GPT/Codex	通用开发任务	生态完善，能力均衡
本地模型	隐私敏感场景	数据不出本地，完全离线

优势：根据任务类型选择最适合的模型，既能保证质量又能控制成本。

2. Plan/Build 双模式工作流

OpenCode 独创的规划模式（Plan）和执行模式（Build）：

Plan 模式：只读分析，适合代码理解、方案设计、架构规划
Build 模式：读写执行，适合功能实现、Bug 修复、代码重构

优势：避免 AI”一上来就改代码”的问题，先想清楚再动手，大幅降低返工成本。

3. 强大的 Agent 系统

OpenCode 内置了完整的 Agent 系统：

Primary Agents：Plan 和 Build，通过 Tab 键快速切换
Sub Agents：Oracle（架构专家）、Librarian（图书管理员）、Frontend Engineer（前端专家）等专业 Agent
自定义 Agent：根据项目需求创建专属 Agent

优势：专业问题交给专业 Agent，如同拥有一个”数字开发团队”。

4. Oh My OpenCode 增强生态

Oh My OpenCode 是 OpenCode 的增强插件层，提供：

多 Agent 协作框架：Prometheus（战略规划）、Atlas（执行编排）、Sisyphus（实际执行）
Categories + Skills 架构：动态组合最适合当前任务的 Agent
Ralph Loop 自动闭环：AI 持续迭代直到任务完成
Ultrawork 混合模型调度：智能路由到最优模型组合

优势：从”辅助工具”进化为”智能编排系统”。

5. 开源与可扩展

OpenCode 完全开源，提供丰富的扩展能力：

自定义 Command：将常用命令封装为一键触发
Skill 系统：封装复杂指令和工作流
MCP 扩展：连接外部服务和数据源
插件开发：通过 Hook 机制扩展功能

优势：完全掌控工具，根据团队需求深度定制。

6. 优秀的国内支持

相比其他 AI 编程工具，OpenCode 对国内用户更友好：

国产模型直连：智谱、DeepSeek、MiniMax 等国内模型无需翻墙
OpenCode Zen：官方提供的免费模型服务
中文社区：活跃的中文用户社区和文档
本地化优化：针对国内开发环境的特殊优化

OpenCode vs Claude Code：如何选择

Claude Code 是 Anthropic 官方推出的 AI 编程工具，与 OpenCode 有许多相似之处。以下是两者的对比：

功能对比

特性	OpenCode	Claude Code
模型支持	多模型（Claude、GPT、DeepSeek、GLM 等）	仅 Claude 系列
费用	自主选择模型，灵活控制成本	绑定 Claude 订阅，费用较高
国内访问	支持国产模型直连，无需翻墙	需要特定网络环境
开源	完全开源，可自由定制	闭源，无法修改
Agent 系统	丰富的多 Agent 协作（Oh My OpenCode）	基础 Agent 支持
Skill 生态	完善的 Skill 市场（skills.sh）	Skill 支持较新
Ralph Loop	原生支持自动闭环	需要额外配置
社区生态	活跃的中文社区	主要面向海外用户

适用场景建议

选择 OpenCode，如果你：

希望使用多种 AI 模型，灵活控制成本
需要国产模型直连，不想折腾网络
想要深度定制工具，满足团队特殊需求
重视开源，希望完全掌控工具
是中文用户，希望有中文文档和社区支持
想要使用 Oh My OpenCode 的多 Agent 协作和 Ralph Loop 等高级功能

选择 Claude Code，如果你：

只信任 Anthropic 的 Claude 模型
已经是 Claude Pro 订阅用户
需要官方直接支持和服务保障
使用场景简单，不需要复杂定制

实际上…

两者并非完全对立：

OpenCode 可以接入 Claude 模型：如果你喜欢 Claude 的能力，但想要 OpenCode 的灵活性和扩展性，可以在 OpenCode 中使用 Claude 模型
技能互通：很多在 Claude Code 中使用的 Skill（如 skills.sh 上的 Skill）也可以在 OpenCode 中使用
工作流相似：两者都支持 Plan/Build 工作流，学习成本可以复用

谁适合使用 OpenCode

OpenCode 适合以下人群：

开发者

全栈工程师：快速实现功能，管理复杂项目
前端开发者：UI/UX 开发、组件库维护
后端工程师：API 开发、数据库设计、系统架构
算法工程师：算法实现、数据分析、模型部署

技术管理者

架构师：系统设计、代码审查、技术决策
技术负责人：团队规范制定、项目初始化、代码质量管控
CTO/VP：技术选型、团队效率提升、知识沉淀

其他技术人员

DevOps 工程师：CI/CD 流程、自动化脚本、基础设施管理
数据工程师：数据处理、ETL 流程、报表生成
产品经理：快速原型、需求文档、数据分析
技术写作者：文档编写、教程制作、内容管理

学习路径概述

本文档分为三个部分，循序渐进地帮助你掌握 OpenCode：

第一部分：初级篇 - 快速上手

安装配置、基础操作、基础工作流
目标：能在日常开发中使用 OpenCode 辅助工作

第二部分：进阶篇 - 效率提升

Oh My OpenCode、Ralph Loop、扩展任务、定制配置
目标：掌握高级工作流，显著提升开发效率

第三部分：高级篇 - 专家级别

高级定制、高级工作流、团队协作
目标：深度定制 OpenCode，构建团队级解决方案

预计学习时间：2-4 周（视个人基础和投入时间而定）

开始之前

使用 OpenCode 需要：

基本的终端/命令行操作知识
一定的编程基础（至少一种编程语言）
开放的心态，愿意尝试新的工作方式

不需要：

深厚的 AI 知识（OpenCode 帮你封装了复杂性）
昂贵的硬件（普通电脑即可运行）
海外网络（国产模型直连支持）

准备好了吗？让我们开始这段学习旅程！

第一部分：初级篇

目标：30 分钟内完成安装并成功对话，掌握基础操作和日常开发流程

第 1 章：安装与起步

学习目标

理解 OpenCode 是什么以及能做什么
成功安装 OpenCode 且不报错
搞定网络连接（国内用户重点）
完成第一次 “Hello World” 对话

学习内容

1.1 OpenCode 简介

OpenCode 是一款 AI 编程助手，能够：

理解代码并辅助开发
自动完成文件操作和代码重构
支持多模型接入（Claude、GPT、DeepSeek 等）
提供 Plan/Build 双模式工作流
通过 Agent 系统实现任务编排

1.2 安装步骤

一键安装（推荐）：

# macOS/Linux
curl -fsSL https://opencode.ai/install.sh | sh

# Windows (PowerShell)
iwr -useb https://opencode.ai/install.ps1 | iex

验证安装：

opencode --version

1.3 网络配置（国内用户必读）

国内用户可能遇到连接问题，解决方案：

使用国产模型（推荐）：智谱 GLM-4.7、DeepSeek、MiniMax、通义千问等
配置代理：在 ~/.opencode/config.json 中设置代理
使用 OpenCode Zen：官方提供的免费模型服务

1.4 连接模型

配置模型提供商：

{
  "$schema": "https://opencode.ai/config.json",
  "model": {
    "provider": "zhipu",
    "model": "glm-4.7"
  }
}

支持的模型提供商：

OpenCode Zen（免费）
智谱 GLM-4.7（推荐，国内直连）
DeepSeek
MiniMax
通义千问
Claude（Anthropic）
OpenAI（GPT / Codex）
Ollama（本地部署）

1.5 第一次对话

# 进入项目目录
cd ~/my-project

# 启动 OpenCode
opencode

# 输入测试
你好，请介绍一下你自己

练习题目

安装验证：在终端运行 opencode --version，确认安装成功
模型配置：选择一个国产模型（如智谱 GLM-4.7）并完成配置
首次对话：成功发送 “Hello World” 并收到回复
自动更新：了解 OpenCode 的自动更新机制

参考资料

第 2 章：基础操作

学习目标

熟悉 OpenCode 的 TUI 界面和核心操作
掌握 @、!、/ 三件套语法
学会管理对话（新建、切换、撤销、导出）
了解常用快捷键

学习内容

2.1 TUI 界面导览

OpenCode 采用终端用户界面（TUI），主要区域：

对话区域：显示用户输入和 AI 回复
状态栏：显示当前 Agent、模型、模式
输入框：底部输入命令或问题

2.2 核心语法三件套

@ - 引用文件/代码：

@src/main.ts 请分析这个文件
@src/utils.ts#L10-20 解释这几行代码
@docs/README.md 总结文档内容

! - 执行命令：

!npm install
!git status
!python test.py

/ - 斜杠命令：

/help          # 显示帮助
/undo          # 撤销上次更改
/init          # 初始化项目
/clear         # 清空对话

2.3 对话管理

创建新对话：

Ctrl + n 或输入 /new

切换对话：

Ctrl + p / Ctrl + n 在历史对话间切换

撤销更改：

输入 /undo 撤销最近一次对话变更（需要 Git 仓库）

导出对话：

2.4 常用快捷键

快捷键	功能
`Tab`	切换 Plan/Build 模式
`Ctrl + x`	Leader 键（组合键前缀）
`Ctrl + x, a`	显示 Agent 列表
`Ctrl + x, m`	切换模型
`Ctrl + c`	取消当前操作
`Ctrl + n`	新建对话

练习题目

文件引用练习：使用 @文件名 引用项目中的文件并提问
命令执行练习：使用 !命令 执行一个简单的 bash 命令（如 !ls -la）
斜杠命令练习：尝试 /help 和 /clear 命令
对话管理练习：创建一个新对话，然后切换回之前的对话

参考资料

第 3 章：基础工作流

学习目标

理解 Plan 模式和 Build 模式的区别
掌握 Plan → Build 的标准开发流程
学会使用 /init 初始化项目
能够在日常开发中运用 AI 辅助

学习内容

3.1 Plan vs Build 模式详解

Plan Agent（规划模式）：

特点：只读分析，写文件/执行命令前会询问
用途：代码分析、方案设计、架构规划
权限：edit: ask, bash: ask

Build Agent（执行模式）：

特点：读写执行，可直接修改文件和运行命令
用途：功能实现、Bug 修复、代码重构
权限：edit: allow, bash: allow

切换方式：按 Tab 键切换，状态栏显示当前模式

3.2 标准开发工作流

理解代码(Plan) → 制定方案(Plan) → 实现功能(Build) → 验证测试(Build)

步骤详解：

理解代码（Plan 模式）：

@explore 帮我梳理项目结构
@src/main.ts 分析这个文件的核心逻辑

制定方案（Plan 模式）：

我要添加 XX 功能，请帮我分析：
1. 需要修改哪些文件
2. 推荐的实现方案
3. 每种方案的优缺点

实现功能（Build 模式）：

按照方案一实现功能，第一步先创建 XX 文件

验证测试（Build 模式）：
```
!npm test
!npm run build
```

3.3 项目初始化（`/init`）

使用 /init 命令让 AI 理解你的项目：

/init

AI 会：

分析项目结构和文件
生成 AGENTS.md 规则文件
理解项目的技术栈和规范

3.4 文件操作技巧

读取文件：

@README.md 请总结这个文档

批量读取：

@glob **/*.ts 分析所有 TypeScript 文件

搜索内容：

搜索包含 "auth" 的所有文件

练习题目

模式切换练习：在 Plan 和 Build 模式间切换，观察状态栏变化
项目分析练习：进入你的一个项目，用 Plan 模式分析项目结构
功能实现练习：用 Plan → Build 流程实现一个小功能（如添加一个工具函数）
初始化练习：在一个新项目中运行 /init，查看生成的 AGENTS.md

参考资料

第二部分：进阶篇

目标：掌握 Oh My OpenCode 增强插件、Ralph Loop 自动闭环、高级定制和工作流优化

第 4 章：Oh My OpenCode 增强插件

学习目标

理解 Oh My OpenCode 的核心概念和价值
完成 Oh My OpenCode 的安装和配置
掌握多 Agent 协作的使用方法
了解 Categories + Skills 架构

学习内容

4.1 Oh My OpenCode 简介

是什么： Oh My OpenCode 是为 OpenCode 量身定制的增强插件层，引入了”多智能体（Multi-Agent）“协作框架。

核心价值：

从”辅助工具”进化为”数字开发团队”
专业小 Agent（Sub-agents）各司其职
AST 感知、自动规则 Hooks、会话压缩等高级功能

4.2 安装步骤

一键安装：

bunx oh-my-opencode install

配置文件位置：

全局级：~/.config/opencode/oh-my-opencode.json
项目级：项目根目录/.opencode/oh-my-opencode.json（推荐）

4.3 核心 Agent 介绍

Prometheus（普罗米修斯）：

角色：战略规划者
职责：需求澄清、方案设计、计划制定
工作流程：深度访谈 → 草稿计划 → 验证计划 → 定稿计划

Atlas（阿特拉斯）：

角色：总指挥官
职责：任务分解、资源分配、执行编排、错误恢复
核心命令：/start-work 启动计划执行

Sisyphus（西西弗斯）：

角色：执行者
职责：实际编码工作，强调”什么该让别人干”
特点：更激进的委托策略

专家 Sub-agents：

Oracle（神谕者）：专注架构审查和顶层设计分析
Librarian（图书管理员）：专注全局文档检索和代码库索引
Frontend Engineer（前端工程师）：专注 UI/UX 相关逻辑

4.4 Categories + Skills 架构（v3.0+）

设计哲学：组合优于继承

Categories（模型抽象）：

Category	适用场景
`visual-engineering`	前端、UI/UX、设计
`ultrabrain`	复杂逻辑任务
`deep`	深度研究、复杂问题
`quick`	简单快速任务
`writing`	文档、写作任务

Skills（能力注入）：

Skill	功能
`frontend-ui-ux`	UI/UX 设计能力
`git-master`	Git 操作专家
`systematic-debugging`	系统化调试

组合示例：

重构 React 组件 = visual-engineering category + frontend-ui-ux skill

4.5 Ultrawork 模式

混合模型调度：

编排协调：Claude 4.5 Sonnet
日常任务：GLM 4.7（便宜量大）
复杂逻辑：GPT 5.2 Codex X-High

成本优化：智能路由组合比单模型节省 30-50% 成本

练习题目

安装练习：完成 Oh My OpenCode 的安装并验证
配置练习：创建项目级配置文件，配置至少一个自定义 Agent
多 Agent 协作练习：使用 Prometheus 制定计划，然后使用 Atlas 执行
Category + Skill 练习：使用 visual-engineering + frontend-ui-ux 完成一个 UI 任务

参考资料

第 5 章：Ralph Loop 自动闭环

学习目标

理解 Ralph Loop 的概念和工作原理
掌握 Ralph Loop 的使用方法
能够设计适合 Ralph Loop 的任务
了解 Ralph Loop 的适用场景和限制

学习内容

5.1 Ralph Loop 概念

是什么： Ralph Loop 是一种让 AI 持续迭代直到真正完成任务的工作范式，解决”AI 能不能坚持把事做完”的问题。

核心机制： 1. 无限循环（但有上限）：AI 反复尝试直到完成 2. 干净上下文：每一轮都是新对话，避免上下文污染 3. 客观完成条件：测试是否全绿、字数是否达标等 4. 状态持久化：通过文件、日志、Git 保存状态

5.2 工作流程

读取当前状态 → 做一小步改进 → 写回状态 → 检查完成条件 → 未完成则继续循环

5.3 使用方法

方式一：使用 /ralph-loop 命令：

/ralph-loop 实现一个用户认证系统，要求：
1. 支持 JWT 认证
2. 包含登录/注册接口
3. 通过所有测试用例

方式二：配置文件开启：

{
  "ralph_loop": {
    "enabled": true,
    "max_iterations": 10
  }
}

方式三：使用 opencode-ralph 工具：

# 安装
npm install -g opencode-ralph

# 使用
opencode-ralph --prompt "实现功能 X" --max-iterations 5

5.4 Prompt 黄金结构

## 任务目标
明确描述要完成什么

## 执行步骤
一次只做一小步

## 必须读取的文件
列出需要参考的文件

## 清晰的完成标准
- 标准 1：可验证的条件
- 标准 2：可验证的条件

5.5 适用场景

适合使用：

明确完成标准的任务
需要循环迭代才能完成的任务
Greenfield 项目（从零开始）
可以自动验证的任务（如测试通过）

不适合使用：

需要人工判断或设计决策的任务
一次性操作
成功标准不清晰的任务

练习题目

基础练习：使用 /ralph-loop 完成一个简单的工具函数编写
验证条件练习：设计一个带有明确验证条件的任务（如”实现并通过测试”）
迭代观察练习：运行 Ralph Loop 并观察 AI 的迭代过程
边界条件练习：尝试在 Ralph Loop 中设置最大迭代次数

参考资料

第 6 章：扩展到其他任务

学习目标

掌握 AI 辅助写作工作流
学会使用 OpenCode 进行内容创作
掌握办公效率提升技巧
了解文件整理和数据处理方法

学习内容

6.1 文档写作工作流

核心思路：

构思(Plan) → 输出(Build) → 迭代(Build)

步骤详解：

构思阶段（Plan 模式）：

我想写一篇关于"远程办公的利与弊"的文章，目标读者是职场新人。
请帮我：
1. 确定文章结构
2. 列出每个部分的要点
3. 建议一个吸引人的标题

输出阶段（Build 模式）：

按照刚才讨论的大纲，写出完整的文章，保存为 远程办公的利与弊.md

迭代阶段（Build 模式）：

@远程办公的利与弊.md 开头太平淡了，用一个引人入胜的场景描写开场

Prompt 模板示例：

## 角色
你是资深内容策划师，擅长结构化思考和内容规划。

## 任务
根据用户提供的主题，生成完整的文章框架和大纲。

## 输入信息
- 文章主题：【主题】
- 目标读者：【读者画像】
- 字数要求：【字数】

## 输出规范
1. 文章定位（核心观点、目标读者痛点）
2. 文章结构（开头、中间、结尾）
3. 每部分要点
4. 备选标题（3个）

6.2 办公效率提升

文件整理三步法：

分析现状 → 制定规则 → 批量执行

常用工具： - list：列出目录（树形结构） - glob：按模式查找文件 - grep：搜索文件内容 - bash：执行命令

批量重命名示例：

把这个目录下所有的图片文件按以下规则重命名：
- 格式：照片_YYYYMMDD_序号.扩展名
- 日期从文件修改时间获取
- 序号从 001 开始

要求：
1. 先只输出"将要修改的文件清单"，不要执行
2. 我确认后再执行

分类归档示例：

把这个目录下的文件按类型分类到子目录：
- 图片 → 图片/
- 文档 → 文档/
- 视频 → 视频/
- 其他 → 其他/

练习题目

写作练习：用 Plan → Build 流程完成一篇 800 字的文章
文件整理练习：整理一个混乱的下载文件夹，批量重命名并分类
内容搜索练习：使用 grep 搜索包含特定关键词的文件
数据处理练习：用 AI 分析一个 CSV 文件并生成报表

参考资料

第 7 章：定制与高级配置

学习目标

掌握 OpenCode 的配置系统
学会创建自定义 Command
理解 Skill 的概念和用法
能够编写自定义 Prompt

学习内容

7.1 配置系统

配置文件位置：

全局配置：~/.opencode/config.json
项目配置：项目根目录/.opencode/config.json

基础配置示例：

{
  "$schema": "https://opencode.ai/config.json",
  "model": {
    "provider": "zhipu",
    "model": "glm-4.7"
  },
  "permission": {
    "edit": "ask",
    "bash": "ask"
  }
}

7.2 自定义 Command

定义 Command：

{
  "commands": {
    "test": {
      "description": "运行测试",
      "steps": [
        "!npm test"
      ]
    },
    "lint": {
      "description": "运行代码检查",
      "steps": [
        "!npm run lint"
      ]
    }
  }
}

使用 Command：

/test
/lint

7.3 Skill 系统

什么是 Skill： Skill 是封装复杂指令的模块，可以注入到 Agent 中增强其能力。它们是”模块化、自包含的包”，通过提供专业领域知识、工作流和工具来扩展 Claude 的能力。可以理解为特定领域的”入职指南”——将 Claude 从通用 Agent 转变为具备领域专业知识的专门 Agent。

Skill 生态系统：

OpenCode 支持丰富的 Skill 生态系统，可以在 skills.sh 发现和安装各种 Skill。这是官方的 Skill 市场和仓库集合，包含了社区贡献的各类专业技能包。

Skill 能提供的价值：

专业工作流 - 特定领域的多步骤程序
工具集成 - 与特定文件格式或 API 配合的说明
领域专业知识 - 公司特定的知识、架构、业务逻辑
捆绑资源 - 脚本、参考资料和复杂重复任务的资源

Skill 结构：

# .opencode/skills/my-skill.yaml
name: my-skill
description: 我的自定义技能
instructions: |
  当执行 XX 任务时：
  1. 步骤一
  2. 步骤二
  3. 步骤三

使用 Skill：

{
  "agent": {
    "build": {
      "skills": ["my-skill"]
    }
  }
}

安装 Skill（通过 skills.sh）：

# 安装 skill-creator（用于创建 Skill 的工具）
npx skills add https://github.com/anthropics/skills --skill skill-creator

# 安装 remotion-best-practices（Remotion 视频开发最佳实践）
npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices

# 安装 superpowers 系列 Skill
npx skills add https://github.com/obra/superpowers --skill brainstorming
npx skills add https://github.com/obra/superpowers --skill systematic-debugging

著名 Skill 介绍：

1. skill-creator（由 Anthropic 官方提供）

用途：指导如何创建有效的 Skill
核心价值：提供 Skill 创建的完整流程和最佳实践
包含内容：
- Skill 的核心设计原则（简洁、适当的自由度设置）
- Skill 的解剖结构（SKILL.md + 可选资源）
- Skill 创建六步法（理解、规划、初始化、编辑、打包、迭代）
- 渐进式披露设计原则（三级加载系统）
使用场景：当你需要创建自定义 Skill 时，先使用此 Skill 学习最佳实践
安装：npx skills add https://github.com/anthropics/skills --skill skill-creator

2. remotion-best-practices（由 Remotion 团队提供）

用途：Remotion（React 视频创作库）开发的最佳实践
核心价值：提供视频/动画开发的专业指导
包含内容：
- 3D 内容（Three.js、React Three Fiber）
- 动画基础、音频处理、字体加载
- 图片、视频、GIF 嵌入
- 转场效果、时间轴控制
- Lottie 动画、图表可视化
- TailwindCSS 集成、文字动画
使用场景：使用 Remotion 开发视频项目时自动触发
安装：npx skills add https://github.com/remotion-dev/skills --skill remotion-best-practices
统计数据：周安装量 58.7K，支持 claude-code、cursor、opencode 等工具

3. superpowers 系列（由 obra 提供）这是一套开发工作流增强 Skill 集合，共 14 个 Skill，总安装量 44.3K：

Skill	用途	安装量
`brainstorming`	创意工作前的头脑风暴，探索用户意图、需求和设计	6.5K
`systematic-debugging`	系统化调试，在遇到 Bug 或测试失败时使用	3.9K
`test-driven-development`	测试驱动开发，在写实现代码前使用	3.6K
`writing-plans`	编写实施计划，在有需求规格时使用	3.4K
`executing-plans`	执行实施计划，在独立会话中执行计划	3.2K
`subagent-driven-development`	子 Agent 驱动开发，在当前会话执行计划	2.9K
`requesting-code-review`	请求代码审查，完成任务或合并前使用	2.8K
`using-superpowers`	使用 Skill 的指南，每次对话开始时使用	2.8K
`verification-before-completion`	完成前验证，在声称完成前要求运行验证命令	2.7K
`writing-skills`	编写 Skill，创建或编辑 Skill 时使用	2.7K
`using-git-worktrees`	使用 Git Worktrees，功能开发隔离	2.6K
`dispatching-parallel-agents`	并行 Agent 调度，2+ 独立任务时	2.5K
`receiving-code-review`	接收代码审查反馈，实施建议前使用	2.5K
`finishing-a-development-branch`	完成开发分支，决定如何集成工作	2.2K

安装示例：npx skills add https://github.com/obra/superpowers --skill brainstorming

4. 其他常用 Skill：

Skill	用途	来源
`git-master`	Git 操作专家	OpenCode 内置
`frontend-ui-ux`	UI/UX 设计能力	OpenCode 内置
`systematic-debugging`	系统化调试	obra/superpowers
`playwright`	浏览器自动化测试	社区贡献
`pdf`	PDF 操作	社区贡献
`docx`	Word 文档处理	社区贡献
`pptx`	PPT 制作	社区贡献

Skill 设计核心原则：

简洁是关键：上下文窗口是公共资源，只添加 Claude 没有的上下文
设置适当的自由度：
- 高自由度（文本说明）：多种方法都有效时
- 中自由度（伪代码或参数化脚本）：有首选模式但允许变化时
- 低自由度（特定脚本）：操作易错或必须遵循特定序列时
渐进式披露：三级加载系统管理上下文
- 元数据（name + description）- 始终在上下文
- SKILL.md 正文 - Skill 触发时加载
- 捆绑资源 - Claude 按需加载

Skill 创建流程（使用 skill-creator）：

1. 理解 Skill（通过具体例子）
2. 规划可重用内容（脚本、参考资料、资源）
3. 初始化 Skill（运行 init_skill.py）
4. 编辑 Skill（实现资源和编写 SKILL.md）
5. 打包 Skill（运行 package_skill.py）
6. 根据实际使用迭代

7.4 全局规则（Global Rules）

创建规则文件：

# .opencode/rules.md

## 编码规范
- 使用 2 空格缩进
- 变量名使用 camelCase
- 函数名使用动词开头

## 注释规范
- 代码注释使用中文
- 复杂逻辑必须添加注释

练习题目

配置练习：创建一个项目级配置文件，配置自定义模型和权限
Command 练习：创建两个自定义 Command（如 /build 和 /deploy）
Skill 练习：创建一个简单的 Skill 并将其应用到 Build Agent
规则练习：为项目创建 rules.md，定义编码规范

参考资料

第 8 章：进阶工作流与最佳实践

学习目标

掌握高效的工作流技巧
了解 OpenCode 最佳实践清单
学会使用 ulw/ultrawork 触发词
掌握进阶工作流模式

学习内容

8.1 核心工作流

推荐核心工作流程：

进入项目目录 → 执行 /init 初始化 → 切换至 Plan 模式 → 
添加 ulw 或 ultrawork 触发词 → 审阅方案 → 切换至 Build 模式 → 确认执行

关键原则：

先完成 Plan 阶段确认整体方案
再进入 Build 阶段实施
主动干预和精确引导可大幅降低返工成本

8.2 ulw / ultrawork 触发词

使用场景：在需求描述前添加 ulw 或 ultrawork，用于：

复杂功能开发
完整模块实现
系统级重构

示例：

ultrawork 重构整个用户认证模块，要求：
1. 使用 JWT 认证
2. 支持刷新令牌
3. 添加 Rate Limiting

8.3 进阶技巧清单

文件及代码行精准引用：

@文件名#L行号-行号
@src/utils.ts#L10-20

子 Agent 快速切换： - Ctrl + x + 方向键

模型快速切换： - Ctrl + x + m

直接执行终端命令：

!npm run dev
!git log --oneline -10

全局规则文件： - 项目根目录创建 .opencode/rules.md

Ralph Loop 自动迭代：

/ralph-loop 实现功能 X，通过所有测试

编辑器集成模式： - 安装 OpenCode VSCode/Cursor 扩展

8.4 进阶使用总结

场景	解决方案
需要高质量、完整实现	始终使用 ulw/ultrawork
需要控制方向、避免发散	强制先执行 Plan 阶段
需要针对性修改特定代码	使用 (文件?) #行号
处理中大型或多技术栈项目	部署 Oh My OpenCode
对当前模型表现不满意	使用 Ctrl+x + m 切换模型
追求代码质量极致	开启 /ralph_loop 模式

练习题目

核心工作流练习：完整走一遍推荐的核心工作流程
ultrawork 练习：使用 ultrawork 触发词完成一个中等复杂度的任务
精准引用练习：使用 @文件#L行号 对特定代码段进行修改
模型切换练习：使用快捷键切换不同模型，观察回复差异

参考资料

第三部分：高级篇

目标：深度定制 OpenCode，构建个人专属工作流，实现团队协作

第 9 章：高级定制

学习目标

掌握 Agent 系统的高级配置
能够创建自定义 Agent
掌握 Skill 的高级用法
了解权限管控和安全配置

学习内容

9.1 Agent 系统高级配置

Agent 配置结构：

{
  "agent": {
    "build": {
      "mode": "primary",
      "model": "anthropic/claude-opus-4-5-thinking",
      "temperature": 0.3,
      "permission": {
        "edit": "allow",
        "bash": "allow"
      },
      "maxSteps": 50
    },
    "plan": {
      "mode": "primary",
      "model": "anthropic/claude-opus-4-5-thinking",
      "temperature": 0.1,
      "permission": {
        "edit": "ask",
        "bash": "ask"
      }
    }
  }
}

配置项说明： - mode：primary（主 Agent）或 sub（子 Agent） - model：模型格式 provider/model-id - temperature：随机性控制（0-1），越低越专注 - permission.edit：文件编辑权限（ask/allow/deny） - permission.bash：命令执行权限（ask/allow/deny） - maxSteps：最大工具调用次数

9.2 创建自定义 Agent

步骤：

定义 Agent：

{
  "agent": {
    "my-agent": {
      "mode": "sub",
      "model": "zhipu/glm-4.7",
      "temperature": 0.2,
      "systemPrompt": "你是前端开发专家，专注于 React 和 TypeScript...",
      "skills": ["frontend-ui-ux", "react-patterns"]
    }
  }
}

调用 Agent：

@my-agent 请帮我分析这个组件的性能问题

9.3 Skill 高级用法

创建复杂 Skill：

# .opencode/skills/code-review.yaml
name: code-review
description: 代码审查专家
instructions: |
  当审查代码时，请按以下步骤：
  
  1. **理解代码**
     - 阅读代码，理解其功能和意图
     - 识别使用的编程语言和框架
  
  2. **检查问题**
     - [ ] 代码风格是否一致
     - [ ] 是否有潜在 Bug
     - [ ] 是否有性能问题
     - [ ] 是否缺少错误处理
     - [ ] 是否缺少测试
  
  3. **输出审查报告**
     - 严重问题（必须修复）
     - 建议改进（可选）
     - 正面反馈（做得好的地方）

examples:
  - input: "请审查这个函数"
    output: "审查报告..."

Skill 注入点： - Agent 级别：特定 Agent 使用 - 全局级别：所有 Agent 使用 - 任务级别：单次对话使用

9.4 权限管控

权限配置：

{
  "permission": {
    "edit": "ask",    // 写文件前询问
    "bash": "ask",    // 执行命令前询问
    "read": "allow",  // 读取文件允许
    "webfetch": "ask" // 获取网页前询问
  }
}

安全最佳实践：

对敏感操作使用 ask 模式
为不同项目设置不同的权限级别
定期审查和更新权限配置

练习题目

Agent 配置练习：创建一个自定义子 Agent，配置特定的 systemPrompt 和 skills
复杂 Skill 练习：创建一个包含 checklist 的代码审查 Skill
权限配置练习：为项目配置分层权限（敏感操作为 ask，普通操作为 allow）
组合练习：创建一套完整的自定义 Agent + Skill + 权限配置

参考资料

第 10 章：高级工作流

学习目标

了解 Claude Code 之父的工作流
掌握 13 条高级使用技巧
学习黑客松冠军的配置方案
能够构建可复制的 Claude Code 配置

学习内容

10.1 Claude Code 之父的工作流

核心原则：

Think first, code later - 先思考，后编码
Small steps, big wins - 小步快跑，积小胜为大胜
Trust but verify - 信任但要验证

工作流模式：

1. 深度理解需求（与 AI 充分沟通）
2. 制定详细方案（Plan 模式）
3. 分步实施（Build 模式）
4. 持续验证（测试和审查）
5. 迭代优化（Ralph Loop）

10.2 13 条高级使用技巧

技巧清单：

使用 AGENTS.md 固化项目规范
- 在项目根目录创建 AGENTS.md
- 包含项目架构、编码规范、常用命令
善用 @ 引用精确代码
- @文件名#L行号 引用特定代码行
- @文件名 引用整个文件
活用 ! 执行命令
- 在对话中直接执行命令
- 查看命令输出并继续对话
Plan/Build 模式切换
- 复杂任务先用 Plan 分析
- 确认方案后切 Build 执行
自定义 Command 加速常用操作
- 将常用命令封装为 /command
- 如 /test、/lint、/deploy
使用 Skill 封装复杂逻辑
- 将重复性工作封装为 Skill
- 在需要时注入 Skill
配置多个模型灵活切换
- 不同任务使用不同模型
- 快捷键 Ctrl+x, m 快速切换
利用 Ralph Loop 自动迭代
- 适合有明确完成标准的任务
- 设置合理的最大迭代次数
使用 glob/grep 批量处理
- glob **/*.ts 查找所有 TS 文件
- grep pattern 搜索代码内容
配置全局规则统一风格
- 使用 .opencode/rules.md
- 统一代码风格和规范
活用 undo 回滚错误操作
- /undo 撤销最近一次更改
- 需要 Git 仓库支持
使用子 Agent 分工协作
- 不同子 Agent 负责不同领域
- (agent?) 调用特定专家
定期压缩会话保持效率
- 长对话会降低 AI 效率
- 使用上下文压缩功能

10.3 黑客松冠军配置方案

CLAUDE.md 模板：

# CLAUDE.md

## 项目概述
- 项目名称：XXX
- 技术栈：React + TypeScript + Node.js
- 架构模式：MVC / 微服务 / 单体

## 编码规范
- 缩进：2 空格
- 变量命名：camelCase
- 函数命名：动词开头
- 注释语言：中文

## 常用命令
- `npm run dev`：启动开发服务器
- `npm test`：运行测试
- `npm run build`：构建项目

## 目录结构

Rules.md 模板：

# Rules

## 代码风格
- 优先可读性，做最简单的修改
- 禁止使用 `any` 类型
- 删除未使用的代码，不要注释掉

## 工作流
- 任何非平凡任务，先制定计划再动手
- 修改代码前必须先阅读相关文件
- 修改完成后自行运行测试验证

10.4 可复制的配置方案

完整配置结构：

项目根目录/
├── .opencode/
│   ├── config.json       # 项目级配置
│   ├── rules.md          # 全局规则
│   ├── AGENTS.md         # 项目文档
│   └── skills/           # 自定义 Skill
│       ├── code-review.yaml
│       └── frontend.yaml
└── CLAUDE.md             # Claude Code 配置

练习题目

工作流实践：完整实施 Claude Code 之父的工作流完成一个任务
AGENTS.md 练习：为你的项目创建一份完整的 AGENTS.md
13 条技巧实践：选择 5 条技巧在日常工作中实践一周
完整配置练习：搭建一套完整的配置方案（CLAUDE.md + Rules + Commands + Skills）

参考资料

第 11 章：团队工作流

学习目标

了解团队使用 OpenCode 的最佳实践
掌握项目级配置共享方法
学会使用 GitHub/GitLab 集成
了解企业版特性

学习内容

11.1 团队配置共享

版本控制配置：

# 将 .opencode/ 目录加入版本控制
git add .opencode/
git commit -m "Add OpenCode configuration"

配置分层策略：

全局配置：个人偏好（~/.opencode/config.json）
项目配置：团队规范（项目/.opencode/config.json）
本地覆盖：个人临时调整（不提交到版本控制）

11.2 GitHub 集成

配置 GitHub 集成：

{
  "github": {
    "enabled": true,
    "token": "ghp_xxxxxxxxxxxx"
  }
}

常用功能：

查看和创建 Issue
查看和合并 PR
查看仓库信息
触发 CI/CD 流程

11.3 GitLab 集成

配置 GitLab 集成：

{
  "gitlab": {
    "enabled": true,
    "url": "https://gitlab.com",
    "token": "glpat-xxxxxxxxxxxx"
  }
}

11.4 会话分享

导出对话：

/export

分享对话：

导出为 Markdown 格式
通过链接分享
团队内部分享最佳实践

11.5 企业版特性

企业版功能（了解）：

团队管理
集中配置管理
审计日志
SSO 集成
高级安全策略

练习题目

配置共享练习：创建一个项目级配置并提交到 Git
GitHub 集成练习：配置 GitHub 集成，尝试查看 Issues
会话分享练习：导出一个有价值的对话并分享给团队成员
团队协作练习：与团队成员共同使用 OpenCode 完成一个小功能

参考资料

附录

A. 快捷键速查表

快捷键	功能
`Tab`	切换 Plan/Build 模式
`Ctrl + x, a`	显示 Agent 列表
`Ctrl + x, m`	切换模型
`Ctrl + x, 方向键`	切换子会话
`Ctrl + n`	新建对话
`Ctrl + p`	上一个对话
`Ctrl + c`	取消当前操作
`Shift + Tab`	反向切换 Agent

B. 斜杠命令速查表

命令	功能
`/help`	显示帮助
`/init`	初始化项目
`/undo`	撤销上次更改
`/clear`	清空对话
`/new`	新建对话
`/ralph-loop`	启动 Ralph Loop
`/export`	导出对话

C. 核心学习资源索引

官方文档：

深度文章：

GitHub 资源：

学习路径总结

┌─────────────────────────────────────────────────────────────────┐
│                         学习路径总览                              │
├─────────────────────────────────────────────────────────────────┤
│                                                                  │
│  ┌─────────────┐    ┌─────────────┐    ┌─────────────┐          │
│  │  初级篇     │ →  │  进阶篇     │ →  │  高级篇     │          │
│  │  (基础)     │    │  (效率)     │    │  (专家)     │          │
│  └─────────────┘    └─────────────┘    └─────────────┘          │
│        │                  │                  │                  │
│   安装与起步          Oh My OpenCode      高级定制              │
│   基础操作            Ralph Loop          高级工作流            │
│   基础工作流          扩展任务            团队工作流            │
│                       定制配置                                  │
│                       进阶工作流                                │
│                                                                  │
│  预计学习时间：2-4 周                                             │
│                                                                  │
└─────────────────────────────────────────────────────────────────┘

引用信息

引用本文请注明以下信息。

@article{lj_opencode2026,
  author = {龙军},
  title = {opencode学习路径},
  year = {2026},
  url = {https://jdragonnudt.github.io/inspiraHub/myblog/posts/opencode-learning-path/},
}

OpenCode + Oh My OpenCode 完整学习路径

目录

序言：为什么是 OpenCode

什么是 OpenCode

使用 OpenCode 的好处

1. 显著提升开发效率

2. 降低认知负担

3. 提升代码质量

4. 支持团队协作

OpenCode 的核心优势

1. 多模型支持（Model Agnostic）

2. Plan/Build 双模式工作流

3. 强大的 Agent 系统

4. Oh My OpenCode 增强生态

5. 开源与可扩展

6. 优秀的国内支持

OpenCode vs Claude Code：如何选择

功能对比

适用场景建议

实际上…

谁适合使用 OpenCode

开发者

技术管理者

其他技术人员

学习路径概述

开始之前

第一部分：初级篇

第 1 章：安装与起步

学习目标

学习内容

1.1 OpenCode 简介

1.2 安装步骤

1.3 网络配置（国内用户必读）

1.4 连接模型

1.5 第一次对话

练习题目

参考资料

第 2 章：基础操作

学习目标

学习内容

2.1 TUI 界面导览

2.2 核心语法三件套

2.3 对话管理

2.4 常用快捷键

练习题目

参考资料

第 3 章：基础工作流

学习目标

学习内容

3.1 Plan vs Build 模式详解

3.2 标准开发工作流

3.3 项目初始化（/init）

3.4 文件操作技巧

练习题目

参考资料

第二部分：进阶篇

第 4 章：Oh My OpenCode 增强插件

学习目标

学习内容

4.1 Oh My OpenCode 简介

4.2 安装步骤

4.3 核心 Agent 介绍

4.4 Categories + Skills 架构（v3.0+）

4.5 Ultrawork 模式

练习题目

参考资料

第 5 章：Ralph Loop 自动闭环

学习目标

学习内容

5.1 Ralph Loop 概念

5.2 工作流程

5.3 使用方法

5.4 Prompt 黄金结构

5.5 适用场景

练习题目

参考资料

第 6 章：扩展到其他任务

学习目标

学习内容

6.1 文档写作工作流

3.3 项目初始化（`/init`）