SuperAPI AI 工具集

api-anything

编程与开发

查看项目

更新于 10-16 08:49

技能介绍

用途:把 OpenAPI/Swagger 规范转换成面向智能体(agent-first)的可生产使用 CLI。生成的 CLI 须遵循 CLI-MANIFEST 契约(内含 23 条原则)。

主要能力:支持从 URL、本地文件或粘贴内容读入规范;解析并校验结构、解析 $ref,报告缺失/循环引用、未解析 schema、可疑认证、命名冲突及不支持的构造(websocket、callbacks 等)。对操作分组为资源族,统一命名,并将操作分类为 read/write/bulk/long-running/high-risk。生成资源导向命令(如 customer list/get/create/update/delete),而非镜像原始路径;提供 guide、spec、--help、--version 等自省命令。输出统一 JSON envelope,含 schema_version、request_id、ok、command、result、error、meta,并定义稳定错误码。认证支持 API key、Basic、Bearer、OAuth 2.0(client credentials、授权码+PKCE)、OIDC 发现、mTLS、自定义网关头,并支持 test/syst/prod 环境 profile 与配置覆盖。写入操作提供 --dry-run、--force、变更记录、幂等键与风险分级;高风险操作采用 --plan/--validate/--apply/--verify 事务流程。

使用方式:按 7 个阶段执行——读入规范、规范化 API 模型、建模 CLI 命令面、建模企业认证、添加安全与可运维性、生成实现工件、验证。默认技术栈可选 Node.js/TypeScript(Commander.js 或 oclif)、Python(Typer 或 Click)、Go(Cobra)、Rust(Clap)。

适用场景:需要由规范生成智能体可用的 CLI 封装、企业认证配置、资源化命令时。

限制:不生成客户端 SDK/库;不适合调试消费现有 API、文档/可视化、mock 服务或 GUI/Web 前端。不负责部署、发布或托管;生成的是确定性包装,不添加业务逻辑。websocket、GraphQL、gRPC、事件流端点超出范围;文件上传/下载可能需手工调整。规范歧义处会显式说明假设并生成 spec-patches.yaml 供修正。