SuperAPI AI 工具集

ac-api

编程与开发

查看项目

更新于 10-16 09:59

技能介绍

用途:将 SKSPIOT 项目中「无 Controller、直接暴露 Service 接口」的能力整理为 OpenAPI 3.1 JSON 文件,供用户手动导入 Apifox。流程目标只有生成可导入文件,不再通过 apifox MCP 直接创建或更新接口。

触发与用法:手动触发,命令为 /ac-api <需求描述>,例如「把充电桩概况接口导出成 Apifox 可导入的 OpenAPI 文件」。

识别规则:类或接口上有 @BusinessCenterDescriptor,方法上有 @BusinessDescriptor;所有请求 POST,Content-Type 固定 application/json,路径为 /json-adapter,地址 http://127.0.0.1:8888。bid 由 Service 全限定名与业务方法名组成,业务方法名优先取 @BusinessDescriptor.name。

请求体固定为 bid、params、passport 三段,params 按方法参数名展开,无参数用空对象,passport 用 {{access_token}}。返回值统一包装为 code、success、data、msg,data 依据真实返回实体推导。

生成方式:优先用本地脚本,命令为 python skills/ac-api/scripts/generate_openapi.py --input <metadata.json>(可加 --save-metadata),或 python skills/ac-api/scripts/export_openapi_from_java.py --source <Java文件或目录> --save-metadata。默认输出到 .claude/OpenAPI/YYYY-MM-DD/,文件名 HH-MM_BusinessCenter.method.openapi.json,单接口单文件,OpenAPI 版本 3.1.0。

约束与限制:先读后做、禁止猜测、信息缺失先澄清;返回字段说明优先取 @Schema、@ApiModelProperty、Javadoc/注释,证据不足需明确列出;重名类型歧义不得静默命中。仅适用于符合上述规则的 SKSPIOT 项目,不符合时停止套用。不声称已同步到 Apifox。其他平台、价格与效果暂未提供。