opengis-skills

面向 AI 编程助手 / Agent 的开源 GIS、CAD、C#、AI、IoT、3D 技能及通用工具（Skill）集合。

本仓库与 znlgis.github.io 上游博客分类完全对齐，便于双向导航与学习。

---

🤖 AI 入口提示

对于 AI 编程助手（Claude / Cursor / Cline / Copilot Chat / DeepSeek 等）：

本仓库的主入口是根目录下的 SKILL.md。该文件包含完整的技能索引、标签搜索系统和按需加载指南，是 AI 工具理解和使用本仓库的第一站。

• 加载 根 SKILL.md → 获取全局索引、标签导航和加载策略
• 加载 分类 */SKILL.md（如 gis/SKILL.md）→ 获取某个领域的技能概要
• 加载 项目 *//SKILL.md → 获取单个工具的深度知识

推荐先用 @SKILL.md 或 @gis/gdal/SKILL.md 等方式按需加载，避免全量注入导致上下文膨胀。

---

🚀 快速开始

AI 工具如何使用本仓库

本仓库采用 三层索引结构，AI 工具可根据用户需求灵活选择加载层级：

典型使用流程

用户提问："帮我把 Shapefile 转成 GeoJSON"
    ↓
AI 加载 @SKILL.md（根），搜索标签 #conversion #vector
    ↓ 或直接定位
AI 加载 @gis/gdal/SKILL.md，获取 GDAL 命令行转换指导
    ↓
AI 根据 SKILL.md 中的 API/命令示例生成代码

加载方式速查

# Claude Code / Claude
@SKILL.md                    # 加载根入口（推荐首次使用）
@gis/gdal/SKILL.md           # 加载 GDAL 技能
@gis/opengis-all/SKILL.md    # 加载 GIS 全流程索引

# Cursor
在 .cursorrules 中引用或在对话中使用 @file 语法

# Cline / Roo Code
直接使用 @ 语法或通过 .clinerules 配置

# VS Code Copilot Chat
通过 /addContext 或 .github/copilot-instructions.md 配置

# DeepSeek Chat
对话中粘贴 SKILL.md 内容或引用文件路径

---

📂 目录结构

opengis-skills/
├── SKILL.md         # 🌐 根入口：全局索引 + 标签搜索 + 使用指南
├── gis/             # GIS 类（24 个）
│   └── SKILL.md     # GIS 分类索引
├── cad/             # CAD 类（20 个）
│   └── SKILL.md     # CAD 分类索引
├── csharp/          # C# 框架/库（9 个）
│   └── SKILL.md     # C# 分类索引
├── ai/              # AI 智能体/平台（10 个）
│   └── SKILL.md     # AI 分类索引
├── iot/             # 物联网（1 个）
│   └── SKILL.md     # IoT 分类索引
├── 3d/              # 3D / 高斯泼溅 / 全景 / BIM / CSG（5 个）
│   └── SKILL.md     # 3D 分类索引
└── others/          # 其它（6 个）
    └── SKILL.md     # Others 分类索引

每个 SKILL 都是一个独立目录，包含一份 SKILL.md，可被 Claude / Cursor / Cline / Copilot Chat / VS Code 等 AI 工具按需加载，作为「领域知识」注入到对话中，从而获得更准确的代码生成与问题排查能力。

---

📑 分类索引文件

除了根目录的 SKILL.md 作为全局入口外，每个分类目录下也设有 分类索引文件（/SKILL.md），作为该领域的二级入口：

设计理念： 分类索引文件让 AI 工具在已知用户需求领域时，无需加载 75 个技能的全量索引（根 SKILL.md），只需加载对应分类索引即可快速定位目标技能。如果用户跨领域提问，再回退到根 SKILL.md。

---

🌍 GIS 类（gis/）

地理信息系统、空间数据处理、地图服务与渲染相关。

---

📐 CAD 类（cad/）

计算机辅助设计、参数化建模、几何运算、BIM 与 PCB 等。

---

🛠️ C# 类（csharp/）

.NET 生态常用框架、ORM、报表与保护工具。

---

🤖 AI 类（ai/）

LLM 应用、智能体、个人 AI 助手与 AI 编程方法论。

---

📡 IoT 类（iot/）

---

🧊 3D 类（3d/）

3D 高斯泼溅（3DGS）、Web 三维可视化与高性能 AEC/BIM 三维数据处理。

---

🗂️ 其它（others/）

---

📝 SKILL 编写规范

每个 //SKILL.md 遵循统一规范，便于 AI 工具与人类阅读：

1. YAML frontmatter（必填字段）：

   ---
   name: 项目英文名
   description: Use when . . Covers .   # 英文 "Use when..." 格式，≤500 字符
   tags:                 # 用于 AI 工具按标签搜索技能
     - 
     - 
     - 
   ---
   

   description 规范： 采用英文 Use when... 格式，描述何时使用该技能（而非描述项目本身），遵循 Anthropic Skill 最佳实践。分类索引用 Use when... Index of N skills: ... 格式。所有 description 均以 Use when 开头、第三人称、≤500 字符。

   tags 字段说明： 每个 SKILL.md 的 frontmatter 中必须包含 tags 数组（必须使用多行 - tag 格式，不使用内联 [tag1, tag2] 格式），列出该技能的关键标签（如 python、geometry、cli、3d 等）。这些标签被根 SKILL.md 的标签索引系统使用，让 AI 工具可以通过标签快速定位相关技能，无需扫描全部文件。

2. 头部引用块：项目地址、官方文档、许可证

3. 正文章节（按需取用，顺序保持稳定）：

   • 概述：定位、特性矩阵
   • 环境准备 / 安装
   • 核心 API / 命令
   • 典型工作流
   • 最佳实践 / 性能优化
   • 常见问题（FAQ 表）
   • 参考资源

4. 风格：中文为主，配合代码示例；命令、API、字段使用代码格式

5. 大小：主文件建议 ≤500 行；超过时将详细参数/示例拆分到 reference/*.md（参见 GDAL 拆分示例：主文件 500 行 + 矢量工具参考 + 栅格工具参考），主文件与 reference 合计通常 300–1500 行

6. 示例：基于上游官方文档实地核对，避免编造 API

参考样板：gis/gdal/SKILL.md、gis/jts/SKILL.md。

---

🔗 相关项目

• znlgis.github.io — 上游中文教程博客（与本仓库分类一一对应）
• Anthropic Claude Skills — Skill 概念与规范
• Cursor Rules / Cline Rules — 客户端约定文件

---

📜 License

本仓库自身代码与文档遵循 LICENSE（MIT）。各 SKILL 中引用、介绍的上游开源项目，请以其各自仓库的许可证为准。