用途:oapi-expert 是面向 @desplega.ai/oapi 的技能。oapi 是一个依据 OpenAPI 规范动态生成 CLI 的命令行工具,可注册任意 API、探索端点并执行请求。
安装方式:CLI 使用 npm install -g @desplega.ai/oapi;作为 Claude Code 插件使用 /plugin install oapi@desplega-ai-toolbox;也可通过 npx skills add 安装技能。
主要能力:注册远端或本地规范(oapi register)、列出已注册 API(oapi list)、删除与刷新(oapi unregister / oapi refresh)、执行请求(oapi x)、查看文档与参数(oapi docs)、管理认证配置(oapi profile)。支持类型化字段 -F(自动解析数字、布尔、JSON、@file)、原始字段 -f、自定义头 -H、--input 请求体、--dry-run 生成 curl、--verbose、--jq 过滤、--no-validate 跳过校验。
使用方式:面对不熟悉的 oapi 时,先运行 oapi --help、oapi docs、oapi list,再执行 oapi docs <api-name> 或 oapi docs <api-name> <path>,然后用 oapi x <api> <path> [method] 发起请求。配置存放于 ~/.oapi/,可用 OAPI_CONFIG_DIR 覆盖。
适用场景:在终端探索和调试任意 OpenAPI 接口,快速发起带认证的请求。
限制:端点与参数完全取决于已注册的 API,无法凭空猜测;oapi 为动态工具,需先注册后使用。jq 相关功能需系统安装 jq。其他细节暂未提供。