opencode的Skills

1. Skills定义

Agent Skills 是一套可复用的指令模块，通过 SKILL.md 文件定义，让 Agent 在需要时按需加载特定的行为规范和工作流程。 Agent 会先看到可用技能列表，再调用 skill 工具加载完整内容。

2. Skill文件的存储位置

• 全局Skills的路径：

1. Windws:C:\Users\你的用户名\.confing\opencode\skills.md
2. mac OS:~/.confing/opencode/skills.md

全局skill里面的内容一次性全部加载

• project和subfolder的路径：

1. project/.opencode/skills就是我们的项目级skills
2. project/.opencode/名称/skills就是子文件夹级的Skills

3. Skills写法规范

文件必须包含 YAML 前言(元信息),后面是 Markdown 内容(指令层)。

一篇官方skills:指导Agent和Model如何生成高质量docx文档。

必填字段

• name

1. 必须是1到64个字符
2. 可能仅包含 Unicode 小写字母数字字符（）和连字符（a-z-)
3. 不得以连字符开头或结尾 （-)
4. 不得包含连续的连字符（--)
5. 必须与父目录名称匹配。

• description

1. 字符必须是1到1024个字符
2. 应该能描述技能的作用以及何时使用
3. 应包含具体关键词，帮助客服识别相关任务

注意：元信息书写格式:

• ---

• name:
• description:

• ---

4. 按需加载

Skill的分层

执行步骤

1. 当我们交给Agent指令。
2. Agent读取当前目录下的所有*.md文件的元信息(skill_name_docx/skill.md和skill_name_PPT/skill.md)。
3. 将元信息交给Model,Model根据我们的要求选择合适的skills,并告诉Agent。
4. Agent就会加载相应skills的指令层数据交给Model。
5. Agent根据后面的需要再加载assets(图片,音频等资源)reference(包含更细节的Markdown) scropts(方法,脚本)。