Agent / 统一 + 产品 Skills
让 Agent 结合统一 Skill 与产品 Skill 使用 API。
统一 pontx-hub Skill 负责跨目录发现、检查与安全调用；产品 Skill 补充提供商特有的集成流程、最佳实践和注意事项。
01搜索目录
pontx-hub search02预览请求
pontx-hub preview03通用调用
pontx-hub call04类型集成
@pontx/<api>01
安装统一或产品 Skill
先安装统一 pontx-hub Skill；需要某个提供商的集成流程、最佳实践或注意事项时，再安装对应产品 Skill。
npx skills add https://github.com/pontjs/pontx-hub --skill pontx-hubpnpm add --global @pontx/hub-cli
pontx-hub skill install
pontx-hub skill list
pontx-hub skill install stripe-identityskill install 不带参数时安装统一 Skill；传入 apiSlug 或完整 Skill 名称时安装产品 Skill。使用 --output 选择目录，使用 --force 明确更新已有 Skill。
02
统一发现，产品指引
统一 Skill 用 CLI 查找并检查当前资料；产品 Skill 只在选定 API 后补充提供商特有的步骤和风险提示。真实调用仍由你决定。
01
search找到合适的接口02
show查看参数和说明03
product Skill补充产品集成指引04
preview核对完整请求05
confirm确认是否会修改数据06
call确认后调用07
sdk生成项目代码pontx-hub search "把欧元换算成美元的接口" --locale zh --json
pontx-hub show endpoint:frankfurter/get-latest-rates
pontx-hub frankfurter preview 'Exchange Rates' getLatestRates --base USD
# 只有你确认后，才会真正调用接口。
pontx-hub frankfurter call 'Exchange Rates' getLatestRates --base USD03
两层 Skill，一份 PontxSpec
Skill 只保留真正有用的流程与经验；具体 API、接口、字段、认证和版本始终按当前问题从 PontxSpec 读取。
统一 Skill跨目录发现与安全流程
产品 Skill提供商特有流程与注意事项
当前 PontxSpecAPI → Endpoint → Schema → SDK
产品 Skill 不复制 Endpoint 清单、Schema 或参数表。这样更容易拿到最新资料，也不会让提供商经验与 API 元数据发生漂移。
04
不可绕过的边界
Skill 可以帮你查资料和准备调用，但不会替你决定是否发送请求。
- ✓搜索、解释或生成代码不等于允许执行。
- ✓可能修改数据的操作，必须先展示完整请求，再由你确认。
- ✓凭证来自环境变量，不写入命令参数、日志或回复。
- ✓只能调用 Hub 目录中批准的 API、接口与服务地址。
- ✓产品 Skill 负责提供商集成经验，当前 API 事实仍以 PontxSpec 为准。
- ✓应用代码使用已发布的 @pontx/<apiSlug> SDK。