Agent / 通用 Skill
让 Agent 按需查找，而不是背下全部 API。
安装通用 Pontx Hub Skill，让 Agent 通过统一 CLI 搜索、检查、预演并在获得授权后调用 API。
01发现
pontx-hub search02理解
pontx-hub show03验证
pontx-hub preview04集成
pontx-hub sdk01
安装 Skill
Skill 只安装一次；API 数据始终通过 CLI 按需读取。
npx skills add https://github.com/pontjs/pontx-hub --skill pontx-hubpnpm add --global @pontx/hub-cli
pontx-hub skill installCLI 默认安装到当前项目的 .agents/skills/pontx-hub；使用 --output 可选择目录，使用 --force 明确更新已有 Skill。
02
Agent 工作流
Skill 把一个开放式 API 请求收敛为可审查的六个步骤。
01
search搜索能力02
show检查资源03
preview预演请求04
confirm确认副作用05
call按授权调用06
sdk生成集成pontx-hub search "把欧元换算成美元的接口" --locale zh --json
pontx-hub show endpoint:frankfurter/get-latest-rates
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD
# The agent calls only after the user asks for execution.
pontx-hub frankfurter call 'Exchange Rates' getLatestRates --base USD03
保持上下文轻量
Skill 本身不复制整个 OpenAPI 目录，而是教 Agent 何时加载哪一种资源。
常驻上下文Skill workflow
按需加载API → Endpoint → Schema
最终输出Preview → Call → SDK
这样可以减少陈旧文档、错误参数和无关 Schema 对推理的干扰，同时让每次选择都能回溯到稳定资源 ID。
04
不可绕过的边界
Skill 扩展检索和执行能力，但不会扩展用户授权。
- ✓搜索、解释或生成代码不等于允许执行。
- ✓写操作必须先展示精确预演，再获得用户确认。
- ✓凭证来自环境变量，不写入命令参数、日志或回复。
- ✓只能调用 Hub 目录中批准的 API、接口与服务地址。