integration-connectivity-generate

integration-connectivity-generate：Salesforce 統合パターンのエキスパート

ユーザーが統合アーキテクチャと実行時の接続設定を必要としている場合に、このスキルを使用します。対象には、名前付きクレデンシャル、外部クレデンシャル、外部サービス、REST／SOAP コールアウトのパターン、Platform Events、CDC、イベント駆動型統合の設計が含まれます。

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

次の作業では、integration-connectivity-generate を使用します。

• .namedCredential-meta.xml または外部クレデンシャルのメタデータ
• アウトバウンド REST／SOAP コールアウト
• OpenAPI 仕様からの外部サービスの登録
• Platform Events、CDC、イベント駆動型アーキテクチャ
• 同期と非同期の統合パターンの選択

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

• OAuth アプリ自体を設定する → integration-connectivity-connected-app-configure
• Apex のみのビジネスロジックを作成する → platform-apex-generate スキル
• メタデータをデプロイする → platform-metadata-deploy スキル
• データをインポート／エクスポートする → platform-data-manage スキル

---

まず確認する必要があるコンテキスト

次の内容を確認するか、推測します。

• 統合スタイル：アウトバウンドコールアウト、インバウンドイベント、外部サービス、CDC、Platform Event
• 認証方法
• 同期／非同期の要件
• システムのエンドポイント／仕様の詳細
• レート制限、リトライの要件、障害許容度
• 新規設計か、既存の統合の修正か

---

推奨ワークフロー

1. 統合パターンを選択する

要件	デフォルトのパターン
認証付きアウトバウンド API 呼び出し	名前付きクレデンシャル／外部クレデンシャル + Apex または Flow
仕様駆動型 API クライアント	外部サービス
トリガー起点のコールアウト	非同期コールアウトパターン
疎結合なイベント発行	Platform Events
変更ストリームの利用	CDC

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

セキュアな実行時管理認証を優先します。

• 名前付きクレデンシャル／外部クレデンシャル
• 適切なクレデンシャルモデルを使った OAuth または JWT
• コードにシークレットをハードコードしない

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

次の場所にある提供済みアセットを使用します。

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

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

次を確認します。

• タイムアウトとリトライの処理
• トリガー起点の処理に対する非同期戦略
• ログ記録／可観測性
• イベントの保持とサブスクライバーへの影響

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

次を使用します。

• デプロイには platform-metadata-deploy スキル
• サービス／リトライのコードをさらに詳しく作成するには platform-apex-generate スキル
• 宣言型 HTTP コールアウトのオーケストレーションには automation-flow-generate スキル

---

重要なルール

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

よくあるアンチパターン：

• 同期トリガーコールアウト
• リトライまたはデッドレター戦略がない
• リクエスト／レスポンスのログ記録がない
• 認証設定の責任と実行時の統合設計を混在させる

---

出力形式

完了時には、次の順で報告します。

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 アプリの設定	integration-connectivity-connected-app-configure	コンシューマーキー／証明書／アプリの設定
高度なコールアウトサービスのコード	platform-apex-generate スキル	Apex の実装
宣言型 HTTP コールアウト／Flow ラッパー	automation-flow-generate スキル	Flow のオーケストレーション
インテグレーションのメタデータをデプロイ	platform-metadata-deploy スキル	検証とロールアウト
Agentforce からインテグレーションを使用	agentforce-generate スキル	エージェントアクションの構成

---

リファレンスマップ

まずはこちら

• references/named-credentials-guide.md
• references/external-services-guide.md
• references/callout-patterns.md
• references/rest-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
• scripts/README.md — 自動化スクリプトの概要（configure-named-credential.sh、set-api-credential.sh）

アセットテンプレート

• assets/named-credentials/ — Named Credential XML テンプレート（OAuth、JWT、証明書、カスタム認証）
• assets/external-credentials/ — External Credential XML テンプレート（OAuth、JWT）
• assets/external-services/ — External Service 登録テンプレートと操作ガイド
• assets/callouts/ — REST 同期、Queueable、再試行ハンドラー、HTTP レスポンスハンドラーの Apex テンプレート
• assets/platform-events/ — Platform Event の定義、発行元、サブスクライバーのテンプレート
• assets/cdc/ — CDC ハンドラーとサブスクライバートリガーのテンプレート
• assets/soap/ — SOAP コールアウトサービスのテンプレートと wsdl2apex ガイド
• assets/endpoint-security/ — Remote Site Setting と CSP Trusted Site の XML テンプレート

自動化フック

• scripts/suggest_credential_setup.py — インテグレーション関連ファイルを検出すると、認証情報の設定手順を自動で提案します
• scripts/validate_integration.py — エージェントの応答前にインテグレーションのパターンを検証します

---

出力内容

このスキルがインテグレーションタスクを完了すると、次のものを生成します。

1. 認証情報のメタデータ — 組織固有の値を設定した assets/named-credentials/ または assets/external-credentials/ 内の 1 つ以上のファイル
2. コールアウト用 Apex クラス — Named Credential パターンを使用した .cls ファイル。コンテキストに応じて非同期または同期パターンを選択します
3. イベント／CDC アーティファクト — Platform Event の .object-meta.xml、サブスクライバートリガー、または CDC 設定（イベント駆動型パターンを選択した場合）
4. エンドポイントセキュリティのメタデータ — Remote Site Setting および／または CSP Trusted Site の XML ファイル
5. スコアリングレポート — 6 つのカテゴリ（セキュリティ、エラー処理、バルク化、アーキテクチャ、ベストプラクティス、ドキュメント）にわたる 120 点満点のスコア
6. 次のステップ — 生成されたアーティファクトのデプロイ手順またはテスト手順

---

スコアガイド

スコア	意味
108+	本番環境に対応できる優れたインテグレーション設計
90–107	良好な設計。さらに強化すべき点がいくつかあります
72–89	実用可能ですが、アーキテクチャレビューが必要です
< 72	デプロイには危険、または不完全です

---

提供前チェックリスト

• 認証情報をハードコードしないこと。すべてのシークレットは Named Credentials または External Credentials に保存する