hyperexecute-skill について
開発者やCI担当者向けに、HyperExecuteのテストジョブ設定と実行を案内するスキルです。プロジェクト分析、YAML作成、検証、クラウドジョブの確認、成果物を使ったトラブルシューティングを扱い、設定ファイルへの認証情報の記載を避けます。
主な機能
- 01HyperExecute CLIの分析と検証
- 02hyperexecute.yamlの作成ガイド
- 03設定の lint と準備状況チェック
- 04安全なコマンド生成
- 05ログ、レポート、成果物の調査
- 06CIとパフォーマンス調整のガイド
活用シーン
- 01HyperExecute設定の作成または修正
- 02クラウドジョブ前の設定検証
- 03成果物からテスト失敗を診断
- 04CIへの検証・実行ステップ追加
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ lambdatest/ agent-skills --skill hyperexecute-skillインストール後、Claude Code で/hyperexecute-skillを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
reference/ci-cd.mdcli.mdframeworks.mdsecurity.mdtroubleshooting.mdyaml-patterns.mdscripts/build-command.jsdoctor.jssummarize-artifacts.jsvalidate-config.js詳細
HyperExecute オペレーター
クイックスタート
- HyperExecute CLI の場所を確認します。見つからない場合は、ユーザーが自律型 HyperExecute セッションを明示的に承認していない限り、ダウンロードする前に確認します。
- CLI が利用可能な場合は
hyperexecute analyzeを実行します。利用できない場合に限り、ローカルでの調査を代替手段として使用します。 - 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。 - ユーザーが自律型 HyperExecute セッションを明示的に選択していない限り、実際のクラウドジョブを実行する前に確認します。
- 失敗した場合は、ログ/アーティファクト/レポートをダウンロードし、
reference/troubleshooting.mdを参照します。
運用ルール
- analyze、検証、実行、ログ、レポート、アーティファクトについては、公式 HyperExecute CLI を信頼できる唯一の情報源として扱います。
- ローカルの環境変数または CI シークレットから
LT_USERNAMEとLT_ACCESS_KEYを使用します。YAML やドキュメントに認証情報をハードコードしないでください。 - 追加のジョブ単位のシークレットにのみ
--job-secret-fileを使用し、できればリポジトリの外に置くか、.gitignore/.hyperexecuteignoreで除外します。 - テストコマンド、パス、ペイロードの境界はプロジェクト固有であるため、ジェネレータースクリプトよりもテンプレートを利用した YAML を優先します。
- 安全なローカルチェックは自動的に実行します。ユーザーが自律モードを選択していない限り、実際の HyperExecute クラウドジョブは確認後にのみ実行します。
- 自律モードでは、まず検証してから実行し、出力を確認します。有用な場合はログ/アーティファクトをダウンロードし、対処可能な設定/環境の修正に限って再試行します。
ワークフロー
- 初回実行:プロジェクトを分析し、YAML を作成して、ヘルパーチェックを実行し、CLI で検証してから、クラウドジョブの実行について確認を求めます。
- デバッグ:失敗した CLI コマンドを再現し、必要に応じて
--verboseを追加して、ログ/アーティファクト/レポートをダウンロードし、原因を一つずつ修正します。 - CI:CI シークレットを使用し、実行前に検証ステージを追加し、ログを簡潔にするため
CI=trueを設定します。失敗したジョブについても、ダウンロードしたアーティファクトを利用できるようにします。 - パフォーマンス:1 回正常に実行できた後で、
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
コメント
Markdown 対応