SuperAPI AI 工具集

api-spec-analyzer

编程与开发

查看项目

更新于 10-16 00:03

技能介绍

用途:分析 OpenAPI 规范,为 caremaster-tenant-frontend 项目提供准确的 API 文档、TypeScript 接口与实现指导。触发场景包括:实现新 API 集成、遇到 400/401/404 等 API 错误、用真实后端替换 mock API、询问数据类型/必填字段/API 格式、提到 /api/users 或 /api/tenants 等端点、实现任何需要 API 调用的功能前、调试前后端类型不匹配。

主要能力:通过 MCP 工具获取 OpenAPI 规范(mcp__Tenant_Management_Portal_API__read_project_oas_f4bjy4,刷新用 refresh_project_oas_f4bjy4,引用 schema 用 read_project_oas_ref_resources_f4bjy4);提取 HTTP 方法/路径、认证方式、路径与查询参数、请求体 schema、必填头、成功与错误响应结构、状态码含义、精确数据类型与格式(ISO 8601、UUID、email)、必填与可选字段、枚举与约束、默认值;生成带 JSDoc 的 TypeScript 接口;给出 API 服务、TanStack Query Hook、查询键工厂、乐观更新、分页、搜索过滤与错误处理示例;补充 OWASP 安全、输入校验、认证、限流与测试建议。

使用方式:按步骤先获取规范,再分析端点,生成接口,提供实现指导,记录安全与校验,给出测试建议,并按固定输出结构(端点摘要、请求规范、响应规范、数据类型细节、TypeScript 接口、实现指南、安全说明、集成清单)输出。项目约定:使用 @/ 路径别名,Biome 风格(制表符缩进、双引号、分号可选、行宽 100),文件组织为 src/types、src/api、src/hooks、src/lib/queryKeys.ts。

限制:资料未提供该技能的安装方式、收费、价格、支持平台与效果数据;其分析依赖可用的 MCP 服务器与 OpenAPI 规范,规范缺失或过时会影响结果。