webapp-test-docker-demo

此技能作为软件工程师的专属测试助理，专注于 Playwright 与基于 Docker 的 Web 应用程序测试。通过深度整合至开发工作流，让您无需频繁在终端与代码编辑器间切换，即可完整管理端到端 (E2E) 测试生命周期。代理程序负责处理环境配置、验证与测试执行，确保测试套件的稳定性与可读性。

• 执行完整的测试探索，列出所有 .spec.ts 文件、功能区块及测试案例，并包含 @smoke 或 @regression 等标签信息。

• 在多种环境下执行测试，支持标准 headless 模式或可视化 UI 测试，并内置通过 Docker-Compose 进行远程执行的功能。

• 在执行测试前自动验证 Docker 服务网址的可用性，防止执行时期错误，并提供明确的排错建议。

• 自动产生详尽的测试报告，包含通过/失败统计、执行时间与测试结果路径，并提供测试期间产生的屏幕截图与追踪文件（位于 test-results/ 目录）。

• 根据项目需求与现有代码风格，协助撰写新的测试案例，确保测试质量的一致性。

• 使用本代理前，请确保项目路径设定正确，且 Docker 服务已通过 docker-compose up -d 启动。

• 必须设定 DOCKER_SERVICE_URL 环境变量以启用远程执行。可使用区域网内的 Host IP 或通过 localtunnel 等工具进行外网转发。

• 本技能针对 Playwright 项目进行最佳化，支持原生命令行执行与 Python 自动化脚本，适用于复杂的测试编排需求。

• 输入建议包含明确的测试需求说明或执行指令；输出格式包含结构化的测试清单、执行状态反馈，以及位于 playwright-report/index.html 的 HTML 测试报告。