前言
Agent Skills 最近非常火，它是继 MCP 之后 Anthropic 推出的又一个 Agent 领域的行业标准。它的成长路线和 MCP 也非常像，发布初期只有 Anthropic 自家产品支持，后来 Cursor、Codex、OpenCode、Gemini CLI 等产品看到了 Skills 的优势，于是纷纷开始支持。再后来社区涌现了大量的开源 Skills 以及 Skills 开放市场，当下大家已经默认 Skills 成为了扩展 Agent 能力的标准实践。
简单来说，Skills 的作用就是将那些重复性的、专业的流程进行打包封装。当你需要使用某种能力时，不再需要像过去那样每次都去查阅手册或重新输入冗长的提示词，而是像调用工具一样直接使用。
OpenCode 介绍与环境搭建
OpenCode 是什么
OpenCode 是一个面向开发者的高效智能体工具，旨在通过标准化的 Skills 接口连接大模型与本地开发环境。它允许开发者在本地构建、测试并部署 AI 辅助编程工作流，特别适合需要深度集成代码库的场景。
主要特点
- 标准化接口：遵循 Skills 规范，兼容主流 Agent 生态。
- 本地优先：数据不出域，保障代码安全。
- 插件化架构：支持自定义 Skills 扩展功能。
使用场景
适合需要自动化代码审查、文档生成、单元测试编写等重复性高且逻辑固定的开发任务。
本地环境搭建
安装 Node.js
OpenCode 基于 Node.js 运行，首先需要确保你的环境已安装 Node.js。建议安装 LTS 版本以保证稳定性。
node -v
npm -v
如果未安装，请前往官网下载对应系统的安装包，或使用 nvm 管理多版本。
使用 npm 安装 OpenCode
环境就绪后，可以通过 npm 全局安装 OpenCode 命令行工具。
npm install -g opencode
安装过程中若遇到权限问题，Windows 用户可尝试以管理员身份运行终端，Mac/Linux 用户则需配置 npm 目录权限。
效果测试
安装完成后，运行以下命令验证是否成功：
opencode --version
若输出版本号信息，说明基础环境无误。接下来可以尝试初始化一个项目。
基本使用技巧
- 上下文感知：在项目中运行时，OpenCode 会自动读取
.gitignore和package.json来理解项目结构。 - 快捷键支持：部分 IDE 插件支持通过快捷键唤起 OpenCode 对话窗口。
- 日志调试：遇到异常时，可通过
--debug参数查看详细执行日志。
OpenCode 配置大模型
配置过程
前置准备
在配置之前，你需要准备好大模型的 API Key。目前 OpenCode 支持多种主流模型提供商，包括 OpenAI、Anthropic 及国内合规的模型服务。
进入模型配置窗口
打开终端，输入以下命令启动配置向导：
opencode config model
按照提示输入模型名称、API Key 及 Base URL。配置文件通常保存在用户目录下的 .opencode/config.json 中，你也可以手动编辑该文件进行调整。
注意：敏感信息如 API Key 请勿提交至代码仓库，建议配合环境变量使用。
