用途:在服务端为 SaaS 应用实现位置功能时使用,例如最近邻查询、半径内检索、路径规划、服务范围、用户绘制的地理围栏、流域与覆盖图、空间连接、地图瓦片生成,以及带地址、边界或路线的数据建模。
主要能力:指导 PostGIS 与 MySQL 空间、专用存储的选型;规范 SRID 选择(存储用 EPSG:4326,度量运算转 3857 或 UTM 区带如 32636);区分 geometry 与 geography 的适用场景;要求空间列建立 GIST 索引,写入密集的大表可考虑 BRIN,并在批量导入后 ANALYZE、用 EXPLAIN ANALYZE 验证索引命中。给出常用空间 SQL 形态,包括 ST_DWithin 半径查询、ST_Contains 点在多边形内、ST_Intersects 相交、ST_Buffer 与 ST_Union 生成服务区、以及基于 <-> 的 KNN 最近邻查询;还覆盖 MVT 瓦片函数、地理编码缓存模式、MySQL 与 PostGIS 单向同步、pg_dump/pg_restore 备份与 ogr2ogr 格式转换,以及启用 RLS 的租户隔离策略。
使用方式:先阅读 SKILL.md,再按需加载 references 中的深入文件,遵循有序指导、检查清单与决策规则,而非摘取孤立片段;明确交付物(设计、代码、评审、迁移计划、审计或文档)。需要 Postgres 基础时加载 postgresql-fundamentals,前端消费可加载 gis-mapping,多租户模式可加载 database-design-engineering。
适用场景与限制:面向需要可复用判断与领域约束的服务端空间任务;不适用于与空间后端无关或仅需简单回答的问题。原文未提供具体版本号、收费方式与性能基准数据,暂未提供。常见反模式包括用两个 double 列手工算距离、以度为单位计算距离、缺少 GIST 索引、SRID 不匹配、混用 geometry 与 geography 不加显式转换、大表直接 ST_Distance 而不先用 ST_DWithin 预过滤、存储投影坐标以及未启用 RLS 导致跨租户查询。