OmniRoute Agent Skills Catalog (中文 (简体))

概述

该目录包含 45 个 Agent Skills（23 个 REST API 技能 + 21 个 CLI 技能 + 1 个配置工作流）。每个技能都包含：

一个规范 ID（omni-auth、cli-serve 等）
位于 skills/{id}/SKILL.md 的 SKILL.md 文件，其中包含 YAML 前置元数据（name、description）和内容丰富的 Markdown 正文
从 OpenAPI 规范和 CLI 注册表派生的 REST 端点（API 技能）或 CLI 子命令（CLI 技能）
用于实时获取的 GitHub 原始文件 URL：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                     — 从 docs/openapi.yaml 提取 REST 端点
  cliRegistryParser.ts                 — 从 bin/cli-registry.ts 提取 CLI 子命令
  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 格式

---
name: omni-providers
description: "管理提供者连接：添加、测试、轮换和移除凭据。"
---

<!-- 由 src/lib/agentSkills/generator.ts 生成；手动编辑将被覆盖 -->

## 概述

...

## 身份验证

...

## 端点

...

<!-- 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 发现

端点	方法	描述	认证
`/api/agent-skills`	GET	列出目录（可选 `?category=api\|cli\|config&area=<area>`）	无
`/api/agent-skills/{id}`	GET	获取单个技能的元数据	无
`/api/agent-skills/{id}/raw`	GET	以 `text/markdown` 格式获取 SKILL.md	无
`/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 发现

在 read:catalog 作用域下注册了三个 MCP 工具：

工具	描述
`omniroute_agent_skills_list`	列出技能（可选 `category` / `area` 筛选条件）
`omniroute_agent_skills_get`	按 `id` 获取某项技能的元数据和 SKILL.md
`omniroute_agent_skills_coverage`	覆盖率统计（API/CLI 已有数量/总数）

有关作用域连接和认证，请参阅 MCP-SERVER.md。

A2A 发现

A2A 技能 list-capabilities 以 markdown 表格构件的形式返回完整的 45 项技能目录。外部编排器可以通过以下方式调用它：

{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "message/send",
  "params": {
    "skill": "list-capabilities",
    "messages": [{ "role": "user", "content": "List all capabilities" }]
  }
}

有关协议详情，请参阅 A2A-SERVER.md。

目录 — 45 个技能 ID

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	CLI 工具 REST 代理
`omni-tunnels`	tunnels	隧道管理
`omni-sync-cloud`	sync-cloud	云同步
`omni-db-backups`	db-backups	数据库备份
`omni-webhooks`	webhooks	Webhook 事件分派器
`omni-mcp`	mcp	MCP 服务器（110 个工具，3 种传输）
`omni-agents-a2a`	agents-a2a	A2A 代理协议
`omni-version-manager`	version-manager	版本和更新管理
`omni-inference`	inference	直接推理/补全

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）

ID	区域	入口点
`config-codex-cli`	config-codex-cli	Codex CLI 配置工作流

外部智能体如何使用技能

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 发现

// 在 Claude Desktop / Cursor MCP 客户端中：
const result = await client.callTool("omniroute_agent_skills_list", {
  category: "api",
});
// result.skills → AgentSkill 数组，每项都包含 rawUrl

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 个技能 ID 及其 rawUrl 列

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}'

# 重新生成指定 ID
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

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"
}

HagiCode

HagiCode 是一套智能体编码工作台：结构化工作流、多 Agent 并行执行与 Hero Dungeon 视图，把想法变成真正交付的软件。

让想法更快变成好用的软件，让智能编码更聪明、更高效，也更有趣。

Smart结构化工作流将意图转化为从想法到交付的可执行路径。
Efficient多 Agent 工作流让调研、实现与审阅并行推进。
FunHero Dungeon 让长时间编码协作更直观、更有参与感。

访问 HagiCode

选择语言