Agent Skills
返回列表
源码驱动API测试

源码驱动API测试

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_c98012c0/source-driven-api-test。

技能介绍

要解决的具体问题

手工编写 API 测试用例时,容易遗漏后端源码中的 throw 分支与校验规则,导致测试覆盖滞后于代码迭代。黑盒测试无法覆盖业务异常的精确断言,回归验证成本高。此外,传统方式生成的 Collection 缺乏统一结构,执行后难以形成可追溯的测试报告。

技能如何工作

从后端源码出发,逐层分析:Controller 提取端点与参数,Service 梳理业务分支与异常映射,Validator 解析校验规则。基于分析结果生成 Postman Collection,包含登录认证、正常流程、异常分支、参数校验和清理等用例,支持 Cookie/Session、Bearer Token、HTTP Basic、API Key 四种认证方式。生成的 Collection 通过 Newman 执行,输出含通过率与失败详情的 HTML 报告,自动更新 record.md 台账记录环境与场景信息。

适用边界与注意点

需提供完整的 baseUrl 与认证凭证,缺失时会触发强制校验。适用于接口级功能测试,不含性能/压力测试与前端 UI 测试。Newman 执行完毕后为 HARD STOP,测试失败时仅输出结果,修复需用户显式发起新指令。生成的 Collection 与台账包含敏感信息,需自行管理文件权限。

使用场景

  • 后端接口提测前,需要根据源码中的异常分支和校验规则生成完整测试用例
  • 已有 Spring Boot 项目源码,需要自动提取端点清单并生成 Postman Collection 进行接口回归
  • 修改了 Service 层业务逻辑后,需要验证异常分支的错误消息与响应格式是否符合预期
  • 团队需要将接口测试纳入持续集成,通过 Newman 自动执行并输出 HTML 报告供代码评审

适合人员

  • 后端开发工程师:提测前需要根据源码自查接口行为,尤其是异常分支的错误处理与响应映射
  • 测试/QA工程师:需要从源码自动生成接口测试用例,减少手工编写导致的遗漏和重复劳动
  • 团队维护者:需要将生成的 Postman Collection 纳入仓库,作为接口回归测试资产供后续重复执行
  • 初学者:需要跟随完整工作流从源码分析到报告输出,学习接口测试的标准流程与代码模式