用途:为已有应用搭建后端集成测试,采用 Vitest 与隔离的测试数据库 schema,并针对 tRPC 路由编写测试。
主要能力与流程:
- 收集信息:需要 Timescale Cloud 的 service_id;若未提供,可从 .env 的 DATABASE_URL 中查找,或使用 service_list MCP 工具。
- 搭建测试基础设施:调用 setup_testing MCP 工具,参数为 application_directory: "." 与 service_id: "<service_id>";安装依赖 npm install -D vitest dotenv;在 package.json 中添加脚本 "test": "vitest run" 与 "test:watch": "vitest"。
- 为每个 tRPC router 编写集成测试,使用 createCallerFactory(appRouter) 创建 caller,并传入 session、db、headers。
- 运行 npm test,确保全部通过。
- 更新 CLAUDE.md:新增 Testing 章节,说明测试运行在独立 PostgreSQL schema 上(见 .env.test.local 中的 DATABASE_SCHEMA),专用测试用户仅对该 schema 有权限,schema 在测试前通过 global setup 自动推送,测试使用 .env.test.local(已 gitignore);同时在 Commands 部分加入 npm test 与 npm run test:watch,在“New tRPC Router”清单加入“3. Add tests in src/test/routers”,并在“Before Committing”中加入 npm test && npm run check。
- 提交:询问用户是否提交更改。
- 进一步加固:询问是否添加更严格的 TypeScript 检查,若同意则遵循 add-strict-checks 技能。
适用场景:已有 tRPC 后端、希望引入隔离数据库的集成测试的项目。
限制:资料未提供具体收费、价格、平台支持范围或效果数据;需具备 Timescale Cloud 服务与相应 MCP 工具环境。