dx-devops-test-pipeline-configure について
Salesforce DevOps Center のパイプラインでテスト基盤を設定するスキルです。プロバイダーの設定、構成済みプロバイダーの同期、ステージの品質ゲートを区別し、組織への変更前に確認を求めます。
主な機能
- 01テストプロバイダーの設定
- 02構成済みプロバイダーの同期
- 03ステージ品質ゲートの設定
- 04組織の前提条件の確認
- 05書き込み前の確認必須化
活用シーン
- 01利用可能なテストプロバイダーのパイプラインへの追加
- 02構成済みプロバイダーからのテストスイート更新
- 03ステージのカバレッジしきい値設定
- 04前提条件と承認前の書き込み防止
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/dx-devops-test-pipeline-configureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/configuring-quality-gate.mdconfiguring-test-provider.mderror-handling.mdgotchas.mdprerequisite-checks.mdsyncing-test-providers.md詳細
DevOps Center パイプラインのテストインフラストラクチャを構成する
DevOps Center パイプラインのテストインフラストラクチャをセットアップして構成します。このスキルでは、同じ組織コンテキスト、前提条件、エンティティの範囲（パイプラインレベル）を共有する、密接に関連した 3 つの「パイプラインを構成する」操作を扱います。ユーザーの意図に合ったモードを選択してください。
API バージョン： DevOps テスト関連のシステム呼び出しは、すべて Salesforce API v67.0（最低要件）を対象とします。
重要： DevOps Center のデータ（パイプライン、ステージ、プロバイダー、スイート、ゲート）は Salesforce 組織内にあります。ローカルリポジトリにはありません。パイプラインの構成をファイルシステムから検索しないでください。必ず sf data query または sf api request rest で組織に問い合わせてください。
ステップ 1 — 必ず最初に前提条件を確認する
クエリやシステム呼び出しを行う前に、references/prerequisite-checks.md に記載された前提条件の確認を実行してください。確認に失敗した場合は、平易な言葉でメッセージを伝えて停止してください。検証されていない環境に書き込みを行ってはいけません。
- モード A と B（プロバイダーの構成／同期）： 前提条件 1～4（組織へのログイン、Agentforce DX プラグイン、DevOps Center 組織の認証、パイプラインの特定）を確認してください。前提条件 5（ステージ）は不要です。プロバイダーはパイプラインレベルで構成されるためです。
- モード C（品質ゲート）： 前提条件 1～4 および 前提条件 5（ステージ）を確認してください。前提条件 5 で取得できるのは
DevopsPipelineStageのみです。対象のDevopsTestSuiteStageレコード Id は、モード C のステップ 0 で別途（トリガー → スイートステージの行）解決します。
解決済みの doce-org-alias、pipelineId、および（モード C の場合）stageId / testSuiteStageId を引き継いでください。
ステップ 2 — モードを選択する
| ユーザーの目的 | モード | 参照先 |
|---|---|---|
| 未構成のプロバイダーを有効化／セットアップ／追加する | A — テストプロバイダーを構成する | references/configuring-test-provider.md |
| 構成済みのプロバイダーを再同期／更新して、新しいスイートを取り込む | B — 構成済みプロバイダーを同期する | references/syncing-test-providers.md |
| ステージに品質ゲート、カバレッジのしきい値、またはテストのベンチマークを設定／構成する | C — 品質ゲートを構成する | references/configuring-quality-gate.md |
A と B の判別（重要な判断）： まず、パイプラインのプロバイダーを取得します（GET .../testProviders?status=all）。どちらのモードもここから始まります。次に、以下のように判別します。
- プロバイダーが Available（未構成）の場合 → モード A（構成）。
- プロバイダーが Configured で、スイートが古い、または不足している場合 → モード B（同期）。
- プロバイダーが Configured で、ステージへの割り当て時にスイートが表示されない場合 → これはステージ割り当ての不足であり、構成の不足ではありません。
dx-devops-test-suite-assignments-configureに案内してください。
構成済みプロバイダーに対して、構成エンドポイントへ POST してはいけません。 DevopsPipelineTestProvider レコードが重複して作成されます。references/gotchas.md を参照してください。
ステップ 3 — 確認ゲート（すべてのモードで必須）
どのモードも組織の状態を変更するため、書き込みを行う前に必ず確認ゲートを提示する必要があります。各モードの参照ファイルに、確認ゲートの正確な文言が記載されています（モード C では、ゲートの前に影響のプレビューも必須です）。ユーザーが肯定的に応答するまで、書き込み API を呼び出してはいけません。ユーザーが拒否した場合は、書き込みを行わずに停止してください。
ステップ 4 — 実行して結果を報告する
正確な API 呼び出し、成功メッセージ、エラー処理については、選択した参照ファイルに従ってください。
references/configuring-test-provider.md— モード Areferences/syncing-test-providers.md— モード Breferences/configuring-quality-gate.md— モード Creferences/error-handling.md— すべてのモードを対象とする、ステータスコードから平易な説明への対応表references/gotchas.md— プロバイダー重複の注意点、API 名の違い、トリガータイプのルール
生の API エラー、スタックトレース、JSON ペイロードをユーザーに見せてはいけません。必ず平易な言葉で説明してください。
関連スキル
dx-devops-test-suite-assignments-configure— プロバイダーを設定／同期した後、そのスイートをステージに割り当てるかマッピングします。また、コミットに対して実行するスイートを推奨します。dx-devops-test-suite-run— スイートを実行するか、修正によってしきい値を満たした後に品質ゲートを再実行します。dx-devops-test-failures-analyze— 実行結果の失敗を説明し、必要に応じて修正用の作業項目を作成します。