sf-docs

このスキルを使用して、公開ウェブ上の Salesforce 公式ドキュメントを検索し、回答の根拠とします。

このスキルは意図的にシンプルです:

• ローカルコーパスなし
• インデックスなし
• ベンチマークワークフローなし
• ヘルパー CLI 依存なし
• PDF フォールバックなし

その役割は、特に help.salesforce.com、JS-heavy な developer.salesforce.com、lightningdesignsystem.com 上の Lightning Design System ドキュメント、および architect.salesforce.com や admin.salesforce.com などのその他の公式 Salesforce 所有ドキュメントページなど、取得が難しい Salesforce ドキュメントの 信頼できるオンライン検索プレイブック を提供することです。

オプションのラッパースクリプトは以下で利用可能です:

• skills/sf-docs/scripts/extract_salesforce_doc.py

このスクリプトは help.salesforce.com URL を自動的に専用 Help エクストラクタにルーティングし、汎用ブラウザレンダリングパスを通じて *.salesforce.com および lightningdesignsystem.com などの他の公式ドキュメントページをサポートします。ボット検出に敏感なページの場合、playwright-stealth がインストールされている場合は --stealth 経由でベストエフォートのオプションステルスモードもサポートします。

専用 Help エクストラクタは以下でも直接利用可能です:

• skills/sf-docs/scripts/extract_help_salesforce.py

コア目標

最高の公式 Salesforce HTML ページをオンラインで見つけ、自信を持って回答するのに十分な実際の内容を抽出します。

根拠が弱い場合は、弱い回答を無理に作るのではなく、明確にそう述べてください。

使用時機

ユーザーが以下を求めているときに sf-docs を使用してください:

• 公式 Salesforce ドキュメント
• Apex、API、LWC、メタデータ、Agentforce、セットアップ、またはヘルプ記事
• developer.salesforce.com からのドキュメント
• help.salesforce.com からのドキュメント
• JS-heavy、シェルレンダリング、または通常のフェッチで読むのが難しく見えるページ

公式ソースのみ

Salesforce 所有のドキュメントソースを優先してください:

• developer.salesforce.com
• help.salesforce.com
• architect.salesforce.com
• admin.salesforce.com
• lightningdesignsystem.com
• Salesforce が信頼できるソースとして使用している他の関連する公式 Salesforce ドキュメントページ

ユーザーが明示的に求めない限り、サードパーティのブログ、ビデオ、または要約記事は避けてください。

PDF にフォールバックしないでください。

検索ワークフロー

1. まずリクエストを分類してください

何かをフェッチする前に、可能性の高いドキュメントファミリーを特定してください。

ファミリー	典型的なソース	用途
Developer ドキュメント	developer.salesforce.com/docs/...	Apex、API、LWC、メタデータ、Agentforce developer ドキュメント
Help ドキュメント	help.salesforce.com/...	セットアップ、管理、製品構成
Architect/Admin ドキュメント	architect.salesforce.com/...、admin.salesforce.com/...	ベストプラクティス、パターン、Well-Architected ガイダンス、管理者向け情報提供
デザインシステムドキュメント	lightningdesignsystem.com/...	SLDS、Cosmos、デザイントークン、コンポーネントおよびスタイリングガイダンス
レガシー atlas ドキュメント	developer.salesforce.com/docs/atlas.en-us.*	古い公式ガイドおよびリファレンスドキュメント

2. 正確なコンセプトを特定してください

検索する前に実際のターゲットを抽出してください:

• 正確な API/クラス/メソッド名
• 正確な機能名
• 正確な製品フレーズ
• 正確なセットアップコンセプト

例:

• Lightning Message Service
• Wire Service
• System.StubProvider
• Agentforce Actions
• Messaging for In-App and Web allowed domains

3. ターゲットを絞った公式検索を優先してください

Salesforce ドキュメントを幅広くクロールしないでください。

代わりに:

1. 最も可能性の高い公式ガイドルートまたは記事を特定します
2. 検索が必要な場合、公式 Salesforce ドメインのみに制限します
3. その公式ページをフェッチします
4. 正確なコンセプトが実際にページに表示されているかを確認します
5. 表示されていない場合、最も関連性の高い 1～3 つの公式子リンク を検査し、フォローします
6. 根拠のある証拠が得られたら停止します

4. 幅広いランディングページで停止しないでください

ガイドランディングページは、明確に正確なリクエストコンセプトが含まれている場合を除き、十分ではありません。

これは特に以下に重要です:

• LWC ドキュメント
• Agentforce ドキュメント
• 幅広いプラットフォームガイドホームページ
• 実際の記事にリンクするヘルプランディングページ

5. developer.salesforce.com の場合

このプレイブックを使用してください:

• 最も可能性の高い公式ガイドルートで開始します
• ページが JS-heavy の場合、ブラウザレンダリング抽出を優先します
• 正確なコンセプトがページに表示されているかを確認します
• コンセプトが欠けている場合、公式子リンクを検査し、最もマッチングする 1～3 つのリンクをフォローします
• 幅広いガイドルートよりも正確なコンセプトページを優先します
• レガシー atlas ページは、その概念の実際の公式リファレンスである場合は有効です

6. help.salesforce.com の場合

Help ページはナイーブなフェッチで失敗することが多いです。

このプレイブックを使用してください:

• 利用可能な場合、正確な articleView?id=... URL を優先します
• プレーンフェッチがシェルコンテンツを返す場合、ブラウザレンダリング抽出を使用します
• Loading、Sorry to interrupt、CSS Error、またはほぼクロームナビゲーションテキストなどの出力を 失敗した抽出として、証拠ではなく扱います
• 実際の記事本文、ただしヘッダー、ナビゲーション、またはフッターテキストのみを探します
• シェルページおよびソフト 404 ページを拒否してください:
  • 「どこを探してもそのページが見つかりませんでした」
  • 汎用の空のヘルプシェル
• 近くのガイドまたはハブページから開始する場合、リンクされた Help 記事をフォローして実際の記事本文に到達するまで続けます
• ターゲットを絞った再試行後も抽出が失敗する場合、見つけた最高の公式 Help URL を返し、記事本文抽出が失敗したことを明確に述べます

受け入れルール

ページが以下のいずれかが真である場合のみ、回答するのに十分です:

• 正確な識別子がページに表示されている
• 正確なコンセプトフレーズがページに表示されている
• 複数のクエリ固有のフレーズが正しい公式コンテキストに表示されている

ページが 不十分 な場合:

• 正確なコンセプトのない幅広いランディングページのみです
• 実際の記事テキストがほとんどないシェルページです
• 間違った製品領域からです
• リクエストされた識別子またはコンセプトが含まれていません
• 公式ページが存在する場合のサードパーティの説明です

却下ルール

これらを最終的な証拠として却下してください:

• 正確なコンセプトのない幅広いガイドホームページ
• コンセプト/リファレンスページが期待される場合のリリースノート
• Developer ドキュメントが要求される場合の管理者ブログ投稿
• 公式ドキュメントが利用可能な場合のサードパーティブログ
• 実際の記事本文のないシェルレンダリングページ
• タイトルは正しく見えるがボディに要求されたコンセプトが含まれていないページ

根拠付け要件

回答する場合、以下を含めてください:

1. ガイド/記事タイトル
2. 正確な公式 URL
3. ソースタイプ:
   • Developer ドキュメントページ
   • atlas リファレンスページ
   • ヘルプ記事ページ
4. 抽出が部分的またはブラウザレンダリングされた場合の注釈

根拠が弱い場合、明確にそう述べてください。

例

例: Lightning Message Service

一般的な LWC ガイドルートで停止しないでください。 Lightning Message Service の正確な LWC ページを見つけるか、正確なコンセプトが表示されるまで LWC ドキュメントから最も関連性の高い子リンクをフォローしてください。

例: Wire Service

Wire Service が実際に存在しない限り、LWC ホームページから回答しないでください。 wire service または wire adapters の関連 child ドキュメントページをフォローしてください。

例: Agentforce Actions

幅広い Agentforce ランディングページまたはブログ投稿から回答しないでください。 アクションの公式 Agentforce Developer ページを見つけるか、公式 Agentforce ドキュメントから最もマッチングする child ページをフォローしてください。

例: Messaging for In-App and Web allowed domains

公式 Help 記事およびブラウザレンダリング抽出を優先してください。 汎用 Help シェルを却下してください。必要に応じて、公式メッセージングドキュメント近くからリンクされた Help 記事をフォローしてください。

例: System.StubProvider

正確な識別子が表示されている公式 Salesforce リファレンス/Developer ページを優先してください。 識別子が欠けている場合、より広い Apex ランディングページを代替しないでください。

非目標

このスキルは しないべきです:

• ローカルドキュメントコーパスを維持する
• ローカルインデックスに依存する
• PDF フォールバックを使用する
• ベンチマークワークフローを実行する
• 有用であるためにリポジトリ固有のスクリプトに依存する

クロススキル役割

他の sf-* スキルは、汎用検索のみに頼るのではなく、信頼できる Salesforce ドキュメントが必要な場合に sf-docs を使用すべきです。