前言¶
在 API 开发流程中，先编写接口文档再编写自动化测试用例，是常见的实践。但手动从 Swagger/OpenAPI 规格生成测试代码或测试用例表，需要编写大量样板代码和解析逻辑。swagger-to-testcases 这个 Skill 专注于解决这一环节的重复劳动，将规格文件直接转换为可直接交付的测试资产。
这是什么¶
swagger-to-testcases 是一个从 Swagger/OpenAPI 规格文件生成 API 自动化测试用例的工具，同时附带完整的 pytest 测试运行框架。它由社区用户 user_a84e2069 发布，属于 dev-programming 分类，当前版本为 1.0.0。
这个 Skill 适用于需要将接口文档转换为测试资产的场景，能够同时输出 Excel 格式的测试用例表和 pytest 测试框架文件。
核心功能¶
输入与输出¶
输入：Swagger/OpenAPI 2.0 或 3.x 规格文件（JSON 或 YAML 格式）
输出两种格式：
- Excel 测试用例表（26 列完整用例，包含请求参数、预期结果、测试数据等）
- pytest 测试框架文件（可直接运行的测试代码 + 配置文件）
一键生成两种交付物¶
- Excel 用例表可直送 QA 团队
- pytest 代码可接入 CI/CD 流水线
- 两者同时生成，兼顾手工测试和自动化测试
配套框架完整度高¶
除了生成用例，还提供完整的测试运行基础设施：
- config：支持环境变量覆盖、多环境切换
- HTTP 客户端：封装了重试、超时、token 自动注入、参数化替换等常用能力
- 数据库断言、清理机制：适合有状态的 API 测试场景
- 日志和报告：专业日志与自动化报告
日志和报告专业¶
- 专用 logger.request() / logger.response() / logger.assertion() 方法，失败时快速定位
- 自动脱敏 Authorization、token、password 等敏感字段
- 邮件报告支持 HTML 格式、通过率进度条、Allure 报告 zip 附件
字段规范文档完善¶
- references/field_spec.md 定义了 26 列 Excel 的每个字段含义
- 蓝色表头、冻结行、自动筛选、颜色编码等视觉格式化开箱即用
脚本支持分步和管道两种模式¶
安装与启用¶
Skill 依赖项：无特殊依赖说明（标签显示 requires_api_key=false）
启用方式（通过 SkillHub 平台）：
- 访问官方地址：https://api.skillhub.cn/user_a84e2069/swagger-to-testcases
- 在支持 SkillHub 的编辑器或工具中安装该 Skill
- 使用触发词调用，例如：”Swagger生成测试用例”、”OpenAPI转Excel用例”、”接口文档生成自动化用例”、”swagger to test cases”、”API test case generation from spec” 等
典型用法¶
在支持 SkillHub 的环境中，使用触发词调用：
Swagger生成测试用例
或
swagger to test cases
Skill 将读取当前上下文中的 Swagger/OpenAPI 规格文件（JSON 或 YAML），生成以下文件：
- Excel 测试用例表（26 列字段，包含请求参数、预期结果、测试数据等）
- pytest 测试框架文件（包含测试代码、配置文件、日志、报告等）
适用场景与注意¶
适用场景：
- 已有 Swagger/OpenAPI 规格文件，需要快速生成自动化测试用例
- 需要同时为 QA 团队提供手工测试用例表和自动化测试代码
- 需要完整的测试运行基础设施（config、HTTP 客户端、日志、报告）
- 需要接入 CI/CD 流水线的 API 自动化测试
注意：
- 需要提供有效的 Swagger/OpenAPI 2.0 或 3.x 规格文件
- Excel 表格字段规范由 references/field_spec.md 定义，共 26 列
- 需要确保 SkillHub 环境支持该 Skill 的调用
总结¶
swagger-to-testcases 将接口文档到测试用例的转换流程标准化、自动化，同时提供开箱即用的测试运行框架。它解决了从规格到测试资产的重复劳动，让团队能够同时获得手工测试用例表和自动化测试代码，并支持直接接入 CI/CD 流水线。
官方地址：https://api.skillhub.cn/user_a84e2069/swagger-to-testcases
