senior-qa

高级 QA 工程师

面向 React 和 Next.js 应用的测试自动化、覆盖率分析和质量保证模式。生成 Jest + React Testing Library 单元测试桩，分析 Istanbul/LCOV 覆盖率以发现缺口，并为 App Router 和 Pages Router 项目搭建 Playwright E2E 测试套件。

核心能力

• 单元测试生成 — 扫描 React/TypeScript 组件并生成 Jest + RTL 测试桩（渲染、交互、状态，以及可选的 jest-axe 无障碍测试）。
• 覆盖率分析 — 解析 Istanbul/LCOV 报告，按严重程度识别缺口，标记关键业务逻辑路径，并生成文本/HTML/JSON 格式的建议。
• E2E 测试搭建 — 检测 Next.js 路由（动态片段、路由组、身份验证页面），并生成 Playwright 测试规范、页面对象模型、夹具和配置。
• 测试策略 — 测试金字塔、按代码类型设定覆盖率目标，以及测试组织模式。
• 自动化模式 — 页面对象模型、数据工厂、MSW 模拟、夹具和自定义渲染工具。
• 质量实践 — 可测试代码设计、AAA 结构、测试隔离、消除不稳定测试，以及质量指标。

适用场景

• 为新的或现有的 React 组件设置单元测试。
• 提高测试覆盖率或准备发布。
• 为 Next.js 项目设置 Playwright E2E 测试。
• 配置 Jest 阈值或提升整体测试质量。

请先确认

生成测试前，请确认以下输入。如果有任何内容未知或含糊，请询问，不要自行假设：

• 测试层级 — 单元测试（Jest+RTL）还是 E2E（Playwright）（决定使用 test_suite_generator 还是 e2e_test_scaffolder）
• 源代码路径 — 用于生成测试的组件或 Next.js 路由（搭建工具的输入）
• 覆盖重点 — 仅正常流程，还是也包括交互/状态/无障碍（jest-axe）（决定生成哪些测试桩）

停止规则：只询问最可能影响输出的 2-3 项。如果用户说“直接起草”，则继续，并在产物开头列出假设。

工具

工具	用途	命令
test_suite_generator.py	根据 React 组件生成 Jest + RTL 测试桩	python scripts/test_suite_generator.py src/components/ --output __tests__/
coverage_analyzer.py	分析 Istanbul/LCOV 覆盖率并报告缺口	python scripts/coverage_analyzer.py coverage/coverage-final.json --threshold 80
e2e_test_scaffolder.py	根据 Next.js 路由搭建 Playwright E2E 测试	python scripts/e2e_test_scaffolder.py src/app/ --output e2e/

参考资料

加载与任务匹配的参考资料 — 保持此文件精简，按需查阅详细信息：

• references/qa-workflows-and-tools.md — 快速入门、三种工具概览及示例输出、单元测试/覆盖率/E2E 工作流、常见模式片段（RTL 查询、异步、MSW、Playwright 定位器、jest 阈值）、常用命令、故障排除表和成功标准。运行工作流时阅读。
• references/tool-cli-reference.md — 三个脚本的完整标志表、示例、输出格式和生成的产物。运行脚本前阅读。
• references/testing_strategies.md — 测试金字塔、测试类型、覆盖率目标和阈值，以及测试组织模式。设计测试策略时阅读。
• references/test_automation_patterns.md — 页面对象模型、数据工厂、夹具管理、模拟策略（MSW）和自定义测试工具。编写测试代码时阅读。
• references/qa_best_practices.md — 编写可测试代码、命名约定、AAA 模式、测试隔离、不稳定测试调试和质量指标。提升测试质量时阅读。

范围与限制

此技能涵盖：

• 使用 Jest 和 React Testing Library 为 React/TypeScript 函数组件和类组件生成单元测试桩。
• 从 Istanbul JSON 和 LCOV 报告格式分析覆盖率并识别缺口。
• 使用 Playwright 为 Next.js App Router 和 Pages Router 项目搭建端到端（E2E）测试框架。
• 通过集成 jest-axe 生成无障碍测试。

此技能不涵盖：

• 后端 API 测试（Express/Node.js 测试模式请参阅 senior-backend）。
• 性能或负载测试（基础设施和性能工具请参阅 senior-devops）。
• 视觉回归测试或截图对比工作流。
• 原生移动端测试（React Native、Flutter）——此技能仅针对基于 Web 浏览器的测试。

集成点

技能	集成方式	数据流
senior-frontend	生成的测试桩与前端技能中的组件模式保持一致	前端组件 --> test_suite_generator.py --> 测试文件
senior-fullstack	代码质量分析器使用此处生成的相同覆盖率报告	coverage_analyzer.py 输出 --> 全栈质量仪表板
senior-devops	E2E 测试搭建器生成可用于 CI 的 Playwright 配置，可接入 DevOps 流水线	e2e_test_scaffolder.py --> playwright.config.ts --> GitHub Actions 工作流
code-reviewer	覆盖率缺口直接纳入代码审查清单，用于检查未经测试的变更	coverage_analyzer.py 缺口 --> 审查清单项
tdd-guide	TDD 工作流会调用此技能的测试生成器，创建初始红阶段测试桩	TDD 周期 --> test_suite_generator.py --scan-only --> 编写测试 --> 实现
qa-browser-automation	此处生成的页面对象模型由浏览器自动化技能用于高级 E2E 场景	e2e_test_scaffolder.py --include-pom --> POM 类 --> 浏览器自动化流程