用途:作为构建 Salesforce 原生 iOS/Android 应用的入口,把用户导向合适的 SDK 子技能。本技能本身不实现功能,场景识别与分步说明由子技能负责。
主要能力:在两个维度上消歧——SDK 家族(Mobile SDK 与 Agentforce SDK)与平台(iOS 与 Android)。两者并不互斥,一个应用可同时使用。若用户意图可能同时映射到两种 SDK,应先询问再路由,避免猜错浪费时间。
路由规则:需要终端用户认证 Salesforce、同步记录(MobileSync)、离线存储(SmartStore)、生物识别登录、推送通知、REST 集成时选 Mobile SDK;以嵌入 Agentforce 智能体、聊天 UI、对话为主要界面时选 Agentforce SDK;两者都需要时先 Mobile SDK 再叠加 Agentforce SDK。判断依据:智能体是主界面还是数据驱动应用中的一项功能;终端用户是否需认证进入 Salesforce 数据(是则必须用 Mobile SDK,否则 Agentforce SDK 可能足够,它使用访客认证);涉及离线存储、同步、REST、推送、生物识别选 Mobile SDK;涉及智能体对话、聊天 UI、流式响应选 Agentforce SDK。仍不明确时直接询问用户。
平台路由:iOS(Swift)对应 ios-mobile-sdk 与 integrate-agentforce-ios;Android(Kotlin)对应 android-mobile-sdk 与 integrate-agentforce-android。需要双平台时分别路由到各子技能,二者相互独立。
组合流程:先路由到 Mobile SDK 平台技能完成脚手架与认证,再路由到 Agentforce SDK 平台技能叠加智能体界面。各子技能说明对其 SDK 具有权威性,不要合并步骤;每个 SDK 有自己的认证设置、依赖安装顺序与初始化顺序,交错会产生冲突配置和错误的初始化顺序。此顺序逻辑是本技能唯一拥有的多技能逻辑。
加载子技能:通过 harness 按名称调用子技能。若本地不可用,提示用户用 npx skills add <repo> 安装;用户确认或已预授权安装时运行命令并加载子技能。若用户拒绝,则停止并说明子技能负责该 SDK 的设置步骤,缺少它无法继续。安装命令:ios-mobile-sdk 用 npx --yes skills add forcedotcom/SalesforceMobileSDK-Templates --skill ios-mobile-sdk --yes;android-mobile-sdk 用 npx --yes skills add forcedotcom/SalesforceMobileSDK-Templates --skill android-mobile-sdk --yes;integrate-agentforce-ios 用 npx --yes skills add salesforce/AgentforceMobileSDK-iOS --skill integrate-agentforce-ios --yes;integrate-agentforce-android 用 npx --yes skills add salesforce/AgentforceMobileSDK-Android --skill integrate-agentforce-android --yes。安装后加载子技能并交由它接管,不要内联子技能内容。
限制:本技能不实现功能,不拥有子技能的场景检测、前置条件与分步说明;具体收费、价格、平台支持范围等资料暂未提供。