api-spec-analyzer

API Specification Analyzer 是一款专为 caremaster-tenant-frontend 项目开发人员设计的工程工具。它通过解析原始的 OpenAPI 文档并将其转换为实际可用的代码，从而缩短开发周期。此技能适用于需要加速 API 集成、确保严格类型安全，以及维护前端服务与后端 RESTful 端点之间一致性的软件工程师、前端开发人员及全栈开发者。

主要功能与特性包含：

• 利用专用的 MCP 工具智能地提取与更新项目的 OpenAPI 规范文档。
• 自动生成强大的 TypeScript 接口，涵盖复杂的嵌套对象、枚举约束及必要字段验证。
• 为常见架构模式提供生产级的代码支架，包括 Fetch API 服务、TanStack Query 钩子以及优化的查询键管理。
• 系统化分析 HTTP 方法、路径参数、查询字符串以及请求与响应主体结构。
• 结构化记录安全性需求，包含 Bearer Token 验证、输入验证策略，以及针对 400、401、404 及 500 等标准 HTTP 状态码的错误处理。

实务应用建议：

• 当您需要实现涉及后端通信的新功能、将 Mock 数据替换为真实 API 调用，或是调试类型不匹配时，请启用此技能。
• 分析器对端点名称极为敏感；若您提及 /api/users 等路径，它会自动搜索相关规范细节。
• 它能提供符合 API 契约的测试建议，协助您编写涵盖成功与失败情境的单元测试（例如：重复 Email 冲突、未经授权的访问）。
• 请确保已启动必要的 MCP 服务器连接，此技能依赖租户管理门户 API 工具来获取实时文档更新。
• 输出结果为清晰的 Markdown 格式，方便您直接将生成的类型复制到 TypeScript 原始文件中，确保前端代码能与不断演进的后端 API 契约完美同步。