sf-integration: Salesforce インテグレーション パターン エキスパート

このスキルは、ユーザーが インテグレーション アーキテクチャとランタイム プラミング を必要とする場合に使用してください: Named Credentials、External Credentials、External Services、REST/SOAP コールアウト パターン、Platform Events、CDC、およびイベント駆動型インテグレーション設計。

このスキルがタスクを担当する場合

以下の作業に関わる場合は sf-integration を使用してください:

• .namedCredential-meta.xml または External Credential メタデータ
• アウトバウンド REST/SOAP コールアウト
• OpenAPI スペックからの External Service 登録
• Platform Events、CDC、およびイベント駆動型アーキテクチャ
• 同期 vs 非同期インテグレーション パターンの選択

以下の場合は他のスキルに委譲してください:

• OAuth アプリ自体を設定している → sf-connected-apps
• Apex のみのビジネス ロジックを作成している → sf-apex
• メタデータをデプロイしている → sf-deploy
• データをインポート/エクスポートしている → sf-data

---

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

以下を確認またはヒントから推測してください:

• インテグレーション スタイル: アウトバウンド コールアウト、インバウンド イベント、External Service、CDC、platform event
• 認証方法
• 同期 vs 非同期の要件
• システム エンドポイント / スペックの詳細
• レート制限、再試行の予想、失敗時の許容度
• これが新規設計か既存インテグレーションの修復か

---

推奨ワークフロー

1. インテグレーション パターンを選択する

要件	デフォルト パターン
認証されたアウトバウンド API 呼び出し	Named Credential / External Credential + Apex または Flow
スペック駆動型 API クライアント	External Service
トリガー起動型コールアウト	非同期コールアウト パターン
疎結合イベント公開	Platform Events
変更ストリーム消費	CDC

2. 認証モデルを選択する

セキュアなランタイム管理認証を優先してください:

• Named Credentials / External Credentials
• 正しいクレデンシャル モデル経由の OAuth または JWT
• コードにハードコードされたシークレットなし

3. 適切なテンプレートから生成する

以下のアセットを使用してください:

• assets/named-credentials/
• assets/external-credentials/
• assets/external-services/
• assets/callouts/
• assets/platform-events/
• assets/cdc/
• assets/soap/

4. 運用上の安全性を検証する

以下をチェックしてください:

• タイムアウトと再試行処理
• トリガー起動型作業の非同期戦略
• ログ出力 / 可観測性
• イベント保持とサブスクライバーの影響

5. デプロイメントまたは実装の詳細を引き継ぐ

以下を使用してください:

• sf-deploy デプロイメント用
• sf-apex より深いサービス / 再試行コード用
• sf-flow 宣言的 HTTP コールアウト オーケストレーション用

---

高シグナル ルール

• クレデンシャルをハードコードしない
• トリガーから同期コールアウトを実行しない
• タイムアウト動作を明示的に定義する
• 一時的な障害に対する再試行を計画する
• アウトバウンド ボリュームが多い場合はミドルウェア / イベント駆動型パターンを使用する
• サポートされている場合は、新規開発には External Credentials アーキテクチャを優先する

一般的なアンチパターン:

• 同期トリガー コールアウト
• 再試行またはデッドレター戦略なし
• リクエスト/レスポンス ログなし
• 認証セットアップ責任とランタイム インテグレーション設計の混在

---

出力形式

完了時に、以下の順序でレポートしてください:

1. 選択されたインテグレーション パターン
2. 選択された認証モデル
3. 作成または更新されたファイル
4. 運用上のセーフガード
5. デプロイメント / テスト次のステップ

推奨される形式:

Integration: <summary>
Pattern: <named credential / external service / event / cdc / callout>
Files: <paths>
Safety: <timeouts, retries, async, logging>
Next step: <deploy, register, test, or implement>

---

クロススキル インテグレーション

要件	委譲先	理由
OAuth アプリ セットアップ	sf-connected-apps	consumer key / cert / アプリ設定
高度なコールアウト サービス コード	sf-apex	Apex 実装
宣言的 HTTP コールアウト / Flow ラッパー	sf-flow	Flow オーケストレーション
インテグレーション メタデータをデプロイ	sf-deploy	検証とロールアウト
Agentforce からインテグレーションを使用	sf-ai-agentscript	エージェント アクション構成

---

リファレンス マップ

ここから開始

• references/named-credentials-guide.md
• references/external-services-guide.md
• references/callout-patterns.md
• references/security-best-practices.md

イベント駆動型 / プラットフォーム パターン

• references/event-patterns.md
• references/platform-events-guide.md
• references/cdc-guide.md
• references/event-driven-architecture-guide.md
• references/messaging-api-v2.md

CLI / オートメーション / スコアリング

• references/cli-reference.md
• references/named-credentials-automation.md
• references/scoring-rubric.md
• assets/

---

スコア ガイド

スコア	意味
108+	強力な本番運用対応インテグレーション設計
90–107	良好な設計だが強化が必要な部分あり
72–89	実用的だがアーキテクチャ レビュー必要
< 72	デプロイメント用に安全/不完全