# SuperMap-iClientX-AI-context

**Repository Path**: isupermap/supermap-iclientx-ai-context

## Basic Information

- **Project Name**: SuperMap-iClientX-AI-context
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-19
- **Last Updated**: 2026-03-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# SuperMap iClientX AI Context

<p align="center">
  <img src="https://img.shields.io/badge/SuperMap-iClientX-blue" alt="SuperMap iClientX">
  <img src="https://img.shields.io/badge/3D-WebGIS-green" alt="3D WebGIS">
  <img src="https://img.shields.io/badge/License-MIT-yellow" alt="License">
</p>

## 项目简介

本项目基于 [SuperMap iClientX](https://iclient.supermap.io/) 开发，提供实用的二次开发技巧、功能示例、场景代码，帮助 GIS 开发者快速上手 3D WebGIS 开发。这是一个针对 SDK 开发的提升用户 AI 辅助开发效率的 skills 项目。

**技能标准**：本项目的 skills 遵循 [agentskills.io 规范](https://agentskills.io/specification) 中的标准。

## 功能特性

- 🚀 **快速上手** - 提供丰富的代码示例和最佳实践
- 📚 **开发技巧** - 汇总实用的二次开发技巧
- 🎯 **场景示例** - 覆盖常见 3D WebGIS 应用场景
- 🤖 **AI 辅助** - 提升开发效率的 AI 技能支持

## 目录结构

```
supermap-iclientx-ai-context/
├── README.md           # 项目说明文档
├── LICENSE             # MIT 许可证
├── CONTRIBUTING.md     # 贡献指南
├── .gitignore          # Git 忽略文件配置
├── skills/             # AI 技能文件目录
│   └── 12.1.0/        # 对应 SDK 版本号的技能文件
└── test/               # 测试文件目录
    └── Build/          # SuperMap iClientX 产品包（需手动添加）
```

## 快速开始

### 环境要求

- Node.js >= 14.0.0
- 现代浏览器（支持 WebGL）

### 安装

```bash
git clone https://gitee.com/isupermap/supermap-iclientx-ai-context.git
cd supermap-iclientx-ai-context
```

## 使用说明

本项目提供 AI 辅助开发的上下文文件，帮助开发者在使用 AI 编程助手时获得更准确的 SuperMap iClientX 相关代码建议。

### 目录说明

- **skills/**: 存储技能文件的目录，子文件夹以 SDK 版本号命名（如 `12.1.0`）
  - 技能文件夹：使用 kebab-case 命名（如 `create-empty-scene`）
  - 技能文件：固定命名为 `SKILL.md`
- **test/**: 存放测试文件的目录
  - **Build/**: SuperMap iClientX 产品包（需手动添加，已在 .gitignore 中忽略）

### 技能文件命名规范

技能文件采用以下命名规范：

1. **目录结构**：`skills/{version}/{skill-name}/SKILL.md`
   - `{version}`: SDK 版本号，如 `12.1.0`
   - `{skill-name}`: 技能名称，使用 kebab-case 格式（小写字母，单词间用连字符连接）
   - `SKILL.md`: 固定的技能文件名（全部大写）

2. **示例**：
   - `skills/12.1.0/create-empty-scene/SKILL.md`

### 测试技能

如需测试 skills，请按以下步骤操作：

1. 访问 [SuperMap 技术资源中心](https://support.supermap.com/DownloadCenter/ProductPlatform.aspx)
2. 下载对应版本的 SuperMap iClientX 产品包
3. 解压产品包，将 `Build` 文件夹拷贝到项目的 `test` 目录下
4. 在 `test` 目录下运行测试文件

## 相关资源

- [SuperMap iClientX 官方文档](http://support.supermap.com.cn:8090/webgl/web/index.html)
- [SuperMap iClientX API 参考](http://support.supermap.com.cn:8090/webgl/docs/index.html)
- [SuperMap 官网](https://www.supermap.com/)

## 贡献指南

欢迎贡献代码、报告问题或提出建议！请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解详情。

## 开源协议

本项目基于 [MIT](LICENSE) 协议开源。

## 联系方式

如有问题或建议，欢迎通过以下方式联系：

- 提交 Issue
- 发起 Pull Request

---

<p align="center">
  Made with ❤️ by SuperMap iClientX Community
</p>