mcpField
B
building-mobile-apps

building-mobile-apps

github.com/forcedotcom開発1.1k1.5k 回インストール1 日前に更新
リポジトリ

building-mobile-apps について

Salesforce連携モバイルアプリ開発向けのルーティングスキルです。要件に応じてMobile SDKとAgentforce SDKを選び、iOSまたはAndroidの適切な子スキルへ案内します。

主な機能

  1. 01SDKファミリーとプラットフォームによる振り分け
  2. 02両SDKを使うアプリへの対応
  3. 03SDK併用時の作業順序の整理
  4. 04子スキルの読み込みまたはインストール

活用シーン

  1. 01SalesforceモバイルアプリのSDK選定
  2. 02チャット中心のAgentforceアプリの計画
  3. 03データ駆動型アプリへのエージェント追加

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/building-mobile-appsを入力して読み込まれたか確認します。

詳細

Salesforce Mobile

Salesforce と連携するモバイルアプリの開発に適した SDK ファミリーのスキルにユーザーを案内します。ここでは機能を実装しないでください。シナリオの判定と手順の案内は子スキルが担当します。

ルーティングの前に

SDK ファミリー(Mobile SDK と Agentforce SDK)とプラットフォーム(iOS と Android)の 2 つの観点を明確にしてください。これらは相互排他的ではありません。1 つのアプリで両方の SDK を使用できます。

ユーザーの意図がどちらの SDK にも当てはまる可能性がある場合は、ルーティングする前に質問してください。誤った判断をすると、プラットフォームと SDK に特化した子スキルを使うことになり、ユーザーの時間を無駄にします。

ルーティング — SDK ファミリーの選択

ユーザーの状況SDK
Salesforce へのエンドユーザー認証、レコードの同期(MobileSync)、オフラインでのデータ保存(SmartStore)、生体認証ログイン、プッシュ通知、REST 連携Mobile SDK
Agentforce エージェントの組み込み — チャット UI、エージェントとの会話、主要なインターフェースとしての会話機能Agentforce SDK
両方(データ駆動型アプリにエージェントを組み込む)まず Mobile SDK、次にその上に Agentforce SDK を組み込む
両方が当てはまりそうな場合の判断基準
  • エージェントは 主要なインターフェース(チャット中心のアプリ)ですか。それとも、データ駆動型アプリ内の 機能 ですか?
    • 主要なインターフェース → Agentforce SDK
    • 機能 → Mobile SDK。Agentforce SDK を併用してエージェントを組み込みます
  • エンドユーザーは Salesforce のデータに認証してアクセスしますか?
    • はい → Mobile SDK が必要です(Agentforce SDK を上乗せできます)。
    • いいえ → Agentforce SDK だけで十分と考えられます(ゲスト認証を使用します)。
  • オフラインストレージ、同期、REST、プッシュ通知、生体認証について尋ねていますか? → Mobile SDK。
  • エージェントとの会話、チャット UI、ストリーミング応答について尋ねていますか? → 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 のプラットフォームスキルに案内し、エージェントのインターフェースを組み込みます。
  3. 各 SDK については、各子スキルの手順を正としてください。手順を統合しないでください。それぞれの SDK が独自の認証設定、依存関係のインストール順序、初期化手順を管理しています。これらを混在させると、設定が競合し、初期化順序が壊れます。

このスキルが担当する複数スキル間のロジックは、この順序付けのみです。それ以外はすべて子スキルが担当します。

子スキルの読み込み

ハーネスを通じて、名前を指定して子スキルを呼び出します。ローカルで利用できない場合は、ユーザーに 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

インストール後、子スキルを読み込み、処理を引き継がせます。子スキルの内容を本文に含めてはいけません。シナリオの検出、前提条件、手順を担うのは子スキルです。

コメント