<p align="center">
  <a href="https://opencesium.github.io/SuperGIS-Skills/"><img alt="Homepage" src="https://img.shields.io/badge/homepage-live-1d6fe8?style=flat-square"></a>
  <a href="https://github.com/OpenCesium/SuperGIS-Skills"><img alt="Repository" src="https://img.shields.io/badge/GitHub-OpenCesium%2FSuperGIS--Skills-111827?style=flat-square&logo=github&logoColor=white"></a>
  <img alt="21 libraries" src="https://img.shields.io/badge/libraries-21-1d6fe8?style=flat-square">
  <img alt="6262 examples" src="https://img.shields.io/badge/examples-6262-1d6fe8?style=flat-square">
  <img alt="skill name supergis" src="https://img.shields.io/badge/skill-supergis-334155?style=flat-square">
</p>

# SuperGIS Skills

地图与地理可视化的 Agent Skill。一份技能覆盖 21 个库、6262 条官方案例。对话里点名哪个库，代理就打开该库的索引，按对应示例写出完整代码。

[项目首页](https://opencesium.github.io/SuperGIS-Skills/) · [github.com/OpenCesium/SuperGIS-Skills](https://github.com/OpenCesium/SuperGIS-Skills) · 开发者微信 `trampjwl`

One skill for web maps. Name a library, and the agent writes that library’s official example in full.

## 调用

技能名是 `supergis`。

```text
调用 supergis 的 mapbox 模块
```

`mapbox` 可换成 `cesium`、`openlayers`、`tianditu`、`supermap`，或下面任意一个库名。

`SKILL.md` 把请求送到 `modules/<库>/index.md`。索引中的每一条对应官方案例目录中的一条，示例文件里是完整写法：引入、初始化、能力调用、页面挂载与销毁。密钥写成 `YOUR_TOKEN`。Mapbox 收录公开示例文档。

## 安装

克隆后保持目录名为 `SuperGIS-Skills`，`SKILL.md` 位于该目录根部。

```bash
git clone https://github.com/OpenCesium/SuperGIS-Skills.git SuperGIS-Skills
```

多数代理读取这两处：

```text
<项目>/.agents/skills/SuperGIS-Skills/
~/.agents/skills/SuperGIS-Skills/
```

只扫描自家目录的代理，把同一份文件夹复制过去。

| 代理 | 项目内 | 用户目录 |
| --- | --- | --- |
| Agents / Codex | `.agents/skills/SuperGIS-Skills/` | `~/.agents/skills/SuperGIS-Skills/` |
| Cursor | `.cursor/skills/SuperGIS-Skills/` | `~/.cursor/skills/SuperGIS-Skills/` |
| Claude | `.claude/skills/SuperGIS-Skills/` | `~/.claude/skills/SuperGIS-Skills/` |

`.github/skills/`、`.gemini/skills/`、`.cline/skills/`、`.opencode/skills/`、`.windsurf/skills/`，以及这些名字在用户主目录下的对应位置，同样放入这份 `SuperGIS-Skills`。

## 目录

```text
SuperGIS-Skills/
├── SKILL.md                 技能入口，按库名路由
├── core/                    坐标系、密钥、选库、天地图 WMTS
└── modules/<库>/
    ├── index.md             该库的官方案例目录
    └── examples/<示例>.md    一条完整写法
```

## 收录

共计 6262 条。计数与各库官方案例目录一一对应。

### 地图引擎

| 库 | 能力 | 示例 |
| --- | --- | ---: |
| OpenLayers | 专业二维、投影、WMS、WMTS | 286 |
| Cesium | 三维地球、地形、3D Tiles | 310 |
| Leaflet | 轻量二维地图 | 15 |
| MapLibre | 开源矢量切片 | 141 |
| Mapbox | 样式与地理编码 | 168 |
| maptalks | WebGL 二维与 2.5D | 416 |
| ArcGIS | ArcGIS Maps SDK | 412 |
| GeoScene | 易智瑞，单独成库 | 52 |
| Google Maps | 海外地图 | 202 |

### 国内平台

| 库 | 能力 | 示例 |
| --- | --- | ---: |
| SuperMap | 超图 iClient | 1733 |
| MapGIS | 中地 MapGIS | 706 |
| 高德 | 高德 JS API | 186 |
| 百度 | 百度地图 JS API | 234 |
| 腾讯 | 腾讯位置服务 GL | 59 |
| 天地图 | 政务底图与 JS API 4.0 | 122 |
| 苍穹 KQGIS | KQGIS 二维示例 | 218 |
| 四维图新 | 四维地图 JS SDK | 37 |

### 可视化

| 库 | 能力 | 示例 |
| --- | --- | ---: |
| Three.js | 模型、着色器、粒子 | 616 |
| deck.gl | 海量点线面与网格 | 94 |
| AntV L7 | 地理可视化 | 103 |
| MapV | 点线面可视化 | 152 |
