opengis-skills

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

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

与 Agent 产品解耦： 全部内容为纯 Markdown，不依赖任何特定 Agent 运行时、私有工具名或专有 API。Claude Code / Cursor / Cline / GitHub Copilot / Codex / Gemini CLI / OpenCode / DeepSeek Harness 等都能直接读取。

---

🤖 AI 入口提示

对于 AI 编程助手（Claude Code、Cursor、Cline、GitHub Copilot、Codex、Gemini CLI、OpenCode、DeepSeek Harness 等）：

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

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

按需加载即可：支持 @文件 语法的工具用 @SKILL.md / @gis/gdal/SKILL.md；CLI Agent 直接给出路径让它自行 read；支持技能目录的宿主可把 // 注册为技能。避免全量注入导致上下文膨胀。

---

🚀 快速开始

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 配置

# Codex / Gemini CLI / Aider / OpenCode 等 CLI Agent
把 SKILL.md 路径作为上下文文件传入，或直接让 Agent 自己 read

# 任何其他工具（含自建 Agent、本地模型、Web 对话）
粘贴 SKILL.md 内容或提供仓库路径即可，无需任何插件

---

📂 目录结构

opengis-skills/
├── SKILL.md         # 🌐 根入口：全局索引 + 标签搜索 + 使用指南
├── gis/             # GIS 类（40 个）
│   └── SKILL.md     # GIS 分类索引
├── cad/             # CAD 类（21 个）
│   └── SKILL.md     # CAD 分类索引
├── csharp/          # C# 框架/库（12 个）
│   └── SKILL.md     # C# 分类索引
├── ai/              # AI 智能体/平台（17 个）
│   └── SKILL.md     # AI 分类索引
├── iot/             # 物联网（4 个）
│   └── SKILL.md     # IoT 分类索引
├── 3d/              # 3D / 高斯泼溅 / 全景 / BIM / CSG（6 个）
│   └── SKILL.md     # 3D 分类索引
├── demos/           # 项目演示（4 个：全景联动 / 地图大屏 / 水务前端 / GeoServer 图层树）
│   └── SKILL.md     # demos 分类索引
└── others/          # 其它（10 个）
    └── SKILL.md     # Others 分类索引

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

---

📑 分类索引文件

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

设计理念： 分类索引文件让 AI 工具在已知用户需求领域时，无需加载 114 个技能的全量索引（根 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 三维数据处理。

🎯 项目演示（demos/）

上游博客「项目演示」分类对应的四个可运行示例工程（Vue 3 + Vite）。

🗂️ 其它（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 表，≥5 行）
   • AI 使用建议（工具无关：执行环境、版本探测、产物验证、常见误操、安全与权限）
   • 相关技能
   • 参考资源

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

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

6. 示例：基于上游官方文档实地核对，避免编造 API；版本号需以 npm view / PyPI JSON / NuGet flatcontainer / GitHub releases/latest 实测，并在头块注明「截至 YYYY-MM」

7. 无 emoji、代码块必须带语言标识、正文中文而 API/命令保留英文原文

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

✅ 校验工具

提交前在仓库根目录执行：

# 结构 + frontmatter + 相对链接 + 索引一致性（CI 同款）
python scripts/validate-skills.py .

# 外部链接连通性（可选，需联网；403/SSL 抖动属正常，重点看 404）
python scripts/check-links.py . --workers 32 --timeout 12

validate-skills.py 会检查：frontmatter 三字段、name 与目录名一致、description 以 Use when 开头且 ≤500 字符全英文、tags 5-10 个且格式合法、L3 必备章节（概述/安装/工作流/FAQ/相关）、FAQ 表格 ≥5 行、无 emoji、代码围栏带语言、单文件 ≤500 行、相对链接可达，以及根 SKILL.md、8 个分类索引与 README.md 是否覆盖全部技能。

---

🔗 相关项目

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

---

📜 License

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