SuperAPI AI 工具集

apic-openapi-operation-selector

编程与开发

查看项目

更新于 10-15 22:16

技能介绍

用途:检查 OpenAPI 或 Swagger 文件,提取每个唯一的路径与 HTTP 方法组合,先以编号选项呈现,收集用户选择后输出所选操作。

主要能力:支持 JSON、YAML、YML 格式的 OpenAPI 文件;生成带 index、label、method、path、operationId 的编号选项;根据用户提供的编号输出路径到 HTTP 方法数组的 JSON 映射;同一路径的多个方法会合并到同一数组;按源文档中路径顺序和 HTTP 方法顺序保持确定性排序;重复编号只返回一次。

使用方式:先运行 node ./.bob/skills/apic-openapi-operation-selector/select-operations.js ./path/to/openapi.yml --list 生成编号选项,将选项展示给用户并等待其回复逗号分隔的编号(如 1,3,4);用户明确提供编号后,再运行 node ./.bob/skills/apic-openapi-operation-selector/select-operations.js ./path/to/openapi.yml --select-indexes "1,2" 输出最终结果。

标签规则:若操作的 operationId 在整个文档中唯一,则显示 operationId,否则显示 <http-method> <path>;忽略路径项下的 summary、description、parameters、servers 等非操作键。

限制:不得在用户明确提供编号前使用 --select-indexes;不应依赖终端交互提示作为主要选择方式;文件无效或无 paths 对象时视为无可选操作。