hyperexecute-skill

HyperExecute 操作员

快速入门

1. 找到 HyperExecute CLI。如果未找到，除非用户明确批准启动自主 HyperExecute 会话，否则请先询问，再下载。
2. 如果 CLI 可用，请运行 hyperexecute analyze；只有在无法使用时才进行本地检查。
3. 根据 analyze 输出、项目测试命令以及 reference/ 中的模板，创建或修复 hyperexecute.yaml。
4. 运行 node scripts/doctor.js --config hyperexecute.yaml 和 node scripts/validate-config.js hyperexecute.yaml。
5. 使用官方 CLI 验证：./hyperexecute --user "$LT_USERNAME" --key "$LT_ACCESS_KEY" --config hyperexecute.yaml --validate。
6. 除非用户已明确选择启动自主 HyperExecute 会话，否则真实云端任务运行前请先询问。
7. 遇到故障时，下载日志／构件／报告，并使用 reference/troubleshooting.md。

操作规则

• 将官方 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、concurrency、缓存键、重试、智能排序以及矩阵／混合范围。

辅助脚本

• scripts/doctor.js：检查 CLI 是否就绪、凭据、配置文件是否存在，以及可选的官方验证。
• scripts/validate-config.js：在官方 CLI 验证前，对常见错误进行轻量级配置检查。
• scripts/build-command.js：使用环境变量引用，打印安全的验证／运行／调试／下载命令。
• scripts/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