Agent Skills
返回列表
💻

API 接口测试管理器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_2975cc0f/api-test-manager。

技能介绍

要解决什么问题

手上有 OpenAPI 3.x 或 Swagger 2.0 文档时，手工写接口测试用例、维护 Base URL 和断言，往往和文档脱节；多服务、多环境时还要自己建表格或脚本分组。这个技能把文档解析 → 用例入库 → 可视化编辑 → 批量执行串成一条本地工作流，数据落在 SQLite，按项目隔离。

它怎么工作

  • 导入：init 支持本地 JSON/YAML 或在线 URL；Web UI 也可「导入文档」。解析时会递归处理 #/definitions/、#/components/schemas/ 的 $ref（含循环引用保护），并从 Swagger 2.0 的 host/basePath/schemes 或 OpenAPI 3.0 的 servers[0].url 提取 Base URL。
  • 接口命名：优先 summary，其次 description，再 fallback 到 METHOD path。
  • 默认用例：每个接口自动生成三类场景——正常请求（期望 200）、缺少必填参数（期望 400）、需要认证时的未授权访问（期望 401）。可在 UI 里改 Headers、Query、Body 和断言。
  • 断言：支持 status、body_contains、body_field（如校验 data.id）。
  • 执行与结果：CLI run 或 UI 单条/全量跑测，结果写入数据库并在「测试结果」页看统计与响应详情。

技术栈为 Go（GoFrame v2）+ SQLite 后端，Vue 3 + Element Plus 前端；数据库默认在 ~/.api-test-manager/data/api-test.db，与技能安装目录无关，重装不丢数据。

适用边界

  • 依赖文档质量：参数、schema、requestBody/parameters 不完整时，生成用例和示例值可能不准，仍需人工补全。
  • 自动「未授权」用例只在文档表明需要认证时才有意义；复杂 OAuth、签名、多步登录不会自动编排。
  • 适合联调、回归和文档驱动的冒烟测试，不是替代专业压测或契约测试平台的完整替代方案。

使用场景

  • 后端更新 OpenAPI 文档后，用 init 生成用例并在 Web UI 把 Base URL 指到联调环境批量跑冒烟。
  • 公司多个服务各有一份 Swagger 2.0，按项目分别导入并在界面里维护、执行各自回归用例。
  • 只有在线 spec 地址或本地 yaml 时，导入后编辑 Headers、Query 与 body_field 断言再单条重跑。
  • 文档里接口带 security 定义时，对照自动生成的 200 与 401 用例检查网关或鉴权是否配错。

适合人员

  • 维护 OpenAPI 契约的后端开发，接口变更后要用文档驱动的用例核对状态码和响应字段。
  • 收到 Swagger 导出文件的测试同学，需要在界面改参数与断言而不是维护一长串 curl。
  • 对接第三方 REST API 的全栈工程师，要从 schema 生成示例请求并把每次联调结果留在测试结果页。
  • 负责新服务上线的技术负责人，用项目分组隔离多套环境的接口定义与用例库。