mcpField
B
building-sf-integrations

building-sf-integrations

github.com/forcedotcom开发1.1k2.9k 次安装1 天前更新
代码仓库

关于 building-sf-integrations

面向 Salesforce 集成设计的技能，涵盖运行时连接、身份验证、外呼及事件驱动模式。它协助选择和验证方案，并提供凭证、服务、Apex 外呼、Platform Events 与 CDC 模板。

主要功能

  1. 01Named 与 External Credential 模式
  2. 02REST 和 SOAP 外呼指导
  3. 03External Service 配置指导
  4. 04Platform Events 与 CDC 模式
  5. 05模板及集成验证

适用场景

  1. 01设计经过身份验证的出站 API 调用
  2. 02选择同步或异步外呼模式
  3. 03规划事件驱动集成
  4. 04准备凭证和外呼产物

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/forcedotcom/sf-skills --skill building-sf-integrations

安装后在 Claude Code 中输入/building-sf-integrations确认已加载。

包含的文件

除 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

详细介绍

building-sf-integrations：Salesforce 集成模式专家

当用户需要集成架构和运行时管道配置时使用此技能：命名凭据、外部凭据、外部服务、REST/SOAP 调用模式、平台事件、CDC 和事件驱动集成设计。

此技能负责的任务

遇到以下工作时，使用 building-sf-integrations：

  • .namedCredential-meta.xml 或外部凭据元数据
  • 出站 REST/SOAP 调用
  • 根据 OpenAPI 规范注册外部服务
  • 平台事件、CDC 和事件驱动架构
  • 选择同步或异步集成模式

以下情况请委派给其他技能：

首先收集所需上下文

询问或推断：

  • 集成方式：出站调用、入站事件、外部服务、CDC、平台事件
  • 身份验证方法
  • 同步或异步要求
  • 系统端点/规范详情
  • 速率限制、重试预期和故障容忍度
  • 这是全新设计还是修复现有集成

推荐工作流

1. 选择集成模式
需求默认模式
需要身份验证的出站 API 调用命名凭据 / 外部凭据 + Apex 或 Flow
由规范驱动的 API 客户端外部服务
由触发器发起的调用异步调用模式
解耦式事件发布平台事件
消费变更流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. 移交部署或实现细节

使用：

高优先级规则

  • 绝不硬编码凭据
  • 不要在触发器中执行同步调用
  • 明确设定超时行为
  • 为瞬时故障规划重试
  • 出站流量较大时，使用中间件/事件驱动模式
  • 在支持的情况下，新开发优先采用外部凭据架构

常见反模式：

  • 触发器中的同步调用
  • 没有重试或死信策略
  • 没有请求/响应日志
  • 将身份验证配置职责与运行时集成设计混为一谈

输出格式

完成时，按以下顺序报告：

  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 应用设置configuring-connected-apps消费者密钥 / 证书 / 应用配置
高级 Callout 服务代码generating-apexApex 实现
声明式 HTTP Callout / Flow 封装generating-flowFlow 编排
部署集成元数据deploying-metadata验证与发布
在 Agentforce 中使用集成developing-agentforceAgent 操作组合

参考资料索引

从这里开始
事件驱动 / 平台模式
CLI / 自动化 / 评分
资源模板
  • assets/named-credentials/ — Named Credential XML 模板（OAuth、JWT、Certificate、Custom auth）
  • 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 Callout 服务模板和 wsdl2apex 指南
  • assets/endpoint-security/ — Remote Site Setting 和 CSP Trusted Site XML 模板
自动化钩子
  • hooks/scripts/suggest_credential_setup.py — 检测到集成文件时自动建议凭证配置步骤
  • hooks/scripts/validate_integration.py — 在 Agent 回复前验证集成模式

输出要求

此技能完成集成任务后，会生成：

  1. 凭证元数据 — 在 assets/named-credentials/ 或 assets/external-credentials/ 中填入组织专属值的一个或多个文件
  2. Callout 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不安全 / 不完整，不适合部署

评论

支持 Markdown