用途:这是构建 Salesforce 原生 iOS/Android 移动应用的入口技能,只做路由,不实现具体功能;场景识别与分步说明由子技能负责。
主要能力:按两个维度消歧——SDK 家族(Mobile SDK 与 Agentforce SDK)和平台(iOS 与 Android)。两者不互斥,一个应用可同时使用。若意图可能同时映射到两种 SDK,应先询问用户再路由,避免猜错浪费时间。
路由判断:涉及终端用户登录 Salesforce、记录同步(MobileSync)、离线存储(SmartStore)、生物识别登录、推送通知、REST 集成时选 Mobile SDK;以嵌入 Agentforce 智能体、聊天 UI、对话为主要界面时选 Agentforce SDK;两者都需要时先用 Mobile SDK,再叠加 Agentforce SDK。若智能体是主界面选 Agentforce SDK,若只是数据驱动应用中的一个功能则选 Mobile SDK 并叠加 Agentforce SDK;终端用户需登录 Salesforce 数据时必须用 Mobile SDK。平台方面:iOS(Swift)对应 ios-mobile-sdk 与 integrate-agentforce-ios,Android(Kotlin)对应 android-mobile-sdk 与 integrate-agentforce-android;双平台需分别路由,二者相互独立。
组合流程:先路由到 Mobile SDK 平台技能完成脚手架与认证,再加载 Agentforce SDK 平台技能叠加智能体界面;不要手写 Agentforce 集成,其依赖、产品与 API 无法猜测,手写代码无法编译。各子技能步骤不可合并,各自拥有认证设置、依赖安装顺序与初始化顺序。
加载子技能:通过 harness 按名称调用;本地不可用时提示用户用 npx skills add <repo> 安装,用户确认或已预授权则运行命令并加载。安装命令: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。安装后加载子技能并交由其接管,不要内联其内容。
限制:本技能不实现功能,不拥有子技能的场景检测、前置条件与步骤;用户拒绝安装子技能时工作流无法继续。