平时做技术实践时，很多问题不是概念不会，而是细节没串起来。拿“OpenCode AI编程助手如何添加Skills的实现方式”来说，它看着像小点，放到项目里常会牵出环境、配置、兼容性和维护成本。下面按实际使用顺序，把思路、关键写法和容易踩坑的地方讲清楚，方便你直接对照操作。

01 引言

从实现思路看，AI时代Agent的出现，为AI规定了特定的角色，根据推理、理解完成对话内容。MCP则是为AI或者Agent提供了外部资源的一切可能。比如，你让Agent为你播报近7天的天气，它无法完成，但是MCP可以，Agent结合MCP为我们带来无限的可能。原本以为到这里已经结束了，但是随着Skills的横空出世，更是推动了AI Agent更快落地。

从实现思路看，Skills的功能和MCP很类似但是却又不同，这一节我们将借助OpenCode了解最近爆火的Skills。

02 Skills

2.1 简介

Skills是智能体的技能，是一种轻量级、开放的格式，用来借助专业知识和工作流程扩展人工智能智能体的能力。而其本质上就是教 AI 按固定流程做事的操作说明书，一旦写好，就能像函数一样反复调用。

我们可以把 Skills 看成把什么样的事情应该怎么去做。将Skills封装成一个可复用、可自动触发的能力模块，根据实际的场景选择不同的Skills更加专业的完成用户下发的命令。可以轻松的理解为Skills就是一个个独立且可复用的工具包

Skills 以 Markdown 文件形式存在，不执行功能，而是借助按需、渐进式加载，实现高效且可复用的经验传递。

my-skill/
├── SKILL.md      # 必需：指令 + 元数据
├── scripts/      # 可选：可执行代码
├── references/   # 可选：文档资料
└── assets/       # 可选：模板、资源

地址：（链接已移除）

2.2 Skills核心结构

实际处理时，Skills 的核心就是：一堆文件夹 + 一个 SKILL.md 文件。

其中SKILL.md最为重要，借助定义角色，场景等，让Agent直到什么时候调用什么东西。Skill.md基本模版：

---
name: 你的Skill名称
description: Skill的相关描述以及什么时候使用
---
## 说明
具体描述如何使用
## 案例
- Example usage 1
- Example usage 2

在这个场景下，其他文件夹可以规范AI的操作或者调用的脚本。scripts放置一些可执行的脚本以及自动化的逻辑，references存放一些说明文档或者参考资料，assets主要用来存放模板文件以及静态资源。

有了这些文件夹资料以及md的说明，让Skills更加具体。

2.3 Skills的设置

实际处理时，Skills的设置可以分为局部设置和全局设置。我们以OpenCode为例：

还有一种全局设置：~/.opencode/skills/<name>/SKILL.md

官网地址：（链接已移除）

03 自定义Skills

结合项目来看，Skills的编写很轻松，轻松说就是提示词。但是如何写好，这个就另说了。我们轻松定义一个打印的Skills，我们按照模板编写。

---
name: print-test
description: skill 打印测试
---

## 角色定义

你是一个打印测试工具包

## 输出

当用户测试打印的时候，统一打印出：这是一个skill的打印测试

3.1 局部设置

设置位置：.opencode/skills/print-test/SKILL.md

验证方式能够借助斜杠或者直接问AI都可以。

斜杠

输入斜杠，就会提示当前的技能。

直接问

全局设置不在演示。

3.2 测试

实际处理时，我们需测试自己定义的Skills是否有效。我们输入打印测试，看看回复是否是调用自定义Skills.

我们可以看到调用自定义的Skills.

04 优化项目

我们之前写了一个下载的页面，页面比较轻松：

结合项目来看，我们借助专业的Skills优化一下页面。采用ui-ux-pro-max优化。

Skills地址：（链接已移除）

从实现思路看，下载下来，将对应的包放在Skills即可，注意包的结构，本次采用全局设置。

4.1 全局设置

设置位置：~/.config/opencode/skills/<name>/SKILL.md

这里要注意src的包也要放进来，因为skills下的data和scripts路径需。

src位置：

4.2 检查

采用/检查

4.3 优化

这里直接让AI优化，看下会变成什么。

我们发现已经调用ui-ux-pro-max了。

最后总结了优化的效果：

我们直接看看结果：

结合项目来看，总的来说，OpenCode添加Skills这部分内容适合结合实际项目边做边理解。先抓住核心思路，再逐步补上细节和边界处理，最后效果会更稳定，也更容易复用。