Перейти к содержимому
OmniRoute Docs

Выберите язык

Текущий язык: Русский

OmniRoute source

OmniRoute Agent Skills Catalog (Русский)

Обзор

Заголовок раздела «Обзор»

Каталог содержит 45 Agent Skills (23 для REST API + 21 для CLI + 1 рабочий процесс конфигурации). Каждый навык имеет:

  • Канонический ID (omni-auth, cli-serve и т. д.)
  • Файл SKILL.md в skills/{id}/SKILL.md с YAML frontmatter (name, description) и содержательным Markdown-текстом
  • Конечные точки REST (навыки API) или подкоманды CLI (навыки CLI), полученные из спецификации OpenAPI и реестра CLI
  • Необработанный URL GitHub для загрузки актуальной версии: https://raw.githubusercontent.com/diegosouzapw/OmniRoute/refs/heads/main/skills/{id}/SKILL.md

Архитектура

Заголовок раздела «Архитектура»
src/shared/constants/agentSkills.ts    — курируемый список из 45 записей (имя/описание/категория/область/значок)
src/lib/agentSkills/
  catalog.ts                           — getCatalog(), getSkillById(), filterCatalog(), computeCoverage()
  generator.ts                         — generateAgentSkills() записывает SKILL.md в skills/{id}/
  openapiParser.ts                     — извлекает конечные точки REST из docs/openapi.yaml
  cliRegistryParser.ts                 — извлекает подкоманды CLI из bin/cli-registry.ts
  schemas.ts                           — схемы Zod: AgentSkillSchema, SkillCoverageSchema и т. д.
  types.ts                             — интерфейсы TypeScript: AgentSkill, SkillCoverage и т. д.


skills/{id}/SKILL.md                   — сгенерированные и курируемые Markdown-файлы (всего 45)


src/app/api/agent-skills/
  route.ts                             — GET /api/agent-skills
  [id]/route.ts                        — GET /api/agent-skills/{id}
  [id]/raw/route.ts                    — GET /api/agent-skills/{id}/raw (text/markdown)
  coverage/route.ts                    — GET /api/agent-skills/coverage
  generate/route.ts                    — POST /api/agent-skills/generate (требуется аутентификация)


open-sse/mcp-server/tools/agentSkillTools.ts  — 3 инструмента MCP (список, получение, покрытие)
src/lib/a2a/skills/listCapabilities.ts        — навык A2A: list-capabilities

Формат SKILL.md

Заголовок раздела «Формат SKILL.md»
---
name: omni-providers
description: "Управление подключениями поставщиков: добавление, тестирование, ротация и удаление учётных данных."
---


<!-- сгенерировано src/lib/agentSkills/generator.ts; изменения, внесённые вручную, будут перезаписаны -->


## Обзор


...


## Аутентификация


...


## Конечные точки


...


<!-- skill:custom-start -->


## Пользовательский раздел (сохраняется при повторной генерации)


...


<!-- skill:custom-end -->

При повторной генерации генератор сохраняет содержимое между <!-- skill:custom-start --> и <!-- skill:custom-end -->. Десять навыков содержат курируемые пользовательские блоки:

omni-mcp, omni-compression, cli-providers, cli-eval, omni-agents-a2a, omni-combos-routing, omni-auth, omni-resilience, omni-inference, cli-serve.

Обнаружение REST API

Заголовок раздела «Обнаружение REST API»
Конечная точка Метод Описание Авторизация
/api/agent-skills GET Список каталога (необязательные параметры ?category=api|cli|config&area=&lt;area&gt;) не требуется
/api/agent-skills/{id} GET Получение метаданных отдельного навыка не требуется
/api/agent-skills/{id}/raw GET Получение SKILL.md в формате text/markdown не требуется
/api/agent-skills/coverage GET Статистика покрытия (количество существующих файлов SKILL.md) не требуется
/api/agent-skills/generate POST Запуск генератора (dryRun/prune/onlyIds) управление

Пример — вывести список всех навыков API:

Окно терминала
curl "http://localhost:20128/api/agent-skills?category=api"

Пример — получить отдельный файл SKILL.md:

Окно терминала
curl -H "Accept: text/markdown" "http://localhost:20128/api/agent-skills/omni-providers/raw"

Обнаружение MCP

Заголовок раздела «Обнаружение MCP»

В области действия read:catalog зарегистрированы три инструмента MCP:

Инструмент Описание
omniroute_agent_skills_list Список навыков (необязательные фильтры category / area)
omniroute_agent_skills_get Получение метаданных и SKILL.md одного навыка по id
omniroute_agent_skills_coverage Статистика покрытия (имеется/всего для API/CLI)

Настройку областей действия и аутентификацию см. в MCP-SERVER.md.

Обнаружение A2A

Заголовок раздела «Обнаружение A2A»

Навык A2A list-capabilities возвращает полный каталог из 45 навыков в виде артефакта с таблицей Markdown. Внешние оркестраторы могут вызвать его следующим образом:

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "skill": "list-capabilities",
    "messages": [{ "role": "user", "content": "Перечисли все возможности" }]
  }
}

Подробности протокола см. в A2A-SERVER.md.

Каталог — 45 идентификаторов навыков

Заголовок раздела «Каталог — 45 идентификаторов навыков»

Навыки API (23)

Заголовок раздела «Навыки API (23)»
ID Область Точка входа
omni-auth auth Управление аутентификацией и сеансами
omni-providers providers Управление подключениями провайдеров
omni-models models Каталог моделей и их возможностей
omni-combos-routing combos-routing Стратегии комбинированной маршрутизации
omni-api-keys api-keys Управление ключами API
omni-usage-logs usage-logs Журналы использования и затрат
omni-budget budget Ограничители бюджета
omni-settings settings Глобальные настройки
omni-proxies proxies Управление пулом прокси-серверов
omni-cache cache Семантический кэш и кэш промптов
omni-compression compression Механизмы сжатия контекста
omni-context-rtk context-rtk Сжатие RTK
omni-resilience resilience Автоматические выключатели и периоды ожидания
omni-cli-tools cli-tools REST-прокси для инструментов CLI
omni-tunnels tunnels Управление туннелями
omni-sync-cloud sync-cloud Облачная синхронизация
omni-db-backups db-backups Резервное копирование базы данных
omni-webhooks webhooks Диспетчер событий вебхуков
omni-mcp mcp Сервер MCP (110 инструментов, 3 транспорта)
omni-agents-a2a agents-a2a Протокол агентов A2A
omni-version-manager version-manager Управление версиями и обновлениями
omni-inference inference Прямой инференс / автодополнения

Навыки CLI (21)

Заголовок раздела «Навыки CLI (21)»
ID Область Корневая команда CLI
cli-serve cli-serve omniroute serve
cli-health cli-health omniroute health
cli-providers cli-providers omniroute providers
cli-keys cli-keys omniroute keys
cli-models cli-models omniroute models
cli-chat cli-chat omniroute chat
cli-routing cli-routing omniroute routing
cli-resilience cli-resilience omniroute resilience
cli-compression cli-compression omniroute compression
cli-contexts cli-contexts omniroute contexts
cli-cost-usage cli-cost-usage omniroute cost
cli-mcp cli-mcp omniroute mcp
cli-a2a cli-a2a omniroute a2a
cli-tunnel cli-tunnel omniroute tunnel
cli-backup-sync cli-backup-sync omniroute backup
cli-policy-audit cli-policy-audit omniroute policy
cli-batches cli-batches omniroute batch
cli-eval cli-eval omniroute eval
cli-plugins-skills cli-plugins-skills omniroute plugins
cli-setup cli-setup omniroute setup
cli-skill-collector cli-setup omniroute skills

Процесс настройки конфигурации (1)

Заголовок раздела «Процесс настройки конфигурации (1)»
ID Область Точка входа
config-codex-cli config-codex-cli Процесс настройки Codex CLI

Как внешние агенты используют навыки

Заголовок раздела «Как внешние агенты используют навыки»

1. Обнаружение через REST

Заголовок раздела «1. Обнаружение через REST»
Окно терминала
# Получить полный каталог
curl "http://your-omniroute/api/agent-skills" | jq '.skills[] | {id, name, category}'


# Получить SKILL.md для внедрения контекста
curl "http://your-omniroute/api/agent-skills/omni-providers/raw" > omni-providers.md

2. Обнаружение через MCP

Заголовок раздела «2. Обнаружение через MCP»
// В клиенте MCP для Claude Desktop / Cursor:
const result = await client.callTool("omniroute_agent_skills_list", {
  category: "api",
});
// result.skills → массив AgentSkill, каждый из которых содержит rawUrl

3. Обнаружение через A2A

Заголовок раздела «3. Обнаружение через A2A»
import requests


resp = requests.post("http://your-omniroute/a2a", json={
    "jsonrpc": "2.0", "id": "1",
    "method": "message/send",
    "params": {"skill": "list-capabilities", "messages": [{"role": "user", "content": "list"}]}
})
table = resp.json()["result"]["artifacts"][0]["content"]
# table — это Markdown-таблица со всеми 45 идентификаторами навыков и столбцами rawUrl

4. Прямое получение необработанного файла с GitHub (сервер не требуется)

Заголовок раздела «4. Прямое получение необработанного файла с GitHub (сервер не требуется)»
Окно терминала
BASE="https://raw.githubusercontent.com/diegosouzapw/OmniRoute/refs/heads/main/skills"
curl "${BASE}/omni-providers/SKILL.md"

Генератор

Заголовок раздела «Генератор»

Генератор считывает подготовленный каталог, спецификацию OpenAPI и реестр CLI, а затем записывает skills/{id}/SKILL.md для каждой записи:

Окно терминала
# Предварительный просмотр (пробный запуск без записи)
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":true}'


# Полная повторная генерация
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"prune":false}'


# Повторно сгенерировать указанные идентификаторы
curl -X POST http://localhost:20128/api/agent-skills/generate \
  -H "Authorization: Bearer &lt;admin-key&gt;" \
  -H "Content-Type: application/json" \
  -d '{"dryRun":false,"onlyIds":["omni-providers","cli-serve"]}'

Ответ генератора представляет собой GeneratorReport:

{
  "generated": ["omni-providers", "cli-serve"],
  "unchanged": [],
  "pruned": [],
  "orphansDetected": [],
  "errors": []
}

API покрытия

Заголовок раздела «API покрытия»
Окно терминала
curl "http://localhost:20128/api/agent-skills/coverage"
{
  "api": { "have": 23, "total": 23 },
  "cli": { "have": 21, "total": 21 },
  "config": { "have": 1, "total": 1 },
  "totalSkills": 45,
  "generatedAt": "2026-08-02T00:00:00.000Z"
}

Связанные материалы

Заголовок раздела «Связанные материалы»
  • SKILLS.md — фреймворк Omni Skills (внедрение инструментов LLM + маркетплейс)
  • MCP-SERVER.md — каталог инструментов MCP (инструменты omniroute_agent_skills_*)
  • A2A-SERVER.md — протокол A2A (навык list-capabilities)
  • src/lib/agentSkills/ — каталог, генератор, парсеры
  • skills/ — сгенерированные файлы SKILL.md (45 записей)

Исходный код OmniRoute (a58000c7685f)

HagiCode

HagiCode — агентная среда разработки со структурированными процессами, параллельным выполнением несколькими агентами и интерфейсами Hero Dungeon.

Превращайте идеи в полезное ПО с более умным, быстрым и увлекательным агентным рабочим процессом.

Главный экран HagiCode в светлой теме
  • SmartСтруктурированные процессы превращают намерение в исполнимый путь от идеи до готового изменения.
  • EfficientМультиагентные процессы параллельно продвигают исследование, реализацию и проверку.
  • FunHero Dungeon делает длительную совместную разработку наглядной и увлекательной.
Перейти на HagiCode