SuperAPI AI 工具集

grey-haven-testing-strategy

测试与质量

查看项目

更新于 10-16 05:50

技能介绍

用途:为 Grey Haven 代码库编写测试、搭建测试基础设施或提升覆盖率时,提供统一的 TypeScript(Vitest)与 Python(pytest)测试规范。配套资料包括 EXAMPLES.md(可复制的测试示例)、REFERENCE.md(完整配置、项目结构与 CI 设置)、templates/(测试模板)、checklists/(质量清单)、scripts/(覆盖率与执行辅助脚本)。

主要能力:统一覆盖率门槛——所有项目最低 80%,关键路径目标 90%+,安全关键代码(认证、支付、多租户隔离)要求 100%,并由 CI 强制执行。统一测试标记:unit(快速、隔离,单函数/类)、integration(多组件或外部依赖)、e2e(完整用户流程)、benchmark(性能测量)。

用法:TypeScript 侧使用 Vitest,配置 globals、jsdom、setupFiles 及 coverage 阈值;常用命令为 bun run test、bun run test:coverage、bun run test:watch、bun run test:ui。Python 侧使用 pytest,须先执行 source .venv/bin/activate,并通过 doppler run -- pytest 运行(可按 -m unit/integration/e2e 筛选,--cov=app 输出覆盖率)。环境变量统一由 Doppler 提供(如 DATABASE_URL_TEST、REDIS_URL 等),CI 中使用 doppler run --config test。多租户项目须验证 tenant_id 隔离;测试数据使用 faker 工厂与 fixture 生成并清理。

适用场景:编写新测试、搭建 Vitest/pytest、配置 CI 测试流水线、修复失败测试、提升覆盖率、审查测试质量、配置 Doppler 测试环境、创建 fixture/factory、实施 TDD。

限制:资料未提供具体版本号、依赖安装命令、完整 CI 工作流及模板细节,需查阅 REFERENCE.md 与 EXAMPLES.md;不得提交 .env,Python 测试必须激活虚拟环境。