API契约测试与回归验证
读取接口规范、路由代码和现有测试,生成有依据的接口用例,并在获准环境中验证契约与回归结果。
功能与用途
适用于为已有项目补充接口测试、核对接口行为与规范是否一致,以及验证修复后的回归结果。提供项目代码、OpenAPI 文档或现有测试,并指定目标接口,即可获得成功、边界、权限和错误场景的测试代码,以及契约差异与待确认事项。测试沿用项目已有框架;如需执行,还须提供明确的测试环境、账号权限和数据清理条件。最终报告区分已生成与实际执行的用例,列出验证结果及已有失败。
适用场景
- 为新接口补齐集成测试:读取路由、参数校验和现有测试,补充有依据的成功、边界及错误场景用例。
- 核对接口规范与实际行为:对照 OpenAPI 与实现,检查状态码、响应结构和权限约束,列出契约差异。
- 为接口缺陷添加回归用例:依据已知缺陷和兼容性要求生成回归测试,在获准环境中复验修复结果。
- 验证资源权限与数据归属:依据已有认证和资源归属规则,测试不同身份访问接口时的实际行为。
适用人群
- 后端开发工程师
- 测试开发工程师
- 负责接口联调的全栈开发者
使用步骤
- 提供项目位置,指定目标接口和测试目标。
- 说明只生成测试,还是需要执行验证。
- 核对接口契约,确认规范与实现中的分歧。
- 沿用项目框架生成用例,按授权范围执行。
- 查看测试结果、契约差异和数据清理情况。
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes Agent、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-11-03
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
依据真实 OpenAPI、路由实现和现有测试生成并验证 API 测试。用于用户要求测试接口、补集成测试、验证 API 契约、生成回归用例或排查接口兼容性时;区分“生成测试”和“执行请求”的授权,不猜测状态码、响应结构或 SLA,不在未确认环境中发送写请求。
使用前准备
- 可读取目标项目代码,并有接口规范、实现或现有测试可作为依据。
- 执行测试需具备可用的项目测试依赖和明确的运行环境。
- 涉及认证或写操作时,需提供测试账号、执行授权及数据隔离与清理方案。