> For the complete documentation index, see [llms.txt](https://docs.verge.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verge.io/overview/zh/shi-yong-ai-gong-ju/agent-skills.md).

# VergeOS 代理技能

[通过 MCP 连接文档](/overview/zh/shi-yong-ai-gong-ju/connect-via-mcp.md) 让 AI 助手 *搜索并阅读* VergeOS 文档。该 **VergeOS 代理技能** 更进一步：它们将同样的文档访问能力与助手可运行的现成、面向任务的工作流打包在一起——用于解决问题、解释概念、分析诊断包、管理基础设施，并带你完成培训。

一切都位于一个开源仓库中，可部署为 **Claude Code 插件** 或作为 **OpenAI Codex CLI** 制品：

{% hint style="info" %}
**仓库：** [github.com/verge-io/agent-skills-vergeos](https://github.com/verge-io/agent-skills-vergeos)
{% endhint %}

## MCP 与代理技能

|        | [通过 MCP 连接](/overview/zh/shi-yong-ai-gong-ju/connect-via-mcp.md) | VergeOS 代理技能                   |
| ------ | ---------------------------------------------------------------- | ------------------------------ |
| 它增加了什么 | 两个工具：搜索和获取文档页面                                                   | 在文档之上的引导式多步骤工作流                |
| 最适合    | 任何只需要文档的、支持 MCP 的助手                                              | 想要动手帮助的 Claude Code 和 Codex 用户 |
| 设置     | 添加一个远程服务器                                                        | 安装插件（文档 MCP 已随附）               |

你不必先做选择。技能包 **包含文档 MCP 服务器**，因此安装技能会自动连接文档访问。

## 包含内容

| 技能  | 命令                  | 它的作用                                 |
| --- | ------------------- | ------------------------------------ |
| 解决  | `/vergeos:resolve`  | 将常见问题模式匹配到已知解决方案                     |
| 解释  | `/vergeos:explain`  | 使用实时文档解释 VergeOS 概念                  |
| 诊断  | `/vergeos:diag`     | 使用并行子代理和 PII 清理分析诊断包（仅限 Claude Code） |
| CLI | `/vergeos:vrg`      | 通过 `vrg` CLI                         |
| 培训  | `/vergeos:teach-me` | 提供结构化、动手式培训模块                        |
| 测验  | `/vergeos:quiz-me`  | 运行交互式知识检查测验                          |

{% hint style="info" %}
这些技能中的指导和故障排除面向 **VergeOS 26.0 及更高版本**.
{% endhint %}

## 安装

{% tabs %}
{% tab title="Claude Code" %}
添加市场并安装插件：

```bash
claude plugin marketplace add verge-io/agent-skills-vergeos
claude plugin install vergeos@verge-io
```

或者在 Claude Code 内部以交互方式执行相同操作：

```
/plugin marketplace add verge-io/agent-skills-vergeos
/plugin install vergeos@verge-io
```

捆绑的文档 MCP 服务器会自动接好——无需 API 令牌。使用带命名空间的命令调用某个技能，例如 `/vergeos:resolve` 或 `/vergeos:diag /path/to/bundle`.
{% endtab %}

{% tab title="Codex CLI" %}
克隆仓库，然后将这些技能建立符号链接并添加文档 MCP 服务器：

```bash
ln -s "$(pwd)/.codex/skills"/* ~/.codex/skills/
codex mcp add vergeos-docs --url https://docs.verge.io/~gitbook/mcp
```

可按名称或自然语言调用技能。（ `diag` 技能仅限 Claude Code。）
{% endtab %}
{% endtabs %}

## 该 `vrg` 技能和 VergeOS CLI

该 **`vrg`** 技能（`/vergeos:vrg`）驱动官方 [VergeOS CLI（`vrg`)](/automate-protect-and-extend/integrations-and-apis/vrg-cli.md) ——在计算、网络、租户、NAS、身份和自动化方面拥有 200 多个命令。你的助手会用它代表你检查和管理真实基础设施，因此最好先安装并完成 CLI 认证。

参见 [VergeOS CLI（vrg）](/automate-protect-and-extend/integrations-and-apis/vrg-cli.md) 以了解安装、认证以及完整的命令参考。

## 下一步

* 只想在任何助手中进行文档搜索？从 [通过 MCP 连接](/overview/zh/shi-yong-ai-gong-ju/connect-via-mcp.md).
* 想要完整工具包？安装上面的 [代理技能](https://github.com/verge-io/agent-skills-vergeos) 开始。
* 想要实际操作基础设施？设置 [VergeOS CLI（vrg）](/automate-protect-and-extend/integrations-and-apis/vrg-cli.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verge.io/overview/zh/shi-yong-ai-gong-ju/agent-skills.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.