arcgis-pro-automation

ArcGIS Pro 自动化

通过受保护的 arcgis-mcp-bridge 工具接口操作已保存的 ArcGIS Pro 项目和本地 GIS 数据集。请将桥接工具视为执行后端，而非修改数据的授权，也不要声称获得了从未观察到的结果。

明确边界

• 必须使用 Windows、已获许可的 ArcGIS Pro 安装，以及能够导入 ArcPy、用于实际地理处理的桥接工作进程解释器。
• 使用桥接工具执行本地、无界面、可重复的 ArcPy 工作。它不会驱动可见的 ArcGIS Pro UI，也不会管理 ArcGIS Online 或 Enterprise。
• 如果无法调用桥接工具，请提供设置说明或干运行计划。切勿模拟工具输出，也不要暗示 .aprx 或 .gdb 已发生更改。
• 使用已连接 MCP 服务公开的架构。工具名称可能带有宿主命名空间；请匹配语义目录名称，切勿臆造参数。
• 所有读写操作都必须位于已配置的允许根目录内。使用绝对路径，并为中间输出指定专用临时地理数据库。

首次执行前，或需要处理设置、扩展可用性或工作进程故障时，请先阅读运行时和许可。

执行工作流

1. 定义约定。 确认输入、预期输出产物、CRS 和单位、是否需要更改已保存的 .aprx，以及哪些操作会创建、覆盖、追加或编辑数据。
2. 执行预检。 首先调用 health_check。检查其工作进程解释器、允许根目录、临时 GDB、超时设置和并发数。由于此调用不会导入 ArcPy，在将运行时视为已准备好执行之前，接着发起一个由 ArcPy 支持且不会修改数据的请求，例如 get_spatial_reference、describe_dataset 或 list_layers。
3. 先检查再操作。 读取数据集说明、计数、字段、CRS、范围、项目地图/图层以及所需扩展许可。在分析前确定基准转换、单位和输出命名。
4. 规划精确工具。 从工具路由中选择最精简的声明式操作序列。将只读检查、新建输出和原位修改分开。优先创建新输出和工作副本，而不是编辑源数据。
5. 授权修改。 执行任何写入操作前，请阅读安全与验证。仅当用户请求明确授权了确切的修改操作和目标时，才设置 confirm=true。将 overwrite=true 视为一项需要单独明确决定的设置。目标、范围或意图不明确时，请停止操作。
6. 逐步执行。 每次运行一个有依赖关系的步骤；保留返回的输出路径和地理处理消息。仅当已知许可席位、内存和 max_workers 能够支持时，才并行执行彼此独立的作业。
7. 独立验证。 重新打开输出并测试相关不变量：是否存在、计数、几何有效性、CRS 和单位、栅格统计数据和 NoData、网络求解状态、项目内容或导出布局的尺寸。仅凭成功状态不足以证明 GIS 结果正确。

分别选择领域方法和执行方式

将此技能用于 ArcGIS 执行层。如果方法选择或科学有效性至关重要，请搭配相关领域技能：

• DEM、坡度、水文分析或视域 → terrain-hydrology
• 路由、服务区、OD 或设施 → network-accessibility-analysis
• Moran's I、Gi*、核密度或空间推断 → spatial-statistics
• 栅格/影像预处理和解译 → remote-sensing-analysis
• .aprx 样式设置或布局导出前的地图设计 → cartography-geoviz
• 跨领域的多阶段交付 → geoai-orchestrator

不要仅仅因为 ArcGIS 能读取某种开放格式，就启用 ArcGIS 自动化。对于明确选择 GDAL、GeoPandas、QGIS、PostGIS 或其他运行时的 GeoPackage、GeoJSON、栅格或 .gdb 请求，应使用对应的专业技能。

处理失败，不绕过限制

• validation：根据实时架构修正负载；不要放宽类型限制。
• security：只有获得用户授权后才能移动或复制；绝不要仅为让调用通过而扩大允许的根目录范围。
• license：报告不可用的基础许可证或扩展许可证。仅在方法上等效时才使用替代方案，并说明这一变更。
• geoprocessing：保留 ArcPy 消息，检查输入和环境，并且仅在进行具体修正后重试。绝不要盲目重试就地修改操作。
• internal 或工作线程崩溃：保留错误边界，并停止声称操作已完成。

提供证据

报告工具调用顺序、检查过的输入、准确的输出路径、修改内容及授权依据、相关 ArcPy 消息、验证结果、许可证和运行时限制，以及尚未解决的局限。对于当前的工具或平台声明，请查阅权威来源注册表，并记录查阅日期。

执行约定

• **工作流：**明确本地 ArcGIS 边界；分别预检服务端和 ArcPy；检查数据和项目状态；规划确切的工具；授权写入；分步执行；重新打开并验证输出。
• **决策规则：**仅在明确涉及本地 ArcGIS Pro 或 ArcPy 工作时使用桥接工具；必要时将其与领域方法技能搭配使用；优先生成新输出，并仅对已明确授权的目标使用确认和覆盖标志。
• **验证协议：**根据声明的成功标准，核对计数、几何、CRS 和单位、栅格或网络诊断、.aprx 内容、导出产物、返回路径和地理处理消息。
• **失败模式：**如果桥接工具缺失、ArcPy 预检失败、CRS 或基准面转换未知、路径超出允许的根目录、许可证缺失、修改范围不明确、工作线程崩溃或输出状态未经验证，则停止操作。
• **交付物：**可复现的工具计划和调用、准确的输入和输出、修改记录、ArcPy 消息、验证证据、运行时和许可证来源，以及局限。
• **来源时效性：**在应用桥接工具、ArcPy、许可证或平台规则前，查阅权威来源注册表，并记录查阅日期。