polling-test-results について
DevOps Center の非同期テスト実行を、完了、タイムアウト、失敗のいずれかまで追跡するスキルです。テスト種別に応じて間隔と待機上限を調整し、完了結果を失敗分析スキルに渡します。
主な機能
- 01実行 ID による状態のポーリング
- 02テスト種別に応じた間隔調整
- 03完了・失敗・タイムアウトへの対応
- 04失敗分析用の結果引き継ぎ
活用シーン
- 01開始したテスト実行の監視
- 02長時間実行中のテスト完了確認
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ forcedotcom/ sf-skills --skill polling-test-resultsインストール後、Claude Code で/polling-test-resultsを入力して読み込まれたか確認します。
詳細
polling-test-results
確認が必要ですか: いいえ — ポーリングは自動的に読み取り専用で実行されます。ユーザー確認のゲートは不要です。
機能: DevOps Center の組織に対して、非同期テスト実行のステータスをポーリングし、完了、タイムアウト、または失敗するまで続けます。
前提条件
有効な runId(running-devops-test-suite スキルから返されます)と、確認済みの doce-org-alias が必要です。組織のコンテキストがまだ確立されていない場合は、最初に checking-devops-prerequisites を読み込んでください(前提条件 1~3)。
必要な入力
| 入力 | 取得元 |
|---|---|
runId | running-devops-test-suite スキルから返されます |
testType | テストスイートのテストプロバイダー(Apex、Code Analyzer、UI/Provar、Flow)から導出されます |
doce-org-alias | checking-devops-prerequisites を通じて確立されます |
ポーリング設定
| テストの種類 | ポーリング間隔 | 最大待機時間 | タイムアウト時のアクション |
|---|---|---|---|
| Apex 単体テスト | 15 秒 | 5 分 | runId を表示し、再試行を提案します |
| Code Analyzer | 10 秒 | 3 分 | runId を表示し、再試行を提案します |
| UI テスト(Provar) | 60 秒 | 20 分 | runId を表示し、保留中としてマークします |
| Flow テスト | 20 秒 | 8 分 | runId を表示し、再試行を提案します |
ポーリングクエリ
各間隔で runId によって実行レコードをクエリします。
sf data query \
--query "SELECT Id, Status, TestsRan, TestsPassed, TestsFailed, CoveragePercentage FROM DevopsTestExecution WHERE Id = '<runId>' LIMIT 1" \
--target-org <doce-org-alias> \
--json
各ポーリングで Status フィールドを確認します。
Queued/Running→ 待機して再度ポーリングしますCompleted→ 結果の分析に進みますFailed→ エラーを表示し、再試行またはスキップを提案します
タイムアウト時
runId をユーザーに表示します。
「テストの実行に予想以上の時間がかかっています。実行 ID は
<runId>です。DevOps Center でステータスを手動で確認することも、私が待機を続けることもできます。どちらにしますか?」
タイムアウト後に自動で再試行しないでください。ユーザーの指示を待ちます。
完了時
推論のため、完全な結果ペイロードを analyzing-test-failures スキルに渡します。Coverage、SuccessCount、FailureCount、QualityGateStatus をその場で表示します。生の JSON はユーザーに表示しないでください。
関連スキル
- 実行は
running-devops-test-suiteによって開始されます(再トリガーモードを含む) - 失敗の分析は
analyzing-test-failuresが処理します