mcpField
S
sf-integration

sf-integration

github.com/jaganpro開発4241.4k 回インストール26 週間前に更新
リポジトリ

sf-integration について

sf-integration は、Salesforce の連携アーキテクチャと実行パターンを設計するスキルです。認証情報、API コールアウト、イベント駆動方式に加え、再試行やタイムアウトなどの運用面も扱います。

主な機能

  1. 01同期・非同期パターンの選択
  2. 02REST・SOAP コールアウトの設計
  3. 03認証情報アーキテクチャの検討
  4. 04Platform Events と CDC の活用
  5. 05再試行・タイムアウト・ログの確認

活用シーン

  1. 01認証付き外部 API 呼び出しの設計
  2. 02OpenAPI 仕様からの API 登録
  3. 03イベント駆動の変更ストリーム選定

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/jaganpro/sf-skills --skill sf-integration

インストール後、Claude Code で/sf-integrationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

CREDITS.md
README.md
assets/callouts/
callout-retry-handler.cls
http-response-handler.cls
rest-queueable-callout.cls
rest-sync-callout.cls
assets/cdc/
cdc-handler.cls
cdc-subscriber-trigger.trigger
assets/endpoint-security/
example.cspTrustedSite-meta.xml
example.remoteSite-meta.xml
assets/external-credentials/
jwt-external-credential.externalCredential-meta.xml
oauth-external-credential.externalCredential-meta.xml
assets/external-services/
external-service-operations.md
openapi-registration.externalServiceRegistration-meta.xml
assets/named-credentials/
certificate-auth.namedCredential-meta.xml
custom-auth.namedCredential-meta.xml
oauth-client-credentials.namedCredential-meta.xml
oauth-jwt-bearer.namedCredential-meta.xml
assets/platform-events/
event-publisher.cls
event-subscriber-action.cls
event-subscriber-trigger.trigger
platform-event-definition.object-meta.xml
assets/soap/
soap-callout-service.cls
wsdl2apex-guide.md
hooks/scripts/
suggest_credential_setup.py
validate_integration.py
references/
callout-patterns.md
cdc-guide.md
cli-reference.md
event-driven-architecture-guide.md

詳細

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、イベント駆動型アーキテクチャ
  • 同期と非同期の統合パターンの選択

次の場合は、ほかのスキルに委任します。

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

事前に収集する必要があるコンテキスト

次の情報を確認するか、推測します。

  • 統合方式：アウトバウンドコールアウト、インバウンドイベント、External Service、CDC、プラットフォームイベント
  • 認証方式
  • 同期／非同期の要件
  • システムのエンドポイント／仕様の詳細
  • レート制限、再試行の要件、障害許容度
  • 新規設計か既存の統合の修復か

推奨ワークフロー

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
  • 宣言型 HTTP コールアウトのオーケストレーションには sf-flow

重要度の高いルール

  • 認証情報をハードコードしない
  • トリガーから同期コールアウトを実行しない
  • タイムアウト時の動作を明示的に定義する
  • 一時的な障害に備えて再試行を計画する
  • アウトバウンドの量が多い場合は、ミドルウェア／イベント駆動型パターンを使用する
  • 新規開発では、サポートされている場合は 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コンシューマーキー／証明書／アプリ設定
高度なコールアウトサービスコードsf-apexApex の実装
宣言型 HTTP コールアウト／Flow ラッパーsf-flowFlow のオーケストレーション
統合メタデータのデプロイsf-deploy検証と展開
Agentforce から統合を使用sf-ai-agentscriptエージェントアクションの構成

リファレンスマップ

まずはこちら
イベント駆動型／プラットフォームのパターン
CLI／自動化／スコアリング

スコアガイド

スコア意味
108+本番環境に対応できる、堅牢な統合設計
90–107良好な設計ですが、さらに強化が必要です
72–89実用可能ですが、アーキテクチャのレビューが必要です
< 72デプロイには安全性または完全性が不十分です

コメント

Markdown 対応