name: sdk-mock-generator description: 为SDK测试生成模拟服务器和客户端 allowed-tools:
- Read
- Write
- Edit
- Glob
- Grep
- Bash
SDK模拟生成器技能
概述
此技能为SDK测试生成模拟服务器和客户端,使开发人员能够在不调用生产API的情况下测试集成。
能力
- 根据OpenAPI规范生成模拟服务器
- 使用真实数据创建SDK测试夹具
- 为各种场景实现响应桩
- 支持复杂工作流的状态模拟
- 生成错误响应模拟
- 配置延迟模拟
- 支持请求录制与回放
- 创建模拟数据工厂
目标流程
- SDK测试策略
- 开发者体验优化
- API文档系统
集成点
- Prism (OpenAPI模拟服务器)
- WireMock (HTTP模拟服务器)
- MSW (浏览器Mock Service Worker)
- Nock (Node.js HTTP模拟)
- VCR风格录制库
输入要求
- OpenAPI规范
- 测试场景需求
- 状态行为定义
- 需要模拟的错误场景
- 性能模拟需求
输出产物
- 模拟服务器实现
- 测试夹具数据
- 响应桩配置
- 状态场景处理器
- 模拟数据工厂
- 录制/回放设置
使用示例
skill:
name: sdk-mock-generator
context:
apiSpec: ./openapi.yaml
mockTool: prism
features:
- responseStubbing
- statefulMocking
- errorSimulation
- latencySimulation
scenarios:
- name: happyPath
responses: ./fixtures/happy-path/
- name: errorCases
responses: ./fixtures/errors/
recordMode: true
最佳实践
- 从与生产环境相同的规范生成模拟
- 在夹具中包含真实数据
- 模拟所有错误场景
- 支持状态测试流程
- 启用请求录制以便调试
- 模拟真实延迟