mcpField
A
arcgis-docs-lookup

arcgis-docs-lookup

github.com/valdesrosier開発8110 回インストール4 週間前に更新
リポジトリ

arcgis-docs-lookup について

arcgis-docs-lookupは、ArcGISの質問に適切な公式ドキュメントを使って答えるためのリサーチスキルです。製品別に参照先を振り分け、EnterpriseのURLに対象バージョンを指定し、ページを表示できない場合の確認手順も示します。

主な機能

  1. 01製品別に公式ドキュメントへ振り分け
  2. 02Enterprise URLのバージョン指定
  3. 03廃止済みArcMap・Desktop文書の除外
  4. 04表示できない参照ページの代替確認
  5. 05簡易確認と調査の使い分け

活用シーン

  1. 01ArcGIS APIやシンボルの存在確認
  2. 02対象リリースのEnterprise動作調査
  3. 03参照ページ表示失敗時のAPI調査

インストール

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

$npx skills add https://github.com/valdesrosier/skills --skill arcgis-docs-lookup

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

同梱ファイルagents/openai.yaml

詳細

ArcGIS ドキュメントの検索

ArcGIS に関する質問には、必ずその情報を所有する一次ソースから回答してください。古いミラー、別製品のページ、未確認のフォーラム投稿は使わないでください。

情報を所有するソースを選ぶ

  • developers.arcgis.com — ArcGIS Maps SDK for JavaScript、ArcGIS API for Python、REST API、Arcade のリファレンス。
  • developers.arcgis.com/enterprise-sdk — ArcGIS Enterprise SDK。Custom Data Feeds（CDF）プロバイダーの開発も含みます。上記の開発者向けリファレンスとは異なる製品分野です。CDF と Enterprise SDK に関する質問はこちらを参照してください。
  • pro.arcgis.com — ArcGIS Pro。ArcPy とジオプロセシングも含みます。
  • enterprise.arcgis.com — ArcGIS Enterprise、Portal、Notebook Server の管理および実行時のドキュメント。

ArcMap、ArcCatalog、ArcGIS Desktop のドキュメントは絶対に引用しないでください。 これらは廃止された製品について説明しており、その API は Pro や Enterprise のものとは異なっています。検索結果に ArcMap または ArcGIS Desktop のページが表示された場合は破棄し、Pro または Enterprise に対応するページを探してください。

バージョンを固定する

Enterprise のドキュメントは URL パスでバージョンが指定されています（例：.../enterprise/11.2/...）。Enterprise の URL はすべて、対象のバージョン、つまり質問者が指定したリリースまたはユーザーが使用しているリリースに固定してください。バージョンが指定されていない URL や、バージョンが一致しない URL は、適切な引用先ではありません。

Community は情報源ではなく仮説として扱う

Esri Community、GeoNet、Stack Exchange のスレッドは、確認すべき手掛かりであり、引用元ではありません。主張を根拠として採用する前に、必ず情報を所有する一次ソースまでたどって確認してください。

リファレンスページが表示されない場合

developers.arcgis.com の ArcGIS API for Python と REST API のリファレンスは、クライアント側でレンダリングされるシングルページアプリです。arcgis.gis.toc.html#arcgis.gis.Group.notify のように正確なシンボルのアンカーを指定してページを取得しても、JavaScript が実行されずシンボル一覧が描画されないため、有用な内容は返されません。これはツール上の問題であり、API が存在しない証拠ではありません。 「リファレンスを表示できなかった」ことを「その API は存在しない」と言い換えてはいけません。代わりに、機械可読な一次ソースを次の順に利用してください。

  1. 情報を所有するソースの GitHub リポジトリを検索します。 Python API の場合は Esri/arcgis-python-api を検索します。ガイドやサンプルノートブック、特に guide/02-api-overview/ にあるバージョンごとの release_notes_* ノートブックには、リファレンスへのアンカーリンクとともにクラスやメソッドが名前で列挙されています。これにより、リファレンスページが表示されなくても Group.notify() のようなシンボルを見つけられます。リポジトリ内で正確なシンボル名を検索してください。
  2. インストール済みパッケージを調べます。 arcgis パッケージを利用できる稼働環境がある場合、リファレンスの生成元であるパッケージのソースを直接確認できます。help(Group.notify) または inspect.signature(...) を使って、正確な情報を確認してください。実行には python-notebook スキルを使用します。JS SDK の場合は、npm で配布されている @arcgis/core の TypeScript 宣言ファイルが同等の情報源です。

これらの方法でも確認できなかった場合に限り、そのシンボルは未確認であると報告できます。クライアント側でレンダリングされるページだけが確認を妨げていた場合は、「存在しません」ではなく「確認できませんでした」と伝えてください。

質問に応じて調査の深さを調整する

  • 存在やシグネチャの簡単な確認（「バージョン N にこのクラス／メソッド／グローバルは存在するか」） — 情報を所有するリファレンスページを直接読み、回答に記載します。ファイルは作成しません。
  • 本格的な調査（移行対象の洗い出し、破壊的変更の調査、多数のページを横断した情報の整理） — research スキルが利用可能な場合は、それを使い、バックグラウンドエージェントが従うように、このルーティングとバージョンのルールを伝えます。research がインストールされていない場合は、同じ一次ソースを使ってその場で調査します。

完了条件

すべての主張が正しいドメインの公式 URL で裏付けられ、ドキュメントがバージョンごとに分かれている場合は、対象バージョンに固定されています。また、ArcMap／Desktop のページや、未検証の Community スレッドが引用として残っていません。「この API は存在しない」という結論は、単に表示できなかったリファレンスページだけを根拠にしていません。その経路については、GitHub リポジトリとパッケージのイントロスペクションによる代替手段も先に調査済みです。

コメント

Markdown 対応