mcpField
B
building-mobile-apps

building-mobile-apps

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

关于 building-mobile-apps

面向 Salesforce 移动应用开发的路由技能,根据需求和平台将任务交给相应的 SDK 子技能。它涵盖 Mobile SDK 与 Agentforce SDK 的选择,以及两者结合时的执行顺序。

主要功能

  1. 01按 SDK 系列和平台路由
  2. 02处理同时使用两种 SDK 的应用
  3. 03安排组合 SDK 工作流顺序
  4. 04加载或安装子技能

适用场景

  1. 01为 Salesforce 移动应用选择 SDK
  2. 02规划以聊天为主的 Agentforce 应用
  3. 03为数据驱动应用添加 Agent

安装

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

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

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

详细介绍

Salesforce Mobile

将用户引导至合适的 SDK 系列技能,以构建连接 Salesforce 的移动应用。请勿在此处实现功能;子技能负责场景判断和分步说明。

路由前

从两个维度进行判断:SDK 系列(Mobile SDK 与 Agentforce SDK)和平台(iOS 与 Android)。二者并不互斥——一个应用可以同时使用这两种 SDK。

如果用户的意图可能对应任一种 SDK,请先询问再进行路由。猜错会浪费用户的时间,因为子技能针对特定平台和 SDK。

路由——选择哪个 SDK 系列?

用户的情况SDK
对 Salesforce 进行终端用户身份验证、同步记录(MobileSync)、离线存储数据(SmartStore)、生物识别登录、推送通知、REST 集成Mobile SDK
嵌入 Agentforce Agent——聊天界面、Agent 对话、以对话功能为主要界面Agentforce SDK
两者兼有(数据驱动型应用中嵌入 Agent)先使用 Mobile SDK,再在其上叠加 Agentforce SDK
两者似乎都适用时的判断依据
  • Agent 是主要界面(以聊天为主的应用),还是原本以数据驱动的应用中的一项功能?
    • 主要界面 → Agentforce SDK
    • 应用功能 → Mobile SDK;同时通过 Agentforce SDK 嵌入 Agent
  • 终端用户是否要通过身份验证访问 Salesforce 数据?
    • 是 → 必须使用 Mobile SDK(也可以再叠加 Agentforce SDK)。
    • 否 → 单独使用 Agentforce SDK 可能就足够了(它使用访客身份验证)。
  • 用户询问离线存储、同步、REST、推送或生物识别?→ Mobile SDK。
  • 用户询问 Agent 对话、聊天界面或流式响应?→ Agentforce SDK。

如果仍不明确,请直接询问用户。

路由——选择哪个平台?

平台Mobile SDK 技能Agentforce SDK 技能
iOS(Swift)ios-mobile-sdkintegrate-agentforce-ios
Android(Kotlin)android-mobile-sdkintegrate-agentforce-android

如果用户需要两个平台,请分别引导至对应的子技能——它们彼此独立。

组合工作流(Mobile SDK + Agentforce SDK)

应用需要同时使用两者时:

  1. 先引导至对应平台的 Mobile SDK 技能,以搭建应用框架并完成身份验证。
  2. 再引导至对应平台的 Agentforce SDK 技能,以叠加 Agent 界面。
  3. 每个子技能的说明都应视为其 SDK 的权威指南;不要合并它们的步骤。每个 SDK 都有自己的身份验证设置、依赖项安装顺序和初始化流程——交错执行会导致配置冲突和初始化顺序错误。

这是本技能唯一负责的多技能逻辑。其余内容都由子技能负责。

加载子技能

通过 harness 按名称调用子技能。如果本地没有该技能,请提示用户使用 npx skills add <repo> 安装。如果用户确认(或已预先授权安装),运行命令并加载子技能——不要让用户自行摸索如何继续工作流。如果用户拒绝,请停止并说明该子技能负责 SDK 的设置步骤,没有它就无法继续工作流。每个子技能都发布在公共仓库中:

技能仓库安装命令
ios-mobile-sdkforcedotcom/SalesforceMobileSDK-Templates → skills/ios-mobile-sdk/npx --yes skills add forcedotcom/SalesforceMobileSDK-Templates --skill ios-mobile-sdk --yes
android-mobile-sdkforcedotcom/SalesforceMobileSDK-Templates → skills/android-mobile-sdk/npx --yes skills add forcedotcom/SalesforceMobileSDK-Templates --skill android-mobile-sdk --yes
integrate-agentforce-iossalesforce/AgentforceMobileSDK-iOS → skills/integrate-agentforce-ios/npx --yes skills add salesforce/AgentforceMobileSDK-iOS --skill integrate-agentforce-ios --yes
integrate-agentforce-androidsalesforce/AgentforceMobileSDK-Android → skills/integrate-agentforce-android/npx --yes skills add salesforce/AgentforceMobileSDK-Android --skill integrate-agentforce-android --yes

安装后,加载子技能并让其接管。不要将子技能的内容内联——场景检测、前置条件和分步说明均由子技能负责。

评论

支持 Markdown