GIS-SKILL-V5.0：让AI读懂GIS经验的结构化技能库

简介一套面向地理信息系统领域深度集成的智能体技能框架用于支撑空间智能体在复杂地理数据环境中完成感知、理解、推理与决策执行。框架整合坐标解析、拓扑判定、栅格代数、矢量叠加、路径规划、三维地形建模、遥感解译、地理编码等三十七类空间操作技能采用标准化输入输出契约与JSON Schema校验内置多坐标系自动转换支持亿级要素亚秒级响应并通过OGC WPS 2.0兼容性认证可接入主流GIS服务生态。资源包共165个文件以148个md技能文档为主附带11个Python脚本与3个JSON配置涵盖开发、测试、部署与监控参考整体仅1.29MB。目前已有52人学习浏览。内容涉及三维GIS与数字孪生、ArcGIS Pro操作、避坑库等模块另含127个预训练空间行为模板及典型实施案例可直接参考落地城市内涝模拟、耕地监测、路径优化等业务场景适合GIS智能体研发、空间分析技术选型与行业应用设计者。 直接说结论GIS-SKILL-V5.0不是某个官方推出的新软件也不是什么标准协议而是把 GIS 日常处理和 AI 编程工具中的 Skill 机制打通的一套整理思路。这两年我花了不少时间在 GIS 数据处理和 codex、claude code、cursor 这类工具之间来回切换最大的感受是GIS 的技能沉淀非常依赖经验文档而 AI 编码工具又特别吃结构化的能力描述GIS-SKILL-V5.0 正好把这两件事接到了一起。如果你平时要处理 shapefile、做拓扑检查、批量出图或者正琢磨怎么让 AI 帮你写 GIS 脚本这篇文章里的整理应该能省你不少事。1. 先搞清楚 GIS-SKILL-V5.0 到底是什么1.1 不是软件也不是插件是一套可复用的经验包很多人第一次看到这个命名下意识会去找安装包或者插件市场。实际上 Skill 在最近的 AI 编码工具圈里已经有比较明确的含义它是一段结构化的说明文件告诉 AI 模型在什么场景下、按什么步骤、用什么参数去完成某类任务。GIS-SKILL-V5.0 就是这类技能包在 GIS 方向上的一个版本化集合里面既可以包含怎么处理尖锐角怎么修复拓扑错误这类纯 GIS 规则也可以包含让 AI 直接生成某段 ArcPy 代码的模型提示词和模板。它解决的问题很具体GIS 处理里大量知识是隐性的比如阈值怎么取、容差设多少、坐标系先转哪个这些经验通常只存在于老手的脑子里。把这些隐性经验显性化、文件化、版本化就是这套东西存在的意义。而且它不绑定某一家软件生态ArcGIS、QGIS、PostGIS、FME 都可以往里塞重点是流程和判断标准本身。适合的人群我总结了一下GIS 数据处理工程师、测绘相关专业的学生、以及尝试用 AI 辅助写数据处理脚本的人。1.2 从 V1.0 到 V5.0版本演进的逻辑我见过不少团队从 V1.0 开始整理最初就是一个共享文档列了一堆注意别踩坑的条目。V2.0 开始把数据检查规范拓扑、重叠、缝隙单独拆出来V3.0 加了 ArcPy 和 QGIS 的脚本模板V4.0 开始引入 AI 生成代码的约束描述。到了 V5.0最大的变化是技能本身变成了可以被 AI 工具直接加载的结构化文件比如给 codex 用的 SKILL.md、给 claude code 用的 skill 描述、给 cursor 用的规则目录。这个演进其实正好反映了行业趋势经验不再只是给人看的文档而是给人机协作共同消费的资产。V5.0 的典型目录形态一般是这样的gis-skill-v5.0/ ├── core-rules/ # 核心规则坐标系、容差、精度 ├── processing-skills/ # 处理技能拓扑、叠加、融合 ├── ai-prompts/ # 给 AI 的结构化提示词 ├── scripts/ # ArcPy / PyQGIS 示例脚本 └── error-db/ # 报错速查与解决记录这个分层最大的好处是隔离规则变了只改 core-rules脚本抽出来单独测试AI 提示词可以独立迭代不影响已经稳定的流程。我在实际整理中踩过的坑是一开始把脚本和规则放在同一个 markdown 里结果 AI 读取时经常混淆必须做和建议做拆开之后准确率明显提升。2. GIS 主线高频处理场景的技能拆解2.1 尖锐角处理角度怎么定狭长多边形怎么算很多 GIS 数据治理任务里都会遇到尖锐角问题热搜里gis尖锐角处理一般角度多大就是典型疑惑。尖锐角本质上是指两条相邻边夹角过小导致拓扑分析、面积计算、出图标注出现异常。角度阈值没有唯一标准更多取决于数据用途。我在实际项目里常用 10 度作为基本检查线宗地、地籍等精度要求高的数据会放宽到 20 到 30 度地形简化场景下 5 度也用过。关键是阈值要写进技能包并说明适用场景。狭长多边形则是另一个常见问题热搜里gis矢量狭长公式怎么算问的就是它的判定方式。工程上最常用的是面积周长比公式也就是 4πA/P²A 是面积P 是周长这个值越接近 1 说明图形越接近圆越小说明越狭长。我一般把小于 0.1 的图斑标记为疑似狭长再结合长边与短边比做二次确认。还有一种更直接的算法用最小面积外接矩形计算长宽比超过 5:1 就认为狭长。不同方法适用不同数据形态建议在技能库里同时保存两种公式并注明适用条件。2.2 拓扑检查的完整流程与重叠面修复方法热搜里gis内拓扑完整过程和gis 同一图层两个面要素 重叠其实指向同一类问题要素之间的空间关系正确性。完整流程我通常是四步走创建拓扑规则。ArcMap 里右键数据集新建拓扑Pro 里用添加拓扑规则最常见规则是不能重叠不能有缝隙不能悬挂。设置容差。这个值很关键我一般按数据精度的两倍设置比如源数据是 1:10000容差设为 2 米左右。容差设大了会把细小地物吃掉设小了又查不出问题。验证并导出错误。验证完成后会生成错误点/错误面单独打开错误图层查看位置和类型。修复。重叠要素用融合或擦除缝隙问题用捕捉修正共享边悬挂线则看情况修剪或延伸。修复这一步最容易出问题很多人直接在编辑器里手动拖动节点改完一个地方又出现新的拓扑错误。我的习惯是先用必须被其他要素覆盖这类规则兜底再处理具体错误。另外同一图层两个面要素重叠时最好先看属性表确认是不是数据重复采集再决定是合并还是删除不要盲目执行消除重叠。2.3 批量出图、编号顺排和点转面的实用套路gis数据驱动页面批量出图是 ArcMap 的老功能在 Pro 里叫布局系列。批量出图的关键是提前建好索引图层按属性字段分页。我常用的是按行政区代码分页每个页面动态显示该图斑的编号、面积和坐标。这里有个容易被忽略的点动态文本里如果引用了字段字段名里尽量不要带空格或特殊字符否则出图时经常显示为空。gis编号顺排的常规做法是空间排序。许多人的误区是直接按属性表顺序编号但这跟空间位置毫无关系正确做法是先按要素中心的 X/Y 坐标排序再编号。我的经验是先按 Y 坐标从大到小排再按 X 坐标从小到大排这样能得到一个从上到下、从左到右的效果比较接近人眼阅读顺序。至于gis 根据点提取面工具上可以直接用点集转面Points To Line 再 Feature To Polygon也可以按业务规则用泰森多边形划分势力范围但要注意点集转面的输出结果依赖点的顺序点序混乱时会出现自交面需要用排序点序的方式先处理。3. SKILL 线把 GIS 经验变成 AI 能读懂的技能3.1 skill 和普通脚本的区别在哪第一次看到 codex skill、claude code skill 这类概念的人容易把 skill 理解成插件或脚本其实差别挺大。插件是程序直接执行脚本是代码也需要运行环境而 skill 更多是指导 AI 的说明文档 少量示例它不直接运行而是告诉大模型当用户提出某类问题时你应该按什么步骤、参考什么规则来生成答案或代码。换句话说插件是替你做skill 是教 AI 怎么做。这个差别在 GIS 场景里特别重要因为 GIS 处理往往不是单条命令能完成的。比如核密度计算报错这个问题普通脚本只会返回一个报错而一个写好的 skill 会包含先检查输入字段是否为数值型再确认处理范围和像元大小配置最后给出重试代码。这其实是把老师傅的排查思路搬给了 AI。3.2 手写一个 GIS 专用 skill 的完整结构skill怎么写是热搜里出现频率最高的词。我结合自己写 codex、claude code、cursor skill 的经验总结出一份最小可用结构--- name: gis-topology-check description: 用于 GIS 拓扑检查与重叠修复的辅助技能 --- ## 适用场景 需要检查同一图层面要素重叠、缝隙或悬挂边时使用。 ## 执行步骤 1. 判断坐标系确认是否为投影坐标系。 2. 输出拓扑容差建议值默认按数据精度两倍。 3. 给出创建拓扑规则的代码或操作路径。 4. 验证后导出错误图层。 5. 根据错误类型提供修复方案。 ## 参数说明 - tolerance: 容差默认 0.001 米需按实际精度调整。 - overlap_action: 重叠处理方式可选 merge / erase / manual。 ## 示例 用户输入我有两个面的 shapefile重叠了怎么处理 输出先运行 gis-topology-check再按 overlap_action 给出清洗代码。这里 YAML 头部的 name 和 description 非常重要AI 工具靠 description 来决定什么时候调用这个 skill写得太宽泛会导致乱触发写得太窄又召不回。我的经验是 description 里把触发场景写具体比如用户提到拓扑、重叠、缝隙、悬挂其中之一时可用。3.3 在 codex、claude code、cursor 里安装验证不同工具的 skill 加载方式大同小异。codex 通常在项目目录下放 .codex/skills/ 文件夹每个 skill 一个子目录claude code 用 .claude/skills/cursor 则是通过规则文件或项目级 .cursor/rules 来加载类似内容。安装步骤基本是三步建目录、放 markdown、重启或重新加载会话。我实测下来的感受是GIS 方向最适合用 skill 封装的任务是那些步骤固定但参数经常变的工作比如坐标系转换、字段计算、批量裁剪。我写了一个 field-calculator-round 的 skill专门处理保留两位小数的需求把 round 的各种写法字段计算器、Python、SQL都收进去了。以前新手老问gis保留两位小数round怎么写现在直接把 skill 丢给 AI它就会结合具体软件给出对应写法。4. 实操记录从零搭建一套 GIS-SKILL 技能库4.1 技能库的目录、文档和校验规则怎么组织如果你也想搭一套自己的 gis-skill我建议别一上来就追求大而全先从自己最常做的三类任务入手。目录结构可以参考开头的 V5.0 分层但实际文件不需要很多。核心规则部分放坐标系优先级、容差计算、字段命名规范处理技能部分放拓扑、叠加、字段计算、批量出图四个主线AI 提示词部分放 step-by-step 的 prompt 模板。校验规则是容易被忽略的一环。我的做法是在目录里放一个 CHECKLIST.md每条技能都对应一个验收清单。比如拓扑技能必须确认输出中有错误图层路径如果 AI 生成的代码没有导出错误图层就认为这个回答不完整需要补充。这个做法实测对提升 AI 输出质量特别有用相当于给模型加了个隐形考核标准。4.2 几个关键参数的推荐取值与计算方式整理技能库时把参数单独成文很有价值。下面是我在项目里沉淀下来的一批推荐值不算标准答案但适合作为初始参考参数推荐取值适用场景备注尖锐角阈值10° / 20° / 30°地籍、规划、地形简化精度要求越高取值越小拓扑容差数据精度 × 2矢量数据检查与坐标系单位一致狭长图斑判定4πA/P² 0.1图斑筛查或用外接矩形长宽比 5字段保留小数round(字段, 2)面积/长度计算数据库用 Decimal 更稳妥核密度像元大小默认 1/1000 数据范围核密度分析过大锯齿明显过小计算慢这里特别说明一下核密度像元大小。很多人直接默认输出不调整结果栅格锯齿非常明显。我一般先看数据范围然后用范围边长除以 1000 左右作为初值再根据效果微调。计算太慢时优先增大像元而不是直接降低搜索半径。4.3 我实测中的一次完整调用过程我在 cursor 里加载了一个 gis-buffer-clip 的 skill然后输入一句话帮我做缓冲区并对每个区县分别裁剪。skill 里的执行步骤马上就生效了它先确认了输入的区县边界是否投影坐标系然后自动生成了一段 ArcPy 代码循环对每个区县要素执行 buffer 和 clip中间还自动把输出路径按区县名称命名。整个过程没有出现乱码、路径错误或坐标系不匹配的问题。关键是我提前在 skill 里写了一条规则输出必须是完整可运行的 Python 脚本不允许返回片段。这个约束非常有效否则 AI 经常只给出一小段逻辑还是要自己拼。后续我又加了一条脚本运行前必须先打印坐标系信息方便我一眼确认投影是否正确。这算是我自己写 skill 时比较满意的两个小技巧也放进了经验库。5. 常见问题排查与避坑实录5.1 GIS 高频报错速查表我把这些年遇到最多的问题整理成了一张速查表也是我技能库里 error-db 的基础内容问题现象常见原因排查顺序核密度计算报错 ERROR 010024输入字段非数值型、处理范围设置异常、像元大小不合理先查字段类型再看环境设置范围最后调像元大小license 许可证启动不了服务未启动、授权过期、hostid 变化、防火墙拦截先看服务管理器再检查授权文件有效期最后关防火墙测试链接许可证管理器时出现问题许可证服务器地址写错、端口被占用确认 server 地址和端口换 27005 或 27000 测试ArcGIS Pro 里 shp 文件找不到没添加文件夹连接只连接了默认地理数据库在目录面板添加源文件所在文件夹连接正摄影像压缩后发虚压缩格式不当、分辨率过低、分块过大改用 JPEG2000 或 MrSID控制压缩比在 20% 以内5.2 容易被忽略的几个坑坐标系、精度、压缩先说坐标系这是 GIS 技能库里最应该放在最前面的规则。操作任何数据之前先确认它是不是投影坐标系否则很多东西算出来都是错的。比如面积字段如果用的是地理坐标系的经纬度round 之后数字虽然对但单位还是度完全没有业务价值。我习惯在技能库里强调一条先投影再操作。再一个是gis中作图时怎么在四个角标注坐标值。这看起来是小事实则和坐标系强相关。如果你用动态文本插入了经纬度坐标但数据本身是投影坐标系标注出来的可能是米制数值而不是经纬度。正确做法是在布局里添加经纬度格网再设置标注格式为十进制度数或度分秒。没有经验的人往往直接改数字格式结果怎么改都不对。最后聊下压缩。正射影像压缩到 JPEG 格式确实快但多次压缩会产生明显锯齿。我现在的习惯是需要切图就存 JPEG2000 或 MrSID配合金字塔文件速度和体积都兼顾。压缩比保持在 20% 以内肉眼几乎看不出区别。这个经验也写进了我的 GIS 技能库现在每次处理影像前 AI 会自动提醒我确认压缩格式省掉了反复返工的麻烦。说实话从 V1.0 到现在 V5.0我最深的体会是GIS 这个领域从来不缺技巧缺的是把技巧结构化的习惯。以前写文档写完之后基本不回头看后来做成技能库每次调用都是对经验的一次校准改一个参数、补一条报错记录整个库就往前迈了一步。如果你也在做类似的整理我建议先挑一件自己每周都要做的 GIS 任务把它写成 skill装进常用的 AI 工具里跑一周看看哪里卡壳再改。不用追求一次做完整套体系你先有一套能用的就已经比大多数人走得远了。本文还有配套的精品资源点击获取