sf-deploy: 包括的な Salesforce DevOps 自動化

このスキルを使用するのは、ユーザーがデプロイメント オーケストレーションを必要とする場合です: ドライラン検証、ターゲット指定またはマニフェストベースのデプロイ、CI/CD ワークフロー アドバイス、スクラッチ org 管理、障害の分類、Salesforce メタデータの安全なロールアウト シーケンシング。

このスキルがタスクを所有する場合

以下の作業が含まれる場合は sf-deploy を使用してください:

• sf project deploy start、quick、report、またはリトリーバル ワークフロー
• オブジェクト、権限セット、Apex、Flow 全体のリリース シーケンシング
• CI/CD ゲート、テストレベル選択、またはデプロイメント レポート
• デプロイメント障害と依存関係の順序付けのトラブルシューティング

ユーザーが以下を行う場合は他にデリゲートしてください:

• Apex または LWC コードを記述している → sf-apex, sf-lwc
• メタデータ定義を作成している → sf-metadata
• Flow を構築している → sf-flow
• org データ操作を実行している → sf-data
• Agent Script ロジックを記述している → sf-ai-agentscript

---

重要な運用ルール

• sf CLI v2 のみを使用してください。
• ソーストラッキングなし org では、デプロイ/リトリーバル コマンドが --source-dir、--metadata、または --manifest などの明示的なスコープを必要とします。
• 実際のデプロイの前に**--dry-run を優先**してください。
• Flow の場合、安全にデプロイして検証後のみアクティベートしてください。
• テストデータ作成ガイダンスは、メタデータが検証またはデプロイされた後に sf-data にデリゲートしてください。

デフォルトのデプロイメント順序

フェーズ	メタデータ
1	カスタムオブジェクト / フィールド
2	権限セット
3	Apex
4	Draft としての Flow
5	Flow アクティベーション / 検証後

この順序付けは、多くの依存関係と FLS 障害を防ぎます。

---

最初に収集すべき必須コンテキスト

以下を確認または推測してください:

• ターゲット org エイリアスと環境タイプ
• デプロイメント スコープ: source-dir、メタデータ リスト、またはマニフェスト
• これが検証のみ、デプロイ、クイックデプロイ、リトリーバル、または CI/CD ガイダンスかどうか
• 必要なテストレベルとロールバック期待値
• 特殊なメタデータタイプが関係しているかどうか (Flow、権限セット、エージェント、パッケージ)

プリフライト チェック:

sf --version
sf org list
sf org display --target-org <alias> --json
test -f sfdx-project.json

---

推奨されるワークフロー

1. プリフライト

認証、リポジトリ構造、パッケージ ディレクトリ、およびターゲット スコープを確認してください。

2. まず検証する

sf project deploy start --dry-run --source-dir force-app --target-org <alias> --wait 30 --json

変更セットがターゲット指定されている場合は、マニフェスト またはメタデータスコープの検証を使用してください。

3. 検証が成功した場合、次の安全なワークフローを提案する

検証が成功した後、ユーザーを正しい次のアクションにガイドしてください:

1. すぐにデプロイ
2. 権限セットを割り当て
3. sf-data 経由でテストデータを作成
4. テスト / スモークテストを実行
5. 複数のデプロイ後ステップを順序付けてオーケストレート

4. 最小限の正しいスコープをデプロイする

# source-dir デプロイ
sf project deploy start --source-dir force-app --target-org <alias> --wait 30 --json

# マニフェスト デプロイ
sf project deploy start --manifest manifest/package.xml --target-org <alias> --test-level RunLocalTests --wait 30 --json

# Spring '26 関連テスト選択を含むマニフェスト デプロイ
sf project deploy start --manifest manifest/package.xml --target-org <alias> --test-level RunRelevantTests --wait 30 --json

# 検証に成功した後のクイックデプロイ
sf project deploy quick --job-id <validation-job-id> --target-org <alias> --json

5. 検証する

sf project deploy report --job-id <job-id> --target-org <alias> --json

その後、テスト、Flow の状態、権限割り当て、およびスモークテスト動作を検証してください。

6. 明確に報告する

デプロイされたもの、失敗したもの、スキップされたもの、および次の安全なアクションを要約してください。

出力テンプレート: references/deployment-report-template.md

---

高シグナル障害パターン

エラー / 症状	可能性の高い原因	デフォルト修正方向
FIELD_CUSTOM_VALIDATION_EXCEPTION	検証ルールまたは不適切なテストデータ	データまたはルール タイミングを調整
INVALID_CROSS_REFERENCE_KEY	不足している依存関係	参照メタデータを最初に含める
CANNOT_INSERT_UPDATE_ACTIVATE_ENTITY	トリガー / Flow / 検証 副作用	自動化スタックと失敗ロジックを検査
デプロイ中にテストが失敗	不具合のあるコードまたは脆弱なテスト	ターゲット指定されたテストを実行、根本原因を修正、再検証
権限セットでフィールド/オブジェクトが見つからない	順序が間違っている	オブジェクト/フィールドを権限セットの前にデプロイ
Flow が無効 / バージョン競合	依存関係またはアクティベーション問題	Draft としてデプロイ、検証、次にアクティベート

完全なワークフロー: references/orchestration.md, references/trigger-deployment-safety.md

---

CI/CD ガイダンス

デフォルト パイプライン形状:

1. 認証
2. リポジトリ / org 状態を検証
3. 静的分析
4. ドライランデプロイ
5. テスト + カバレッジ ゲート
6. デプロイ
7. 検証 + 通知

• org ポリシーとリリース リスクがそれを許可する場合、Apex 重点デプロイメントに --test-level RunRelevantTests の使用を検討してください。
• これを sf-apex に記載されている @IsTest(testFor=...) および @IsTest(isCritical=true) などの最新 Apex テスト アノテーションと組み合わせてください。

静的分析は現在 Code Analyzer v5 (sf code-analyzer) を使用します。廃止された sf scanner ではなく。

深いリファレンス: references/deployment-workflows.md

---

Agentforce デプロイメント ノート

このスキルを使用して、エージェントの周囲でデプロイメント/パブリッシング シーケンシングをオーケストレートしてください。ただし、オーサリング決定については、エージェント固有のスキルを使用してください:

• sf-ai-agentscript .agent オーサリングと検証用
• sf-ai-agentforce Agent Builder / Prompt Builder / メタデータ設定用

エージェント DevOps の詳細 (Agent: 疑似メタデータ、パブリッシュ/アクティベート、org 間の同期を含む) については、以下を参照してください:

• references/agent-deployment-guide.md

---

クロススキル統合

必要なもの	デリゲート先	理由
カスタム オブジェクト / フィールド作成	sf-metadata	デプロイ前にメタデータを定義
Apex コンパイル / レビュー / 修正	sf-apex	コード オーサリングと修復
Flow 作成 / 修復	sf-flow	Flow オーサリングとアクティベーション ガイダンス
テストデータまたはシードレコード	sf-data	describe-first データ設定とクリーンアップ
Agent Script ビルド/パブリッシュ準備状態	sf-ai-agentscript	エージェント固有の正確性

---

リファレンス マップ

ここから開始

• references/orchestration.md
• references/deployment-workflows.md
• references/deployment-report-template.md

特殊なデプロイメント セーフティ

• references/trigger-deployment-safety.md
• references/agent-deployment-guide.md
• references/deploy.sh

---

スコア ガイド

スコア	意味
90+	強力なデプロイメント計画と実行ガイダンス
75–89	マイナー レビュー項目付きの優れたデプロイ ガイダンス
60–74	デプロイメント リスクの部分的なカバレッジ
< 60	信頼度が不十分; ロールアウト前に計画を厳密化

---

完了形式

デプロイメント目標: <検証 / デプロイ / リトリーバル / パイプライン>
ターゲット org: <エイリアス>
スコープ: <source-dir / メタデータ / マニフェスト>
結果: <成功 / 失敗 / 部分>
重要な検出事項: <エラー、順序付け、テスト、スキップされたアイテム>
次のステップ: <安全なフォローアップ アクション>