dx-devops-test-suite-assignments-configure について
Salesforce DevOps Center のテストスイートを推薦し、パイプラインステージへの割り当てを管理するスキルです。読み取り専用の推薦と、明示的な確認が必要な変更を分けて扱います。
主な機能
- 01変更内容に合うスイートの推薦
- 02単一スイートのステージ割り当て
- 03複数スイートのステージへのマッピング
- 04割り当て内のテストクラスの追加・削除
- 05割り当て変更前の承認確認
活用シーン
- 01コミットや差分に関連するスイートの特定
- 02未割り当てスイートのステージへの追加
- 03ステージのテスト方針に沿ったマッピング
- 04割り当て済みテストクラスの更新
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/dx-devops-test-suite-assignments-configureを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api-endpoint.mderror-handling.mdprerequisite-checks.mdrecommendation-logic.mdsuite-assignment-modes.md詳細
DevOps Center スイート割り当てを構成する
変更に対して実行すべき既存のテストスイートを推奨し、スイートの割り当て方法とパイプラインステージへのマッピングを管理します。これらの操作は同じスイート・ステージメタデータを共有します。推奨では関連するスイートが提示され、不足があればフラグが付けられ、その不足を解消するために割り当てへ進みます。
API バージョン： DevOps テストシステムのすべての呼び出しは、Salesforce API v67.0（必要な最小バージョン）を対象とします。
重要： DevOps Center のデータはすべて Salesforce 組織内にあります。ローカルリポジトリにはありません。スイートの構成をファイルシステムから検索しないでください。必ず sf data query または sf api request rest を使用して組織をクエリしてください。
ステップ 1 — まず前提条件を確認する（常に実行）
クエリやシステム呼び出しを行う前に、references/prerequisite-checks.md に記載された前提条件のチェックを実行してください。いずれかのチェックに失敗した場合は、平易な言葉でメッセージを伝え、処理を停止してください。
- モード A（推奨）： 前提条件 1～4（組織へのログイン、プラグイン、DevOps Center 組織認証、パイプラインの特定）。ステージは不要です。推奨ではパイプラインレベルの Review トリガーを読み取ります。
- モード B～D（割り当て／マッピング／クラス）： 前提条件 1～4 および 前提条件 5（ステージ）。
doce-org-alias、pipelineId、stageIdが必要です。
ステップ 2 — モードを選択する
| ユーザーの要望 | モード | 参照先 |
|---|---|---|
| コミット／差分に対して 実行すべきスイート、または変更をカバーするものを知りたい | A — スイートを推奨 | references/recommendation-logic.md |
| ステージに 1 つのスイートを単発で割り当てたい | B — 単一のスイートを割り当て | references/suite-assignment-modes.md |
| テスト戦略として複数のスイートをステージに 一括マッピングしたい | C — 複数のスイートをマッピング | references/suite-assignment-modes.md |
| スイートの割り当て内の個別テストクラスを 追加／削除したい | D — クラスを追加／削除 | references/suite-assignment-modes.md |
モード A は推論のみで、書き込みは行いません。モード B～D は、同じ testSuiteStages エンドポイントを使って組織の状態を変更します（references/api-endpoint.md）。
A から B～D への連携： 推奨で関連スイートにフラグが付いたものの、そのスイートがステージに 割り当てられていない 場合、その不足をモード B／C への入力として使用します。スイートでカバーされていない新しいメソッドにフラグが付いた場合は、開発者にテストを手動で作成するよう案内してください（v1 の制約により、ここでテストの生成を提案してはいけません）。
ステップ 3 — ガバナンスと確認（モード B～D）
モード B～D では、書き込みを行う前に必ず確認を取ってください。
- モード B — スイート、ステージ、イベント名を明示した単一の確認プロンプト。
- モード C — 確認に進む前に、必須の影響プレビュー表（スイート／ステージ／イベント／アクション）を提示します。
- モード D — 確認前に最終的なテストリストを再提示します。拒否されたテストはペイロードから除外してください。 レビュー中にテストが変更された場合は、確認を求める前に最終リストを再提示してください。明示的な承認なしに呼び出してはいけません。
ユーザーから肯定的な応答を得るまで API を呼び出さないでください。ユーザーが拒否した場合は、書き込みを行わずに停止してください。各確認の詳しい文言は references/suite-assignment-modes.md に記載されています。
モード A（推奨）は書き込みを行わないため、確認は不要です。
ステップ 4 — 実行して結果を報告する
選択した参照ファイルに従ってください。
references/recommendation-logic.md— モード A：差分の分類、プロバイダーの照合、順位付け、不足へのフラグ付け、出力形式。references/suite-assignment-modes.md— モード B～D：入力、確認時の文言、成功メッセージ。references/api-endpoint.md— 共通のtestSuiteStagesPOST ペイロードのスキーマ（モード B～D）。references/error-handling.md— ステータスコードから平易な言葉への対応表。
未加工の API エラー、スタックトレース、JSON をユーザーに見せてはいけません。
関連スキル
dx-devops-test-pipeline-configure— 割り当てたいテストスイートがまだ表示されない場合は、プロバイダーを設定または再同期します。また、マッピング後にステージの品質ゲートを設定します。dx-devops-test-suite-run— ステージで推奨または割り当て済みのテストスイートを実行します。dx-devops-test-failures-analyze— テストスイート内のテストについて、失敗と改善案を分析します。