智能体运行层

给所有智能体栈共用的一层技能系统。

无论运行时是 HTTP、MCP 还是本地命令，SkillHub 都给智能体一条从发现、校验到执行的稳定路径。

查找技能进入开发者控制台

适合规划器发现

把技能搜索暴露成智能体工具，让规划器先找到可复用能力，而不是每次重写步骤。

运行时路由

网关可以把 HTTP 服务、MCP 服务器和本地命令收敛到同一份注册协议。

权限上下文

智能体在决定调用技能前，可以先看到该技能的风险画像。

接入路径

通过同一个项目治理层连接智能体。

项目级 Key 让智能体列出已安装工具、调用已批准技能，并把每次调用都绑定到策略、预算、订阅、调用日志和可计量用量。

MCP 客户端

把项目已批准的 SkillHub 技能暴露成 MCP tools，给智能体工作台和助手使用。

POST /mcp

REST 运行时

从服务端工作流、定时任务和自定义智能体循环直接调用固定版本的技能。

POST /v1/runtime/invoke

SDK 和 CLI

把发现、安装和调用自动化放进同一套可版本化的工程流程。

@useskillhub/sdk

智能体调用流程

01按任务搜索

02读取 manifest

03检查权限

04调用运行时

05返回类型化输出

可复制的运行时形态

智能体的三种接入形态

MCP 客户端、直接 REST 调用、SDK 或 CLI 工作流，最终都回到同一个受治理的 SkillHub 注册表。

mcp.jsonMCP 客户端

{
  "mcpServers": {
    "skillhub": {
      "url": "https://api.useskillhub.com/mcp",
      "headers": {
        "Authorization": "Bearer ${SKILLHUB_PROJECT_API_KEY}"
      }
    }
  }
}

runtime.shREST 调用

curl -X POST "https://api.useskillhub.com/v1/runtime/invoke" \
  -H "Authorization: Bearer $SKILLHUB_PROJECT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"skillSlug":"browser-research","input":{"query":"market map with citations"}}'

agent.tsSDK 发现

import { SkillHub } from "@useskillhub/sdk";

const skillhub = new SkillHub({
  baseUrl: "https://api.useskillhub.com"
});

const skills = await skillhub.search({
  query: "research with citations",
  permissionLevel: "medium"
});

运行时治理

运行时仍然生效的治理

SkillHub 是智能体意图和技能执行之间的控制平面。智能体可以快速接入，但不会绕过所有权、审核和成本控制。

项目 API Key 有范围并可撤销。

已安装技能保留版本固定和审批状态。

高风险权限更新会回到负责人审核。

预算、限流、订阅、日志和用量事件都会绑定到每次调用。