Universal skill / Every curated API

让 Agent 用统一工作流发现、验证、调用并集成 API。

统一 Skill 负责跨 API 搜索、契约检查、请求预演和安全调用，并帮助 Agent 找到需要的产品 Skill。产品 Skill 再补充特定 API 的集成流程、最佳实践和注意事项；两者都通过统一 CLI 使用同一份实时目录。

安装一次

Hub Skill 始终要求先预演；写操作必须由用户明确确认。

安装

pnpm add -g @pontx/hub-cli
pontx-hub skill install

通过 Agent Skills 安装

npx skills add https://github.com/pontjs/pontx-hub --skill pontx-hub

安全调用流程

pontx-hub search "把欧元换算成美元的接口" --locale zh --json
pontx-hub show endpoint:frankfurter/get-latest-rates
pontx-hub show schema:frankfurter/ExchangeRateResponse
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD
# GET can run after the user asks for execution.
pontx-hub frankfurter call 'Exchange Rates' getLatestRates --base USD

按需安装产品 Skill

先用统一 Skill 找到合适的 API；需要供应商特有的集成步骤时，再安装对应产品 Skill。Endpoint、参数和 Schema 始终从当前目录读取，不会复制到 Skill 中。

发现并安装

pontx-hub skill list
pontx-hub skill install <api-slug>
pontx-hub sdk <api-slug>