关于 arcgis-docs-lookup
arcgis-docs-lookup 是用于回答 ArcGIS 问题的研究技能，帮助找到对应产品的第一方文档。它按产品路由问题、要求 Enterprise 引用注明版本，并为无法呈现的参考页提供后备查证方法。
主要功能
- 01按产品路由至对应文档
- 02要求 Enterprise URL 标明版本
- 03排除已退役的 ArcMap 和 Desktop 文档
- 04为无法呈现的参考页提供后备方法
- 05区分快速查询与深入调查
适用场景
- 01核实 ArcGIS API 或符号
- 02研究指定版本的 Enterprise 行为
- 03在参考页无法呈现时调查 API
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 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 中的 API 已经不同。如果搜索结果中出现 ArcMap 或 ArcGIS Desktop 页面，请弃用该结果，查找对应的 Pro 或 Enterprise 页面。
锁定版本
Enterprise 文档的 URL 路径中包含版本号（例如 .../enterprise/11.2/...）。所有 Enterprise URL 都必须锁定到当前所用的目标版本——即调用者指定的版本，或用户正在使用的版本。未指定版本或版本不匹配的 Enterprise URL 不可作为引用。
将 Community 视为线索，而非来源
Esri Community、GeoNet 和 Stack Exchange 讨论帖只能作为待核实的线索，不能作为引用。依赖任何说法之前，都要追溯到对应的权威第一方文档进行核实。
参考页面无法呈现时
developers.arcgis.com 上的 ArcGIS API for Python 和 REST API 参考文档采用客户端渲染的单页应用。直接获取这些页面中的任意一个（即使 URL 精确到符号锚点，例如 arcgis.gis.toc.html#arcgis.gis.Group.notify），也无法获得可用内容，因为符号表是由获取过程不会运行的 JavaScript 绘制的。这是工具故障，并不能证明该 API 不存在。 绝不要把“无法呈现参考文档”说成“没有此 API”。应按以下顺序改用可供机器读取的第一方来源：
- 搜索权威来源的 GitHub 仓库。 对于 Python API，搜索
Esri/arcgis-python-api——指南和示例笔记本，尤其是guide/02-api-overview/下按版本划分的release_notes_*笔记本，其中会按名称列出类和方法，并附有指向参考文档的锚点链接（像Group.notify()这样的符号会出现在这里，即使其参考页面无法呈现）。在仓库中搜索确切的符号名称。 - 检查已安装的包。 如果有可用的、装有
arcgis包的实时环境，包的源代码就是生成参考文档的依据——直接通过help(Group.notify)或inspect.signature(...)查看准确信息。使用python-notebook技能运行。JS SDK 的对应做法是查看 npm 上随@arcgis/core发布的 TypeScript 声明。
只有这些备用方法都查无结果后，才能报告该符号未经核实——如果阻碍你核实的只有客户端渲染页面，请说“无法核实”，而不是“不存在”。
根据问题调整调查深度
- 快速确认是否存在或检查签名（“版本 N 中是否存在此类／方法／全局对象”）——直接阅读权威参考页面，并在原处回答。无需写入文件。
- 深入调查（迁移范围、破坏性变更检查、综合多页内容）——如果有
research技能，则升级使用，并传入上述路由和版本规则，确保后台 Agent 遵守。如果未安装research，则针对相同的第一方来源直接进行调查。
完成标准
每项声明都有正确域名下的第一方 URL 作为依据；对于按版本划分的文档，URL 均固定到目标版本；引用中不再包含 ArcMap/Desktop 页面或未经核实的 Community 主题。对于“此 API 不存在”的结论，不能仅以未能加载的参考页面为依据——必须先通过 GitHub 仓库和软件包内省备用路径彻底排查。