用途:为 REST API 端点生成可运行的集成测试,覆盖完整请求生命周期,包括认证、参数校验、成功响应、错误响应和数据库副作用。
主要能力:先做发现(框架 Express/Fastify/NestJS/Hapi、测试运行器 Jest/Vitest、HTTP 客户端 supertest/undici/fetch、认证机制、数据库方案、端点行为、已有测试设施);再决定集成边界(真实数据库+真实服务器、内存数据库、真实服务器+模拟服务层);生成认证测试(过期令牌、错误 aud/iss、权限不足返回 403 而非 401)、校验测试(按规则而非按字段,测边界值,断言错误体结构)、成功响应测试(状态码、响应体形状、Content-Type,不断言时间戳和生成 ID)、数据库副作用测试(成功写入后直接查库,失败请求不应持久化)、错误响应测试(404、409、500,且不泄露堆栈或数据库错误)。
使用方式:提供路由处理器或端点信息,技能据此提取配置并生成测试文件、令牌辅助函数和数据库种子辅助函数。测试隔离建议用事务回滚(beforeEach BEGIN、afterEach ROLLBACK),端口由系统分配(app.listen(0)),迁移在 beforeAll 运行一次,afterAll 关闭服务器和数据库连接。
适用场景:为 REST 端点补充集成测试、审查现有测试覆盖缺口、需要覆盖认证与数据库副作用的场景。
限制:事务回滚策略不适用于端点自身提交嵌套事务或使用独立连接池的情况(如 Prisma、TypeORM 自管连接);内存数据库需注意迁移未应用导致的 schema 漂移;真实服务器+模拟服务层会漏掉数据库约束和查询错误;不生成所有无效输入组合,只覆盖不同代码路径的最小集合。具体安装命令和依赖版本暂未提供。