SuperAPI AI 工具集

hyperexecute-skill

测试与质量

查看项目

更新于 10-15 15:18

技能介绍

HyperExecute Operator 是一个面向 TestMu AI/LambdaTest 云端测试执行的技能,用于端到端地操作 HyperExecute。

用途 该技能用于在 LambdaTest 的 HyperExecute 平台上运行云端测试作业。它覆盖从分析项目、编写配置、本地校验、运行 CLI 作业到调试失败的完整流程,帮助用户把本地测试项目迁移到 HyperExecute 云端执行。

主要能力

  • 项目分析:在 CLI 可用时运行 hyperexecute analyze,仅在无法使用时回退到本地检查。
  • 配置生成与修复:根据分析输出、项目测试命令和 reference/ 中的模板,创建或修复 hyperexecute.yaml。
  • 本地校验:运行 node scripts/doctor.js --config hyperexecute.yaml 和 node scripts/validate-config.js hyperexecute.yaml,并使用官方 CLI 执行 ./hyperexecute --user "$LT_USERNAME" --key "$LT_ACCESS_KEY" --config hyperexecute.yaml --validate。
  • 云端作业执行:在获得确认后运行真实云端作业。
  • 失败调试:下载日志、产物和报告,并参考 reference/troubleshooting.md 进行排查。
  • 辅助脚本:doctor.js 检查 CLI 就绪状态、凭据、配置存在性和可选的官方校验;validate-config.js 在官方校验前做轻量配置检查;build-command.js 打印使用环境变量引用的安全 validate/run/debug/download 命令;summarize-artifacts.js 汇总下载的日志、报告和产物以便分诊。
  • 参考文档:涵盖 CLI 用法与参数(reference/cli.md)、YAML 模式(reference/yaml-patterns.md)、框架配方(reference/frameworks.md)、CI/CD 集成(reference/ci-cd.md)、安全规则(reference/security.md)和故障排查(reference/troubleshooting.md)。

使用方式

  1. 定位 HyperExecute CLI。如果缺失,除非用户明确批准自主 HyperExecute 会话,否则应先询问再下载。
  2. 在 CLI 可用时运行 hyperexecute analyze。
  3. 根据分析输出、项目测试命令和模板创建或修复 hyperexecute.yaml。
  4. 运行辅助脚本进行本地检查。
  5. 使用官方 CLI 进行校验。
  6. 除非用户明确选择自主会话,否则在运行真实云端作业前请求确认。
  7. 失败时下载日志、产物和报告,并参考故障排查文档。

操作规则

  • 官方 HyperExecute CLI 是 analyze、校验、执行、日志、报告和产物的唯一事实来源。
  • 使用本地环境变量或 CI 密钥中的 LT_USERNAME 和 LT_ACCESS_KEY,绝不在 YAML 或文档中硬编码凭据。
  • 仅在需要额外作业级密钥时使用 --job-secret-file,最好放在仓库外或被 .gitignore/.hyperexecuteignore 忽略。
  • 优先使用模板驱动的 YAML,而非生成器脚本,因为测试命令、路径和负载边界因项目而异。
  • 自动运行安全的本地检查;除非用户选择自主模式,否则仅在确认后运行真实 HyperExecute 云端作业。
  • 在自主模式下,先校验、再运行、检查输出、必要时下载日志/产物,并且仅针对可操作的配置或环境修复进行重试。

工作流

  • 首次运行:分析项目、编写 YAML、运行辅助检查、运行 CLI 校验,然后请求确认云端作业。
  • 调试:复现失败的 CLI 命令,必要时添加 --verbose,下载日志/产物/报告,一次修复一个原因。
  • CI:使用 CI 密钥,在执行前添加校验阶段,设置 CI=true 以获得更安静的日志,并为失败作业保留下载的产物。
  • 性能:在一次成功运行后,调整 autosplit、并发、缓存键、重试、智能排序以及矩阵/混合范围。

适用场景 适用于需要在 LambdaTest HyperExecute 云端运行测试、生成或修复 hyperexecute.yaml、在 CI 中集成 HyperExecute 作业,以及调试云端测试失败的场景。

限制

  • 真实云端作业默认需要用户确认,除非用户明确选择自主模式。
  • 凭据必须通过环境变量或 CI 密钥提供,不能硬编码。
  • 关于具体收费、价格、平台支持范围等信息,资料中暂未提供。