HaibaraAiAPTX

download-openapi

"Download remote OpenAPI JSON to local file via aptx-ft. Use when user asks to fetch swagger/openapi from URL, save spec to openapi.json, or prepare local input for later model/service generation."

HaibaraAiAPTX 1 Updated 3mo ago

Resources

1
GitHub

Install

npx skillscat add haibaraaiaptx/frontend-openapi-skills/download-openapi

Install via the SkillsCat registry.

SKILL.md

下载 OpenAPI JSON

使用底层命令,不包含本地脚本包装。

前置条件

在目标项目安装 aptx 包,并确保可执行 aptx-ft

pnpm add -D @aptx/frontend-tk-cli

执行步骤

  1. 选择输出文件路径(建议 ./openapi.json)。
  2. 执行下载命令。
  3. 下载成功后,把该文件路径交给其他技能(如模型生成、请求框架生成)。
pnpm exec aptx-ft input download --url <url> --output <file>

可选(未使用 pnpm 时):

npx aptx-ft input download --url <url> --output <file>

示例:

pnpm exec aptx-ft input download --url https://api.example.com/swagger.json --output ./openapi.json

输出

  • 本地 OpenAPI JSON 文件(例如 ./openapi.json)。

边界

本 skill 仅处理 OpenAPI JSON 格式的下载:

  • 不支持 YAML 格式的 OpenAPI 规范
  • 不处理需要认证的 URL(如需要 Bearer Token)
  • 不处理自定义请求头
  • 下载后不自动验证 OpenAPI 规范的有效性(仅验证 JSON 语法)

如需上述功能,请手动下载后使用其他工具处理。