从零到一：OpenCode + oh-my-opencode 插件化 AI 开发环境搭建指南

这份指南旨在帮助你跳过基础的安装博弈，直接进入 OpenCode 的深度配置阶段。我们将重点攻克插件系统 oh-my-opencode 以及基于 skills.sh 的技能工程，让你的 AI 助手从“只会聊天”进化为“具备标准作业程序（SOP）的数字员工”。

一、 快速起步：OpenCode 核心安装

假设你已安装 Node.js 22+，一行命令带过基础环境：

npm i -g opencode-ai@latest

验证安装：输入 opencode，看到交互界面即可退出。

二、 进阶配置：挂载 oh-my-opencode 增强插件

oh-my-opencode 是目前 OpenCode 生态中装机量最高、功能最全的插件。它内置了多角色协同、LSP（语言服务协议）以及针对代码分析的 AST 工具。

1. 配置文件定位

OpenCode 的配置采用 JSON 格式，路径如下：
* Windows: C:\Users\<你的用户名>\.config\opencode\opencode.json
* macOS/Linux: ~/.config/opencode/opencode.json

2. 注入插件

使用编辑器打开 opencode.json，在 plugin 数组中添加插件名称。完整的配置结构参考：

{
  "plugin": ["oh-my-opencode@latest"],
  "$schema": "https://opencode.ai/config.json"
}

3. 激活与初始化

重新在终端输入 opencode。

注意：由于指向的是 @latest，首次启动会检查并下载最新版本。当你看到终端输出 Sisyphus（西西弗斯）相关字样时，代表增强插件已成功加载。

三、 核心工程：通过 skills.sh 配置专家技能

如果说插件（Plugin）是增强 AI 的“大脑”，那么技能（Skill）就是 AI 的“工具箱”。通过 skills.sh，你可以赋予 AI 具体的任务处理逻辑（如：如何优雅地操作 Python 虚拟环境）。

1. 为什么推荐 skills.sh？

• 标准化：统一不同智能体（OpenCode, Copilot 等）的技能目录。
• 解耦：将复杂的 Prompt 逻辑（SOP）沉淀为独立脚本。

2. 核心技能安装指南

我们推荐安装以下两个专家级技能组，以应对复杂的工程需求。

A. 专家技能库：Superpower

这是目前最全的技能包，涵盖了头脑风暴、TDD（测试驱动开发）和执行计划。
* 安装指令：
bash # 递归安装该仓库下的所有技能并进行全局挂载 npx skills add code-yeongyu/superpowers --skill '*' -g

B. 流程管理：Planning-with-files

该技能模拟了现实中的标准开发流程：需求分析 $\rightarrow$ 架构设计 $\rightarrow$ 计划排期 $\rightarrow$ 执行。
* 安装指令：
bash npx skills add <owner/repo-path> --skill 'planning-with-files'

3. 安装时的目录选择 (关键)

在执行 npx skills add 的交互过程中，为了保证跨平台、跨工具（如 Copilot 插件）兼容，建议将技能安装目录统一指向：
* ~/.agents/skills

四、 实战建议：如何高效驱动 Skills？

1. 少即是多：不要一股脑安装成百上千个 Skill。过多的技能会消耗大量 Token，且容易导致模型在检索时产生幻觉。
2. 文档驱动：结合 planning-with-files，在开发前先要求 AI 生成一个 PLAN.md。OpenCode 会根据该文档逐步执行，而不是盲目写代码。
3. 模式切换：
   • 使用 Plan 模式 配合 superpower 进行方案论证。
   • 确认无误后切换到 Build 模式 进行物理文件改写。

通过 oh-my-opencode 插件和定制化的 Skills，你已经完成了从“使用 AI”到“编排 AI”的转变。