sf-integration: Salesforce 集成模式专家

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

此技能适用的场景

当工作涉及以下内容时，使用 sf-integration：

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

当用户处于以下情况时，委托给其他技能：

• 配置 OAuth 应用本身 → sf-connected-apps
• 编写仅限 Apex 的业务逻辑 → sf-apex
• 部署元数据 → sf-deploy
• 导入/导出数据 → sf-data

需要预先收集的上下文

询问或推断：

• 集成风格：出站调用、入站事件、外部服务、CDC、平台事件
• 认证方法
• 同步与异步需求
• 系统端点/规范详情
• 速率限制、重试期望和故障容错
• 这是全新设计还是修复现有集成

推荐工作流程

1. 选择集成模式

2. 选择认证模型

优先选择安全的运行时托管认证：

• 命名凭证/外部凭证
• 通过适当凭证模型的 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 调用编排

高质量规则

• 切勿硬编码凭证
• 不要在触发器中进行同步调用
• 明确定义超时行为
• 为临时故障计划重试
• 当出站量高时，使用中间件/事件驱动模式
• 在支持的情况下，新开发优先选择外部凭证架构

常见反模式：

• 同步触发器调用
• 无重试或死信策略
• 无请求/响应日志记录
• 将认证设置职责与运行时集成设计混为一谈

输出格式

完成时，按此顺序报告：

1. 选择的集成模式
2. 选择的认证模型
3. 创建或更新的文件
4. 操作安全保障
5. 部署/测试下一步

建议格式：

集成：<摘要>
模式：<命名凭证 / 外部服务 / 事件 / cdc / 调用>
文件：<路径>
安全保障：<超时、重试、异步、日志记录>
下一步：<部署、注册、测试或实施>

跨技能集成

参考映射

从这里开始

• 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/

评分指南