supermap-iclient-mapboxgl-skills

name	supermap-iclient-mapboxgl-skills
description	生成 SuperMap iClient for MapboxGL 代码片段和完整 HTML 示例，覆盖地图加载、图层管理、数据查询、空间分析、MapboxGL API 用法等场景，以及 iServer REST 服务、GeoJSON、WMTS/WMS、矢量瓦片等数据源接入。

SuperMap iClient for MapboxGL Skills

概述

本技能辅助开发者生成 SuperMap iClient for MapboxGL 的代码片段和完整 HTML 文件。采用两层策略：

• metadata/：完整 JSDoc JSON 元数据，优先查阅，用于 API 精确查询（参数名、类型、返回值结构等）
• modules/：高频场景的预构建模板，作为补充，提供参数说明、返回结果示例、完整可运行代码

行为规则（CDN 约束、API 选择、错误预防等）见 prompts/system-prompt.md。

目录结构

skills/
├── templates/        index.html
├── modules/
│   ├── core/         init-map.md, empty-map.md
│   ├── mapping/      add-geojson.md, vector-tile.md, WMTS.md, WMS.md
│   ├── services/     feature-service.md, query-service.md, buffer-analysis.md
│   └── utils/        ogc-capabilities.md, rest-data-vector.md
├── metadata/
│   ├── iclient-mapboxgl/   # SDK API（JSDoc JSON）
│   └── mapbox-gl-enhance/  # 原生 API + enhance 扩展（index.d.ts, style-spec.json）
├── rules/            intent-mapping.json, url-patterns.json, param-defaults.json,
│                     coordinate-system.md, error-handling.md
└── prompts/          system-prompt.md, fallback-questions.md, few-shot-examples/

工作流

用户请求
  ↓
识别意图（关键词 → rules/intent-mapping.json）
  ↓
优先从 metadata/iclient-mapboxgl/ 检索 API
  ↓
检索成功 → 使用 metadata 参数定义，从 modules/ 获取代码示例
检索失败 → 尝试 modules/ 中是否有相似模板
  ↓
参数缺失 → 用 prompts/fallback-questions.md 补问
  ↓
生成完整 HTML / 代码片段

各目录职责

场景	来源	说明
参数名、参数类型、返回值结构	metadata/	JSDoc 是权威来源
代码示例、模板、最佳实践	modules/	补充说明，提供完整可运行示例
业务规则、叠加要求、坐标系说明	rules/	校验和约束条件
URL 格式校验	rules/url-patterns.json	不依赖 JSDoc（JSDoc 中 URL 类型仅为 string）
CDN、API 选择、错误预防	prompts/system-prompt.md	AI 行为规则，权威约束来源

限制与指南

modules 仅包含高频模式

• ✅ 包含：地图初始化、GeoJSON/矢量瓦片/WMTS/WMS 图层、SQL/几何/缓冲区查询、缓冲区分析
• ❌ 不包含：叠加分析、插值分析、量算、网络分析等 — 通过 metadata 检索对应 API

模块新增标准

仅在满足以下条件时才添加新模块：

• 频率：多次用户请求表明为高频需求
• 明确性：存在稳定且清晰的最佳实践，变体少
• 互补性：填补核心工作流缺口（非小众场景）

开发原则

• 以元数据为权威：模块未覆盖的 API 一律从 metadata 检索并校验
• 可伸缩设计：避免穷举式枚举，优先自助式元数据查询
• 可组合性：modules 提供通用模式，metadata 提供精确细节