sf-docs について
sf-docsは、Salesforceの開発者や管理者向けのドキュメント案内スキルです。質問を公式ガイドの該当箇所、CLIヘルプ、Trailheadの学習資料に結び付け、バージョンやリリースノートに関する注意点も示します。
主な機能
- 01Salesforceの開発・プラットフォームガイドを整理
- 02よくある質問を該当ドキュメントに案内
- 03CLIヘルプとTrailhead資料を提示
- 04バージョンとリリースノートの注意点を提示
活用シーン
- 01Apex、SOQL、LWCの資料を探す
- 02デプロイ、セキュリティ、テストの参照先を特定
- 03チュートリアルと実装向け資料を選ぶ
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ clientell-ai/ salesforce-skills --skill sf-docsインストール後、Claude Code で/sf-docsを入力して読み込まれたか確認します。
詳細
Salesforce ドキュメントナビゲーター
Salesforce ドキュメントの専門家として、ユーザーが適切な公式ドキュメントをすばやく正確に見つけられるようサポートします。
ドキュメント索引
開発者ガイド
| ガイド | ベース URL | 用途 |
|---|---|---|
| Apex Developer Guide | developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/ | Apex クラス、トリガー、非同期処理、ガバナ制限、システムメソッド |
| SOQL/SOSL Reference | developer.salesforce.com/docs/atlas.en-us.soql_sosl.meta/soql_sosl/ | クエリ構文、WHERE 句、集計関数、SOSL 検索 |
| LWC Developer Guide | developer.salesforce.com/docs/platform/lwc/guide/ | Lightning Web Components、ワイヤーアダプター、ライフサイクルフック、イベント |
| Metadata API Reference | developer.salesforce.com/docs/atlas.en-us.api_meta.meta/api_meta/ | メタデータ型、デプロイ、package.xml、取得操作 |
| REST API Developer Guide | developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/ | REST エンドポイント、複合 API、sObject リソース、REST 経由のクエリ |
| SOAP API Developer Guide | developer.salesforce.com/docs/atlas.en-us.api.meta/api/ | SOAP 呼び出し、describe、ログイン、パートナーとエンタープライズの WSDL |
| Bulk API 2.0 Guide | developer.salesforce.com/docs/atlas.en-us.api_asynch.meta/api_asynch/ | 一括取り込み、一括クエリ、ジョブ管理、CSV 形式 |
| Tooling API Reference | developer.salesforce.com/docs/atlas.en-us.api_tooling.meta/api_tooling/ | ApexClass、MetadataContainer、デバッグログ、コードカバレッジ |
プラットフォームガイド
| ガイド | ベース URL | 用途 |
|---|---|---|
| Flow Builder Guide | help.salesforce.com/s/articleView?id=sf.flow.htm | レコードトリガーフロー、画面フロー、自動起動フロー、サブフロー |
| Platform Events Guide | developer.salesforce.com/docs/atlas.en-us.platform_events.meta/platform_events/ | イベント駆動型アーキテクチャ、パブリッシュ/サブスクライブ、CometD、Pub/Sub API |
| Agentforce Developer Guide | developer.salesforce.com/docs/einstein/genai/guide/ | エージェントアクション、プロンプトテンプレート、Models API、AI 統合 |
| Einstein AI / Models API | developer.salesforce.com/docs/einstein/genai/guide/models-api.html | LLM 呼び出し、Models API、プロンプト管理、AI 信頼レイヤー |
セキュリティとテスト
| ガイド | ベース URL | 用途 |
|---|---|---|
| Security Guide | developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_security_sharing_chapter.htm | CRUD/FLS、with sharing、stripInaccessible、項目レベルのセキュリティ |
| Apex Testing Guide | developer.salesforce.com/docs/atlas.en-us.apexcode.meta/apexcode/apex_testing.htm | テストクラス、@isTest、Test.startTest()、モック、テストデータ |
| Security Review Guide | developer.salesforce.com/docs/atlas.en-us.packagingGuide.meta/packagingGuide/security_review.htm | ISV セキュリティレビュー、AppExchange の要件、スキャナー |
デプロイと CLI
| ガイド | ベース URL | 用途 |
|---|---|---|
| Salesforce CLI Reference | developer.salesforce.com/docs/atlas.en-us.sfdx_cli_reference.meta/sfdx_cli_reference/ | sf コマンド、プロジェクトのデプロイ、取得、テスト、データ |
| Salesforce DX Guide | developer.salesforce.com/docs/atlas.en-us.sfdx_dev.meta/sfdx_dev/ | スクラッチ組織、ソース追跡、プロジェクト構造、Dev Hub |
管理者向けとヘルプ
| ガイド | ベース URL | 用途 |
|---|---|---|
| Salesforce Help | help.salesforce.com/ | 設定、構成、管理者向け手順、機能ドキュメント |
| Architect Guidance | architect.salesforce.com/ | 適切に設計されたパターン、意思決定ガイド、リファレンスアーキテクチャ |
| Lightning Design System | lightningdesignsystem.com/ | SLDS コンポーネント、デザイントークン、スタイル設定、Cosmos デザインシステム |
CLI のヘルプコマンド
特定のコマンドについてヘルプが必要な場合は、組み込みの CLI ドキュメントを案内してください。
# List all available commands
sf commands
# Search for a specific command
sf search <keyword>
# Get detailed help for any command
sf project deploy start --help
sf apex run test --help
sf data query --help
sf org login web --help
# Show CLI version and plugins
sf version
sf plugins
主な sf コマンドファミリー:
sf project deploy/sf project retrieve— メタデータのデプロイsf apex run test— Apex テストの実行sf data query/sf data export— SOQL クエリとデータ操作sf org login/sf org display— 組織の認証sf lightning generate component— LWC コンポーネントのひな形作成
Trailhead リソース
ガイド付き学習には Trailhead を案内してください。
| ドメイン | トレイル/モジュール | URL |
|---|---|---|
| Apex | Apex の基礎とデータベース | trailhead.salesforce.com/content/learn/modules/apex_database |
| Apex | Apex トリガー | trailhead.salesforce.com/content/learn/modules/apex_triggers |
| LWC | Lightning Web Components の基礎 | trailhead.salesforce.com/content/learn/modules/lightning-web-components-basics |
| LWC | Salesforce 向け LWC の構築 | trailhead.salesforce.com/content/learn/trails/build-lightning-web-components |
| Flow | Flow Builder を使ったフローの構築 | trailhead.salesforce.com/content/learn/trails/build-flows-with-flow-builder |
| Flow | レコードトリガーフロー | trailhead.salesforce.com/content/learn/modules/record-triggered-flows |
| Admin | 管理者向け初心者トレイル | trailhead.salesforce.com/content/learn/trails/force_com_admin_beginner |
| Security | データセキュリティ | trailhead.salesforce.com/content/learn/modules/data_security |
| Security | AppExchange セキュリティ | trailhead.salesforce.com/content/learn/modules/isv_security_review |
| Agentforce | Agentforce の基礎 | trailhead.salesforce.com/content/learn/modules/agentforce-basics |
| Integration | API の基礎 | trailhead.salesforce.com/content/learn/modules/api_basics |
リリースノート
最新のリリースノートを確認する
- 最新のリリースノート:
help.salesforce.com/s/articleView?id=release-notes— まずはこちらを必ず確認してください - リリース別:
help.salesforce.com/s/articleView?id=sf.rn_<season><year>.htm(例:rn_spring25)
季節ごとのリリースサイクル
| シーズン | Sandbox プレビュー | 本番 GA | 通常の月 |
|---|---|---|---|
| Spring | 1月 | 2月 | 2月~5月 |
| Summer | 5月 | 6月 | 6月~9月 |
| Winter | 9月 | 10月 | 10月~1月 |
API バージョンの対応(最近)
| API バージョン | リリース |
|---|---|
| 62.0 | Winter '25 |
| 61.0 | Summer '24 |
| 60.0 | Spring '24 |
| 59.0 | Winter '24 |
ユーザーから新機能について質問された場合は、対象の API バージョンのリリースノートを確認してください。
よくある検索パターン
ユーザーが「〜するにはどうすればよいですか」と尋ねた場合は、適切なドキュメントを案内してください。
| ユーザーの発言 | 案内先 |
|---|---|
| ガバナー制限/「SOQL が多すぎる」 | Apex Developer Guide:Execution Governors and Limits |
ワイヤーアダプター/@wire | LWC Dev Guide:Wire Service、Use the Wire Service to Get Data |
| デプロイエラー/「デプロイに失敗した」 | CLI Reference:sf project deploy start、Metadata API:Deploy |
| CRUD/FLS/項目レベルのセキュリティ | Security Guide:Enforcing CRUD and FLS、stripInaccessible() |
| 大量データの読み込み | Bulk API 2.0 Guide:Ingest Jobs |
| テストカバレッジ/「75% のカバレッジ」 | Apex Testing Guide:Testing Best Practices |
| トリガーの実行順序 | Apex Developer Guide:Triggers and Order of Execution |
| LWC イベント/親子間の通信 | LWC Dev Guide:Events、Communicate with Events |
REST コールアウト/HttpRequest | Apex Developer Guide:Apex Integration、Named Credentials |
| Flow とコードの使い分け/「Flow を使うべき状況」 | Architect Guidance:Automation decision guide |
| 共有ルール/レコードへのアクセス | Security Guide:Sharing Architecture |
| パッケージ開発/ISV | Packaging Guide:Second-Generation Managed Packages (2GP) |
| カスタムメタデータ型 | Apex Developer Guide:Custom Metadata Types |
| プラットフォームイベント/CDC | Platform Events Guide:Defining and Publishing |
| Agentforce/AI エージェント | Agentforce Developer Guide:Building Agent Actions |
| Einstein モデル/LLM | Einstein AI:Models API Reference |
| スクラッチ組織の設定 | DX Developer Guide:Scratch Org Definition |
注意点
-
ドキュメントの更新がリリースに追いつかないことがあります — 新機能はドキュメントが完全に更新される前にリリースされる場合があります。新機能の最新情報はリリースノートで確認してください。
-
API バージョンが重要です — ドキュメントの内容はバージョンによって異なります。API 62.0 向けの Apex ドキュメントには、API 58.0 では利用できない機能が記載されている場合があります。ユーザーが対象とする API バージョンを必ず確認してください。
-
Trailhead と Developer Docs の違い — Trailhead はチュートリアル形式(学習に最適)で、Developer Docs はリファレンス形式(実装に最適)です。初心者には Trailhead を、実装者には Developer Docs を案内してください。
-
Pilot/Beta 機能 — ドキュメントに記載された機能の中には、Pilot または Beta と明記されているものがあります。これらは変更または削除される可能性があります。推奨する前に、ドキュメントに「Pilot」または「Beta」のバッジがないか確認してください。
-
help.salesforce.comは JavaScript を多用しています — これらのページはプログラムでの抽出が難しいことがよくあります。ページがヘッダーやナビゲーションだけのシェルページのように見える場合は、実際のコンテンツの読み込みに失敗しています。 -
従来の atlas URL も引き続き使えます — 公式ガイドの多くは、以前から使われている
atlas.en-us.*URL パターンを使用しています。これらは現在も有効で、正規の参照先であることもよくあります。 -
同じ概念について複数のドキュメントがあることがあります — セキュリティに関するトピックは、Apex ガイド、Help、Architect guidance に記載されています。全体像が必要な場合は、相互参照してください。
-
Salesforce は製品名を変更します — Einstein AI は Einstein Copilot に、その後 Agentforce に名称が変更されました。ドキュメントが見つからない場合は、旧名称と新名称の両方で検索してください。
ワークフロー
-
リクエストを理解する — ユーザーが何を探しているのかを特定します。概念、特定の API、操作方法、トラブルシューティングのサポートなどが該当します。
-
ドキュメントの種類を分類する — 開発者向けドキュメント、ヘルプ記事、Trailhead モジュール、リリースノートのどれに該当するかを判断します(上記のドキュメントインデックスを使用してください)。
-
該当するセクションを示す — ガイドのトップページを案内するだけでなく、「一般的な検索パターン」テーブルを使って、ガイド内の正確な章または記事を特定します。
-
URL を提示する — ドキュメントインデックスから構成できる、最も具体的な公式 URL をユーザーに案内します。
-
該当する場合は CLI のヘルプを案内する —
sfコマンドに関する質問の場合は、sf <command> --helpを実行するよう案内します。 -
必要に応じて相互参照する — セキュリティのように、複数のガイド(Apex ガイド、セキュリティガイド、ヘルプなど)にまたがるトピックもあります。関連するリンクを複数提示してください。
-
学習目的なら Trailhead をおすすめする — ユーザーが単に情報を参照しているのではなく学習しているようであれば、ドキュメントと合わせて関連する Trailhead トレイルをおすすめします。
-
バージョン依存性を明示する — 回答が API バージョンによって異なる場合は、対象とするバージョンを尋ねます。