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 frontmatter（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": "列出所有功能" }]
  }
}

如需通訊協定詳細資訊，請參閱 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	Proxy 集區管理
`omni-cache`	cache	語意與提示詞快取
`omni-compression`	compression	上下文壓縮引擎
`omni-context-rtk`	context-rtk	RTK 壓縮
`omni-resilience`	resilience	斷路器與冷卻機制
`omni-cli-tools`	cli-tools	CLI 工具 REST Proxy
`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 是包含全部 45 個技能 ID 與 rawUrl 欄位的 markdown 表格

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 是智慧代理程式開發工作台，結合結構化工作流程、多代理程式執行與 Hero Dungeon 介面，將想法化為交付成果。

以更聰明、更快速且更有趣的智慧代理程式工作流程，打造實用的軟體。

Smart結構化流程將意圖轉化為從構想到交付的可執行步驟。
Efficient多代理程式工作流程讓研究、實作與審查並行進行。
FunHero Dungeon 讓長時間的程式協作更直覺、更有參與感。

造訪 HagiCode

選擇語言