@dsh-gis/dsh-opengis-skill 0.1.2 → 0.1.3

package/assets/geopipe-agent/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: geopipe-agent
-description: "Use when building AI-driven GIS data pipelines with YAML-defined steps — format conversion, spatial validation, QC reporting, and self-extending capability gaps. GeoPipe Agent: YAML-driven GIS ETL pipeline agent with a built-in offline GIS knowledge layer."
+description: "Use when building YAML GIS pipelines with GeoPipeAgent — geopipe-agent validate/run, io.read_vector → vector.buffer → io.write_vector chains, 33 built-in steps, qc.geometry_validity/attribute_completeness/topology, native_python|qgis_process|gdal_cli backends, $step.output refs; also for validate \"not registered\" errors, silent when-condition skips, and resolve/knowledge capability gaps. 0.1.0, source install only (not on PyPI)."
 tags:
   - gis
   - agent
@@ -247,26 +247,16 @@ QC 步骤遵循 **「检查即透传」** 模式：输入数据原样通过为 `
 | 网络分析 | `io.read_vector → network.shortest_path → network.service_area → io.write_vector ×2` |
 | 空间聚类 + 热力图 | `io.read_vector → analysis.cluster(dbscan) → analysis.heatmap → io.write_vector + io.write_raster` |
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **理解需求**：用户要做什么 GIS 分析？
-2. **列出可用步骤**：`geopipe-agent list-steps` 或查阅步骤表
-3. **编写 YAML**：按 `io.read_vector → 处理步骤 → io.write_vector` 模式编排
-4. **加入 QC**：在关键步骤前后插入质检步骤
-5. **执行**：`geopipe-agent run pipeline.yaml`
-6. **解读结果**：检查 JSON 报告中的 `qc_summary` 和统计信息
-
-### 关键注意事项
-
-- **步骤 ID 规则**：只能用小写字母、数字、下划线和连字符，不能含点号（`.` 保留用于属性引用）
-- **引用链完整性**：确保每个 `$step_id` 引用的步骤在当前步骤之前定义
-- **QC 链式调用**：QC 步骤可串联（如 `qc.geometry_validity → qc.attribute_completeness → qc.topology`），问题汇总到管道报告的 `qc_summary` 中；请使用 `geopipe-agent list-steps --category qc` 列出的真实步骤 ID，写错 ID 会导致校验失败
-- **后端选择**：默认 `native_python`（纯 Python，无外部依赖）；可在步骤上用 `backend: <名称>` 指定 gdal_cli / gdal_python / qgis_process / pyqgis / generic_cli / curl_api，用 `geopipe-agent backends` 查看当前环境可用后端。注意：**只有声明了 backends 的步骤会读取该字段**（当前为 6 个矢量步骤），其余步骤写 `backend:` 会被忽略
-- **路径使用绝对路径**：避免工作目录问题
-- **未实现的能力**：若某个步骤 ID 尚未实现，`validate` 会直接报错；此时不要猜测参数，改用 `geopipe-agent resolve "<需求>"` 获取候选能力与回退路径
-- **大数据注意**：管道在内存中运行，超大栅格建议先裁剪
+- **加载与引用**：用 `skill("geopipe-agent")` 加载（用户也可输入 `/geopipe-agent`）；`reference/steps-reference.md`、`pipeline-schema.md`、`workflows.md`、`self-extension.md` 按需 `read`，路径相对加载结果中的 Base directory；技能目录只读，YAML 与输出写到会话工作区。
+- **执行环境**：命令交给 dsh 的 shell 工具（Windows 用 `pwsh`）；`python` 可能指向 QGIS/GDAL 自带解释器，建议在工作区建独立 venv 后 `pip install -e .`，避免污染系统环境。
+- **源码安装（未上 PyPI）**：`git clone https://github.com/znlgis/GeoPipeAgent.git && pip install -e ".[analysis,network]"`；验证 `geopipe-agent --help`、`geopipe-agent list-steps --category qc`、`pip show geopipe-agent | Select-String Version`。不要写 `pip install geopipe-agent`——PyPI 上还没有这个包。
+- **先探测能力**：`geopipe-agent backends` 看当前环境可用后端（默认 `native_python`），`geopipe-agent list-steps --format json` 拿真实步骤 ID；`validate` 报 `not registered` 时先用 `geopipe-agent resolve "<需求>"` 与 `knowledge search`，不要猜参数。
+- **验证产物**：`geopipe-agent validate pipeline.yaml` 通过后再 `run pipeline.yaml`，检查 JSON 报告里的 `qc_summary` 与各步骤统计，随后重开输出文件核对（`geopipe-agent info output/result.geojson`，装了 GDAL 时也可 `ogrinfo -so output/result.geojson result`），确认要素数与 CRS 而不是只看“执行成功”。
+- **典型误操**：步骤 ID 不能含点号，`$step_id` 必须由更早步骤提供，`when` 引用不存在的属性会按 false **静默跳过**；`backend:` 只有声明了 backends 的 6 个矢量步骤会读取，其余步骤写了也被忽略。
+- **性能与内存**：管道全程在内存中运行，超大栅格先 `raster.clip` 或 `io.read_raster` 只读所需波段；QC 步骤是“检查即透传”，`output` 就是输入，问题在 `$step.issues` / `issues_gdf`。
+- **安全与权限**：`network.geocode` 与 `curl_api`、`http.request` 会把数据发到外部服务，执行前确认是否允许出网并检查 `user_agent`/凭据；`pip install`、覆盖已有输出文件、批量改写数据前先征得用户同意。
 
 ---
 

package/assets/geoserver/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: geoserver
-description: "Use when deploying OGC-compliant map services (WMS, WFS, WMTS, WCS) or configuring SLD styling, security, and tile caching. GeoServer: the leading open-source Java map server for publishing spatial data to the web."
+description: "Use when deploying GeoServer 3.0.x to publish WMS/WFS/WMTS/WCS/MVT, or configuring SLD/CSS styles, RBAC security, and GeoWebCache seeding. Covers geoserver-3.0.2-bin.zip, docker.osgeo.org/geoserver:3.0.2 on Java 17/21, /rest/about/version.json, blank GetMap from wrong native bounds, and Shapefile charset mojibake."
 tags:
   - java
   - server
@@ -20,7 +20,9 @@ tags:
 >
 > **下载：** <https://geoserver.org/release/stable/>
 >
-> **最新版本：** 3.0.1（截至 2026-10，[官方下载](https://geoserver.org/release/stable/)）
+> **最新版本：** 3.0.2（2026-10-19，安全修复版，生产应优先升级；[官方下载](https://geoserver.org/release/stable/)）
+>
+> **运行环境：** Java 17 或 21；3.0.2 内含 GeoTools 35.2、GeoWebCache 2.0.2
 >
 > **许可证：** GPL-2.0
 
@@ -41,11 +43,15 @@ GeoServer 提供：
 
 ## 安装部署
 
+### 前置：JDK
+
+3.0.x 需要 **Java 17 或 21**；先 `java -version` 确认（低于 17 的 JVM 无法启动 3.x 分发包）。
+
 ### 二进制
 
 ```bash
-wget https://sourceforge.net/projects/geoserver/files/GeoServer/3.0.1/geoserver-3.0.1-bin.zip
-unzip geoserver-3.0.1-bin.zip && cd geoserver-3.0.1
+curl -fLO https://sourceforge.net/projects/geoserver/files/GeoServer/3.0.2/geoserver-3.0.2-bin.zip
+unzip geoserver-3.0.2-bin.zip && cd geoserver-3.0.2
 sh bin/startup.sh         # http://localhost:8080/geoserver  (admin/geoserver)
 ```
 
@@ -56,7 +62,7 @@ docker run --name gs -p 8080:8080 \
   -e SKIP_DEMO_DATA=true \
   -e EXTRA_JAVA_OPTS="-Xms512m -Xmx2g" \
   -v $PWD/data:/opt/geoserver_data \
-  docker.osgeo.org/geoserver:3.0.1
+  docker.osgeo.org/geoserver:3.0.2
 ```
 
 ### 数据目录
@@ -169,7 +175,7 @@ curl -u admin:geoserver -XPOST \
 
 ## 典型工作流
 
-1. **部署 GeoServer**：优先使用 Docker 镜像 `docker.osgeo.org/geoserver:3.0.1`
+1. **部署 GeoServer**：优先使用 Docker 镜像 `docker.osgeo.org/geoserver:3.0.2`（安全修复版；从旧版本升级前先备份数据目录）
 2. **创建 Workspace**：为每个项目创建独立工作空间实现命名隔离
 3. **添加数据存储**：根据数据类型选择 PostGIS（矢量）、Shapefile（文件矢量）、GeoTIFF（栅格）
 4. **发布图层**：设置 SRS（坐标参考系）、计算 Native Bounds、配置样式
@@ -202,26 +208,15 @@ curl -u admin:geoserver -XPOST \
 
 ---
 
-## AI 使用建议
-
-
-### 关键注意事项
+## DeepSeek Harness 使用建议
 
-- **数据源编码**：Shapefile 中文乱码时在 Store 设置 `charset=UTF-8` 或 `GBK`
-- **Native Bounds**：必须正确计算图层的原始范围，否则 WMS 请求可能返回空白
-- **级联删除**：删除 Workspace/Store 时添加 `?recurse=true` 参数
-- **JVM 调优**：生产环境建议 `-Xms2g -Xmx4g -XX:+UseG1GC`
-- **CORS 配置**：跨域访问需在 `web.xml` 中配置 CORS 过滤器
-- **SLD 样式**：使用 SLD Cookbook 快速参考常用样式模板
-
-### 常见配置模式
-
-```text
-工作空间(Workspace)
-  ├── 数据存储(Store) ─→ PostGIS / Shapefile / GeoTIFF
-  │    └── 图层(Layer) ─→ 设置 SRS + 绑定样式(Style)
-  └── 图层组(LayerGroup) ─→ 组合多个图层统一发布
-```
+- **加载与引用**：`skill("geoserver")` 加载；技能目录只读，SLD、脚本、日志等产物写到会话工作区。
+- **执行环境**：命令交给 dsh 的 shell 工具（Windows 用 `pwsh`）；`wget`/`unzip` 换成 `curl.exe -LO` 与 `Expand-Archive`，`$PWD` 换成 `(Get-Location)`。
+- **先探测版本**：`curl -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json`（无 jq 时管道给 `python -m json.tool`），核对 GeoServer、GeoWebCache 与 JVM；`java -version` 必须是 17 或 21，否则 3.0.2 包直接启动失败。
+- **验证产物**：发布后用 `curl -s -o out.png -w "%{http_code} %{size_download}\n" "http://localhost:8080/geoserver/my_ws/wms?service=WMS&version=1.1.0&request=GetMap&layers=my_ws:poi&srs=EPSG:4326&bbox=...&width=512&height=512&format=image/png"`，要 200 且字节数大于 0；再拉一次 `GetCapabilities` 确认图层已注册，不要只凭 UI 回显。
+- **写后回读**：REST 建 workspace/store/layer 或上传 SLD 后，用同路径 GET 回读；`?recurse=true` 删除后再 GET 应得 404。
+- **安全与权限**：`admin:geoserver` 凭据不要回显到命令输出或报告里（用环境变量传入）；重启容器、改 `-Xmx`、删除 workspace、清 GWC 缓存前先征得用户同意。
+- **常见误操作**：WMS 返回空白图先查 native bounds 与 SRS 是否对不上；Shapefile 中文乱码改 Store 的 `charset`；seed 大范围瓦片会撑爆磁盘，先小 zoom 范围试。
 
 ## 相关技能
 

package/assets/geoserver-cloud/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: geoserver-cloud
-description: "Use when deploying GeoServer on Kubernetes as cloud-native microservices with auto-scaling, service discovery, and centralized configuration. GeoServer Cloud: break monolithic GeoServer into independently scalable WMS/WFS/WCS services."
+description: "Use when deploying GeoServer Cloud 3.0.2 on Docker Compose or Kubernetes — gateway serving WMS/WFS/WCS/WPS/GWC microservices under /geoserver/cloud, PgConfig vs datadir backends, RabbitMQ config-bus sync, Helm chart geoservercloud 3.0.2, and diagnosing 502s via actuator/health and Consul registration."
 tags:
   - java
   - server
@@ -18,9 +18,9 @@ tags:
 >
 > **官方文档：** <https://geoserver.org/geoserver-cloud/>
 >
-> **Docker Hub：** <https://hub.docker.com/u/geoservercloud>（镜像标签与 GeoServer 主版本对应，如 `3.0.1.1`）
+> **Docker Hub：** <https://hub.docker.com/u/geoservercloud>（镜像标签与 GeoServer 主版本对应，如 `3.0.2`）
 >
-> **最新版本：** 3.0.1.1（截至 2026-10，[GitHub Releases](https://github.com/geoserver/geoserver-cloud/releases)）
+> **最新版本：** 3.0.2（2026-10-20，[GitHub Releases](https://github.com/geoserver/geoserver-cloud/releases)）
 >
 > **许可证：** GPL-2.0
 
@@ -98,7 +98,7 @@ PGCONFIG_SCHEMA: "pgconfig"          # 启动时自动创建 schema
 ## Kubernetes（Helm）
 
 ```bash
-# Chart：camptocamp/helm-geoserver-cloud（chart 名 geoservercloud，最新 3.0.1）
+# Chart：camptocamp/helm-geoserver-cloud（chart 名 geoservercloud，最新 3.0.2）
 helm repo add geoserver-cloud https://camptocamp.github.io/helm-geoserver-cloud
 helm repo update
 ```
@@ -110,7 +110,7 @@ helm repo update
 > dependencies:
 >   - name: geoservercloud
 >     repository: https://camptocamp.github.io/helm-geoserver-cloud
->     version: 3.0.1
+>     version: 3.0.2
 > ```
 >
 > ```yaml
@@ -182,7 +182,7 @@ management:
 ```bash
 docker run -e SPRING_PROFILES_ACTIVE=datadir \
   -v /mnt/gsdata:/opt/app/data_directory \
-  geoservercloud/geoserver-cloud-wms:3.0.1.1
+  geoservercloud/geoserver-cloud-wms:3.0.2
 ```
 
 ---
@@ -247,25 +247,15 @@ kubectl -n gis get deploy | grep wms
 kubectl -n gis scale deploy <wms-deployment> --replicas=10
 ```
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **确定架构**：根据业务需求选择配置后端（生产推荐 PgConfig）
-2. **部署基础设施**：先部署 RabbitMQ + PostgreSQL（PgConfig 目录库），再启动微服务
-3. **启动服务**：下载官方稳定版 docker-compose 文件或用 Helm Chart 部署
-4. **验证服务**：通过 Gateway (`localhost:9090/geoserver/cloud`) 访问 Web UI
-5. **配置监控**：启用 Prometheus + Grafana 监控各微服务状态
-6. **弹性伸缩**：按负载独立扩缩 WMS/WFS 等服务的副本数
-
-### 关键注意事项
-
-- **启动顺序**：先启动 discovery/Consul → config → 数据库/RabbitMQ → 各业务服务
-- **配置同步**：确保 `GEOSERVER_BUS_ENABLED=true` 且 RabbitMQ 可达
-- **路径前缀**：默认 `GEOSERVER_BASE_PATH=/geoserver/cloud`，构造服务 URL 时不要漏掉
-- **PgConfig 一致性**：多副本共享同一个 PgConfig 数据库实现强一致
-- **JVM 独立调优**：每个微服务根据负载独立设置 `-Xmx`，避免 OOM
-- **不部署不需要的服务**：如不使用 WPS/WCS，直接从 docker-compose 中移除
+- **加载与引用**：`skill("geoserver-cloud")` 加载；技能目录只读，compose/values 覆写文件写到会话工作区。
+- **执行环境**：命令交给 dsh 的 `pwsh`（Windows 无 `wget`，改 `curl.exe -LO`）；先用 `docker version`、`helm version`、`kubectl version --client` 确认工具在 PATH。
+- **先探测版本**：`curl.exe -s -u admin:geoserver http://localhost:9090/geoserver/cloud/rest/about/version.json` 读 GeoServer 版本；`curl.exe -s http://localhost:9090/actuator/health` 取 `{"status":"UP"}`（被 profile 关掉时改用 `kubectl -n gis get pods` 判活）。
+- **验证产物**：部署后逐服务探活，再经网关 `.../rest/workspaces.json` 与一次 WMS `GetMap` 走通全链路；`docker compose ps` 显示 Up 不等于 OGC 服务可用。
+- **排障顺序**：502 → 查 Consul 注册与目标服务健康（`kubectl -n gis logs deploy/<wms>`）；配置不生效 → 查 RabbitMQ 与 `GEOSERVER_BUS_ENABLED`；瓦片 404 → 查 gwc 是否部署、`GEOSERVER_BASE_PATH` 前缀是否一致。
+- **安全与权限**：`admin:geoserver`、`PGCONFIG_PASSWORD`、RabbitMQ 口令不要回显到报告；`docker compose down -v`、`helm uninstall`、删 PVC 或 PgConfig schema 会丢配置，先向用户确认并备份。
+- **先本地复现**：能在 docker compose 复现的问题再上 K8s；镜像标签与 chart 版本保持同一版本号（3.0.2），避免网关与服务错配。
 
 ## 相关技能
 

package/assets/geoserver-rest-api/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: geoserver-rest-api
-description: "Use when automating GeoServer management — programmatic workspace, datastore, and layer creation, style upload, service configuration via REST API. GeoServer REST API: manage GeoServer without GUI using curl, Python, or any HTTP client."
+description: "Use when automating GeoServer 3.0.2 over REST — POST /rest/workspaces, datastores, featuretypes, PUT Shapefile ZIP to file.shp, GeoTIFF to coveragestores, upload SLD as application/vnd.ogc.sld+xml, ?recurse=true deletes. curl -u admin:geoserver, single-key JSON like {\"workspace\":{...}}, 401 on POST but 200 on GET, GWC cache masking style changes."
 tags:
   - rest
   - api
@@ -20,7 +20,7 @@ tags:
 >
 > **API 参考：** <https://docs.geoserver.org/stable/en/user/rest/api/index.html>
 >
-> **最新版本：** GeoServer 3.0.1（截至 2026-10，[官方下载](https://geoserver.org/release/stable/)）
+> **最新版本：** GeoServer 3.0.2（2026-10-19，安全修复版；[官方下载](https://geoserver.org/release/stable/)）
 >
 > **许可证：** GPL-2.0
 
@@ -354,25 +354,15 @@ await workspaceService.CreateWorkspaceAsync("myws");
 
 ---
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **确认 GeoServer 运行**：先验证 `http://localhost:8080/geoserver/rest/about/version.json` 可访问
-2. **创建工作空间**：POST `/rest/workspaces` → 创建命名空间
-3. **添加数据存储**：根据数据类型 POST datastores（矢量）或 coveragestores（栅格）
-4. **发布图层**：POST featuretypes（矢量）或 coverages（栅格）
-5. **配置样式**：POST styles + PUT SLD 文件 → PUT layers 绑定样式
-6. **验证发布**：GET `/rest/layers.json` 确认图层列表，访问 WMS GetMap 测试
-
-### 关键注意事项
-
-- **JSON 包装结构**：GeoServer REST API 的 JSON 请求/响应使用单层包装（如 `{"workspace":{...}}`）
-- **recurse 参数**：删除 Workspace/Store 时务必添加 `?recurse=true` 级联删除
-- **Shapefile 上传**：必须打包为 ZIP（含 .shp/.shx/.dbf/.prj），用 PUT 方式上传
-- **URL 后缀**：可用 `.json` / `.xml` 后缀替代 `Accept` 头指定响应格式
-- **Content-Type**：样式上传使用 `application/vnd.ogc.sld+xml`，栅格上传使用 `image/tiff`
-- **认证**：所有 POST/PUT/DELETE 操作需要 HTTP Basic Auth（默认 admin:geoserver）
+- **加载与引用**：`skill("geoserver-rest-api")` 加载；完整端点清单按需 `read` [reference/endpoints.md](reference/endpoints.md)（路径相对技能 Base directory），不要整份通读。
+- **执行环境**：示例交给 dsh 的 `pwsh`（显式 `curl.exe`，Windows 的 `curl` 是别名、参数不同）；`\` 续行在 pwsh 无效，压成单行；请求体先写成 `body.json`，用 `curl.exe --data "@body.json"` 传，避开各 shell 的引号差异。
+- **先探测版本**：`curl.exe -s -u admin:geoserver http://localhost:8080/geoserver/rest/about/version.json`，确认是 3.0.2 并顺带看到组件版本；返回 401 是凭据/安全规则问题，不是版本问题。
+- **验证产物**：写操作后立刻 GET 回读同一资源（`.../rest/workspaces/myws.json`、`.../rest/layers/myws:roads.json`），再发一次 WMS `GetMap` 取 `image/png` 确认非空图；不要只凭 201 或退出码报告成功。
+- **幂等与坑**：同名资源重复 POST 会报已存在（重跑脚本前先 GET 判断或改 PUT）；改了样式记得清 GWC 缓存，否则瓦片还是旧的。
+- **安全与权限**：`admin:geoserver` 不要硬编码进脚本或回显到报告；`?recurse=true` 删除 workspace、`POST /rest/reset`、清缓存均不可逆，执行前向用户确认。
+- **批量脚本**：循环建资源时检查 `$LASTEXITCODE`，一失败即停；半套配置留在服务端比报错更难排查。
 
 ## 相关技能
 

package/assets/geotools/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: geotools
-description: "Use when building Java GIS applications — feature reading/writing, coordinate transformations, map styling, spatial filters, WMS/WFS clients. GeoTools: the Java GIS toolkit and OGC standards reference implementation."
+description: "Use when building Java GIS apps on GeoTools 35.2 (JDK 17) — org.geotools:gt-main / gt-shapefile / gt-geopkg / gt-epsg-hsql from repo.osgeo.org (not Maven Central), CQL/ECQL filters, CRS.decode plus JTS.transform reprojection, StreamingRenderer PNG output, and disposing DataStore/SimpleFeatureIterator."
 tags:
   - java
   - gis
@@ -18,7 +18,7 @@ tags:
 >
 > **Maven GroupId：** `org.geotools`
 >
-> **最新版本：** 35.1（截至 2026-10，[OSGeo Maven 仓库](https://repo.osgeo.org/repository/release/)）
+> **最新版本：** 35.2（2026-10-16，[OSGeo Maven 仓库](https://repo.osgeo.org/repository/release/)）
 >
 > **许可证：** LGPL 2.1
 >
@@ -60,7 +60,7 @@ GeoTools 发布在 OSGeo Maven 仓库，需在 `pom.xml` 中添加：
 
 ```xml
 <properties>
-    <geotools.version>35.1</geotools.version><!-- 最新稳定版；版本列表见 https://geotools.org/ -->
+    <geotools.version>35.2</geotools.version><!-- 最新稳定版；版本列表见 https://geotools.org/ -->
 </properties>
 
 <dependencies>
@@ -386,25 +386,15 @@ store.dispose();
 
 ---
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **配置 Maven 仓库**：在 `pom.xml` 中添加 OSGeo 仓库（`https://repo.osgeo.org/repository/release/`）
-2. **引入必要模块**：`gt-main`（核心）、`gt-shapefile` / `gt-geopkg`（数据源）、`gt-epsg-hsql`（CRS）、`gt-cql`（查询）、`gt-render`（渲染）
-3. **打开数据源**：使用 `FileDataStoreFinder.getDataStore()`（文件）或 `DataStoreFinder.getDataStore(params)`（数据库）
-4. **执行查询**：使用 `CQL.toFilter()` 构建过滤器 → `featureSource.getFeatures(filter)`
-5. **处理结果**：遍历 `SimpleFeatureIterator`，使用 JTS 几何方法进行空间运算
-6. **释放资源**：`store.dispose()`、关闭 `SimpleFeatureIterator`
-
-### 关键注意事项
-
-- **Maven 仓库必需**：GeoTools 不在 Maven Central，必须配置 OSGeo 仓库
-- **EPSG 数据库**：使用 CRS 功能需引入 `gt-epsg-hsql`，否则 `CRS.decode()` 抛出异常
-- **资源释放**：`DataStore`、`Reader`、`Writer`、`MapContent` 使用后必须调用 `dispose()`
-- **坐标轴顺序**：GeoTools 默认遵循 EPSG 规范（纬度在前），使用 `CRS.decode("EPSG:4326", true)` 强制经度在前
-- **线程安全**：`DataStore` 线程安全可共享；`SimpleFeatureIterator` 非线程安全
-- **JTS 包名**：GeoTools 20+ 使用 `org.locationtech.jts`（GeoTools ≤19 为旧版 `com.vividsolutions.jts`）
+- **加载与引用**：`skill("geotools")` 加载；完整示例在 [reference/vector-io.md](reference/vector-io.md) 与 [reference/raster-rendering.md](reference/raster-rendering.md)，按需 `read`（路径相对技能 Base directory）。
+- **执行环境**：命令交给 dsh 的 `pwsh`；先 `java -version` 与 `mvn -v` 确认 JDK 17，35.x 在 JDK 8/11 下编译即失败。
+- **先探测版本**：`mvn dependency:tree -Dincludes=org.geotools` 确认解析到 35.2 且未被其他依赖压回旧版；`pom.xml` 里必须有指向 `repo.osgeo.org/repository/release/` 的 `<repository>`。
+- **验证产物**：`mvn -q -DskipTests package` 后跑最小读图层程序（`FileDataStoreFinder` → `getFeatures()` → 打印 count 与 CRS）或 `mvn -q test`；`CRS.decode("EPSG:4326")` 抛异常说明缺 `gt-epsg-hsql`。
+- **常见失败信号**：`getDataStore()` 返回 null 或报找不到工厂，是 SPI 模块没进 classpath；出现 `com.vividsolutions.jts` 是包名没升级（GeoTools 20+ 用 `org.locationtech.jts`）。
+- **安全与权限**：测试别全量加载要素到内存（用 `Query` 限制属性与 bbox）；连接串/密码不要回显，对生产库批量写入前先向用户确认。
+- **按需读文件**：本 SKILL 较长，先按章节标题定位，再用 `read` 的 offset/limit 只取相关段，避免整篇占满上下文。
 
 ## 相关技能
 

package/assets/grass-gis/SKILL.md

@@ -328,12 +328,12 @@ grass $HOME/grassdata/ndvi_project/PERMANENT --exec sh -c '
 - **geopandas** — Python 矢量数据分析：[../geopandas/SKILL.md](../geopandas/SKILL.md)
 - **pyqgis** — QGIS Python 绑定：[../pyqgis/SKILL.md](../pyqgis/SKILL.md)
 
-## AI 使用建议
-
-1. **优先单行无头命令**：`grass <project>/<mapset> --exec <module> ...` 或 `grass --tmp-project EPSG:<code> --exec ...`，便于在脚本与 CI 中复现。
-2. **先探查再分析**：`g.list` 列出可用地图、`g.region -p` 查看区域、`t.list` 列出时空数据集，确认现状后再构造命令。
-3. **结构化输出**：需要程序化解析时优先 `format=json`（如 `g.region -p format=json`）或用 `gs.parse_command`，避免解析文本表格。
-4. **注意区域语义**：栅格模块只处理计算区域内的像元，写命令前先确认或设置 `g.region`。
-5. **参数映射**：模块选项与标志位在 Python 中分别对应关键字参数与 `flags`（如 `gs.run_command("r.univar", map="elevation", flags="g")`）。
-6. **错误识别**：GRASS 模块错误以 `ERROR:` 开头且返回非零状态码，据此判断失败原因（地图不存在、区域为空、输出已存在等）。
-7. **覆盖与清理**：重复运行时统一使用 `--overwrite`，或先用 `g.remove` 清理中间地图。
+## DeepSeek Harness 使用建议
+
+- **加载与引用**：用 `skill("grass-gis")` 加载（用户也可输入 `/grass-gis`）；本技能没有 reference 子目录，模块参数用 `r.univar --help` 或官网手册核对；技能目录只读，脚本与导出结果写到会话工作区。
+- **执行环境**：命令交给 dsh 的 shell 工具（Windows 用 `pwsh`；仅暴露 `run_code` 的会话在 `tools.pwsh` 中执行）。正文里 `grass ... --exec sh -c '...'` 的多行引用在 pwsh 下不可靠，改为把模块序列写进 `.py` 脚本（首行 `#!/usr/bin/env python3`），再 `grass --tmp-project EPSG:3857 --exec python3 analysis.py`。
+- **先探测版本**：`grass --version`（应为 8.5.0，LTR 8.4.2）、`grass --tmp-project EPSG:3857 --exec g.region -p`；8.4 之前没有 `grass.tools`，Python 脚本改用 `gs.run_command`。
+- **验证产物**：`--tmp-project` 内的地图最后必须导出——`r.out.gdal input=slope output=/work/slope.tif format=GTiff`，随后 `gdalinfo -json slope.tif` 核对 CRS 与范围；会话内核对用 `g.region -p format=json`、`g.list type=raster`。
+- **区域语义优先**：栅格模块只处理计算区域内的像元，结果范围不对先看 `g.region -p`；重复运行加 `--overwrite`，否则模块报地图已存在并非零退出。
+- **错误识别**：GRASS 模块的失败以 `ERROR:` 开头并返回非零码（如 `Raster map <x> not found`），据此区分地图名、区域为空还是输出已存在问题，不要只读最后一行日志。
+- **安全与权限**：`g.remove`、`--overwrite`、`t.connect` 会改/删地图集数据；`--tmp-project`/`--tmp-mapset` 结束即删除目录，结果必须先导出；启动 Docker 或改文件属主（`--user=$(id -u):$(id -g)`）前先确认写入路径。

package/assets/jts/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: jts
-description: "Use when performing precise 2D computational geometry in Java — spatial predicates (contains, intersects), overlay operations, buffering, triangulation. JTS (Java Topology Suite): the canonical geometry engine used as blueprint for GEOS, Shapely, and NetTopologySuite."
+description: "Use when doing precise 2D computational geometry in Java with org.locationtech.jts:jts-core 1.20.0 — GeometryFactory construction, contains/intersects predicates, overlay via OverlayNGRobust, buffer, STRtree and PreparedGeometry speedups, WKT/WKB/GeoJSON I/O, and fixing TopologyException or unclosed rings."
 
 tags:
   - java
@@ -251,23 +251,15 @@ String geoJson = new GeoJsonWriter().write(buffered);
 
 ---
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **创建几何对象**：始终通过 `GeometryFactory` 工厂方法创建，不要直接 `new`
-2. **格式解析**：从 WKT/WKB/GeoJSON 读入外部数据，使用对应的 Reader
-3. **空间运算**：用 `PreparedGeometry` 加速批量 contains/intersects 判断
-4. **批量查询**：用 `STRtree` 建空间索引后查询
-5. **结果导出**：用 Writer 输出为 WKT/WKB/GeoJSON
-
-### 关键注意事项
-
-- **坐标顺序**：JTS 使用 `(x, y)` 即 `(经度, 纬度)`，注意与部分 GIS 系统的 `(y, x)` 区分
-- **SRID 不参与计算**：JTS 所有计算在笛卡尔平面进行，不处理地球曲率
-- **OverlayNG 优先**：叠加运算优先使用 `OverlayNGRobust.overlay()`，比传统方法更鲁棒
-- **线程安全**：`GeometryFactory` 和 `Geometry` 线程安全；Reader/Writer 非线程安全
-- **有效性检查**：外部导入的几何用 `isValid()` 检查后用 `GeometryFixer.fix()` 修复
+- **加载与引用**：`skill("jts")` 加载；完整运算示例在 [reference/geometry-operations.md](reference/geometry-operations.md)，按需 `read`（路径相对技能 Base directory）。
+- **执行环境**：命令交给 dsh 的 `pwsh`；JTS 只依赖 `jts-core`，Maven Central 直接可解析，不需要额外仓库，JDK 8+ 即可。
+- **先探测版本**：`mvn dependency:tree -Dincludes=org.locationtech.jts` 确认解析到 1.20.0；同时确认 classpath 里没有遗留的 `com.vividsolutions.jts` 旧包。
+- **验证产物**：`mvn -q test`，或最小 main 做 WKT 往返 + `geom.isValid()` + `buffer(0)` 断言；导出 GeoJSON 后用 `GeoJsonReader` 读回比对坐标数，别只看日志。
+- **失败信号**：`TopologyException` 改用 `OverlayNGRobust.overlay()`；`isValid()` 为 false 先 `GeometryFixer.fix()`；结果为空多半是把坐标写成了 `(lat, lon)`。
+- **注意事项**：SRID 在 JTS 里只是元数据、计算全在笛卡尔平面，跨投影需自己先转换；`WKTReader`/`WKTWriter` 非线程安全，不要多线程共享。
+- **性能验证**：批量判断用 `PreparedGeometry` 前后各计时一次（`System.nanoTime()`），用数据证明优化有效，别凭感觉。
 
 ## 相关技能
 

package/assets/leaflet/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: leaflet
-description: "Use when adding lightweight interactive 2D maps to web pages — tile layers, markers, GeoJSON overlays, layer control, popups. Leaflet: compact, mobile-friendly open-source JavaScript web mapping library."
+description: "Use when adding lightweight 2D tile maps to web pages with leaflet 1.9.4 — L.map/L.tileLayer, markers, popups, GeoJSON overlays, layer control, [lat, lng] ordering, or debugging blank maps, broken default marker icons after bundling, and sizing fixed by invalidateSize()."
 tags:
   - javascript
   - web
@@ -341,10 +341,13 @@ export default function MapView() {
 - **cesiumjs** — 三维地球与 3D Tiles 可视化：[../cesiumjs/SKILL.md](../cesiumjs/SKILL.md)
 - **geoserver** — 发布 WMS/WFS/瓦片服务作为 Leaflet 数据源：[../geoserver/SKILL.md](../geoserver/SKILL.md)
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-- **坐标顺序**：生成代码时严格区分 `[lat, lng]`（Leaflet）与 `[lng, lat]`（GeoJSON）
-- **生命周期**：框架集成务必成对生成创建与 `map.remove()` 清理逻辑
-- **图标修复**：npm 场景下主动补充默认图标路径配置，避免破图
-- **插件引入**：先引 CSS 再引 JS，绘制/聚合/热力图分别对应 `leaflet-draw`、`leaflet.markercluster`、`leaflet.heat`
-- **大数据量**：点数超过约 1000 时优先建议 `markercluster` 或改用 `circleMarker` 降低开销
+- **加载与引用**：用 `skill("leaflet")` 加载（用户也可输入 `/leaflet`）；本技能无 reference 子目录，示例代码直接落到会话工作区工程，技能目录只读。
+- **执行环境**：`npm install`、`npm run build` 交给 `pwsh`；纯静态页面可用 `python -m http.server 5173` 起服务（`python` 不存在时用 `py -3`）。
+- **先探测版本**：`npm ls leaflet`（未装则 `npm view leaflet version`）；本技能按 1.9.4 编写，CDN 的 `integrity` SRI 哈希只对应 1.9.4，换版本必须同步换哈希。
+- **验证产物**：构建后 `curl.exe -I http://localhost:5173/assets/<入口>.js` 确认 200；联网时还可 `curl.exe -I https://unpkg.com/leaflet@1.9.4/dist/leaflet.js` 核对 CDN 版本；DSH 不打开浏览器，把 URL 和“应看到瓦片与标记”交给用户，有截图再用 `read_image`。
+- **图标与坐标**：npm + 打包器下默认 marker 图标会 404，需显式设置 `L.Icon.Default` 的 `iconUrl`/`iconRetinaUrl`/`shadowUrl`；坐标一律 `[lat, lng]`，GeoJSON 是 `[lng, lat]`。
+- **生命周期**：SPA 卸载必须 `map.remove()` 并解绑自定义事件；容器隐藏或尺寸变化后 `map.invalidateSize()`。
+- **常见症状**：地图区域空白多为容器没设高度；`L is not defined` 是脚本顺序或 CDN 失败；漏引 `leaflet.css` 会导致控件错位。
+- **安全与权限**：装包、起服务、改端口前先征得用户同意；天地图等瓦片服务的 `tk` 不要硬编码进提交的前端代码。

package/assets/mapbox-gl-js/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mapbox-gl-js
-description: "Use when building interactive vector web maps with Mapbox GL JS — WebGL rendering, Style Spec, data-driven expressions, 3D terrain, layer-level events. Note: v2+ is proprietary under Mapbox TOS with an access token requirement; MapLibre GL JS is the open-source API-compatible fork."
+description: "Use when building vector web maps with mapbox-gl 3.33.0 — WebGL rendering, Style Spec layers, data-driven expressions, setTerrain raster-dem, fill-extrusion, or debugging 401 'A valid Mapbox access token is required', 'Style is not done loading', and pk./sk. token handling. Note: v2+ is proprietary under Mapbox TOS and requires a token; MapLibre GL JS is the open-source fork."
 tags:
   - javascript
   - web
@@ -424,11 +424,13 @@ map.on('load', () => {
 - **cesiumjs** — 三维地球与 3D Tiles 可视化：[../cesiumjs/SKILL.md](../cesiumjs/SKILL.md)
 - **geoserver** — 发布 WMS/WFS/MVT 服务作为矢量瓦片数据源：[../geoserver/SKILL.md](../geoserver/SKILL.md)
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-- **先声明 token**：生成的代码始终包含 `mapboxgl.accessToken` 占位符，并提醒用户替换为真实 `pk.` token
-- **调用顺序**：`addSource`/`addLayer`/`setTerrain` 一律放入 `map.on('load', ...)` 回调，避免 "Style is not done loading"
-- **坐标顺序**：严格使用 `[lng, lat]`，不要套用 Leaflet 的 `[lat, lng]`
-- **许可提醒**：用户要求开源许可、免 token 或零成本时，主动建议 MapLibre GL JS 并给出等价 API 改写
-- **不虚构数据**：`source-layer` 名与可用属性取决于具体瓦片集，生成代码前确认来自 Mapbox Studio 或官方文档
-- **样式与交互**：动态样式用 expressions 数组语法；图层交互用 `map.on(type, layerId, handler)` 而非遍历全部要素
+- **加载与引用**：用 `skill("mapbox-gl-js")` 加载（用户也可输入 `/mapbox-gl-js`）；本技能无 reference 子目录，示例代码写入会话工作区工程，技能目录只读。
+- **执行环境**：`npm install`、`npm run build` 交给 `pwsh`；Windows 下用 `npm.cmd`，长构建用后台作业。
+- **先探测版本**：`npm ls mapbox-gl`（未装则 `npm view mapbox-gl version`）；本技能按 3.33.0 编写，CDN 的 JS 与 CSS 必须同为 `v3.33.0`，联网时 `curl.exe -I https://api.mapbox.com/mapbox-gl-js/v3.33.0/mapbox-gl.js` 应为 200。
+- **验证产物**：`npm run build` 后 `npx serve dist`，`curl.exe -I http://localhost:5173/` 确认入口；地图是否真加载、有没有 401 只能看浏览器 Network（`api.mapbox.com`），DSH 不打开浏览器，请用户确认或提供截图后再 `read_image`。
+- **token 安全**：前端只允许 `pk.` 公开 token，`sk.` 绝不能进构建产物；用 `VITE_MAPBOX_TOKEN` 等环境变量注入，提交前用 dsh 的 `grep` 搜 `sk.` 与硬编码 `pk.`，回答和日志里不要回显 token。
+- **许可提醒**：v2+ 是 Mapbox 专有许可并受配额计费约束；用户要求开源或免 token 时改写为 MapLibre（`maplibregl` 替代 `mapboxgl`，`mapbox://` 样式换成自建瓦片）。
+- **常见症状**：`Style is not done loading` 是 `load` 事件前调了 `addSource`/`addLayer`；空白先查容器高度和 `map.resize()`；`e.features` 只在回调内有效。
+- **安全与权限**：装包、起 dev server、调用计费接口前先征得用户同意，并说明可能产生费用。

package/assets/mapserver/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mapserver
-description: "Use when publishing spatial data as OGC web services (WMS, WFS, WCS) from a mapfile, styling layers with SLD, or deploying the mapserv CGI/FastCGI. MapServer: the C-based OSGeo open-source map server for the web."
+description: "Use when publishing WMS/WFS/WCS/OGC API Features from a MapServer 8.6.6 .map mapfile — MAP/LAYER/CLASS/STYLE objects, STATUS/PROJECTION/EXTENT errors, WEB.METADATA wms_enable_request and wfs_enable_request, SLD binding, FastCGI plus MS_MAP_PATTERN hardening, and blank GetMap / \"No query information to decode\" symptoms."
 tags:
   - c
   - server
@@ -285,10 +285,12 @@ ogr2ogr -f GPKG clip.gpkg countries.gpkg -clipsrc 100 20 130 50
 
 ---
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-- **优先用 `mapserv -v` 判断能力**：输出中的 `SUPPORTS=` 列表决定该实例能否提供 WMS/WFS/WCS，遇到服务不生效先查此项。
-- **改动前先验证 mapfile 语法**：可用 `map2img` 或 `shp2img` 离线渲染，快速定位语法与数据路径问题，无需经过 Web 服务器。
-- **区分"渲染问题"与"协议问题"**：图像空白多属渲染（EXTENT/PROJECTION/STATUS），能力文档缺失多属 `wms_*`/`wfs_*` 元数据配置。
-- **不要编造 OGC 参数**：WMS/WFS 请求参数以官方文档为准，WFS 2.0 用 `TYPENAMES`，WMS 1.3.0 用 `CRS`。
-- **生产部署优先 FastCGI**，并配置 `MS_MAP_PATTERN` 限制可访问的 mapfile 路径。
+- **加载与引用**：`skill("mapserver")` 加载；技能目录只读，mapfile、SLD 与测试数据写到会话工作区。
+- **执行环境**：命令交给 dsh 的 `pwsh`（Windows 用 OSGeo4W 的 `mapserv.exe`）；`sudo apt`、`tar -zxvf` 不跨平台，Windows 改 `Expand-Archive`，装包或改系统目录前先问用户。
+- **先探测版本**：`mapserv -v`，确认输出含 `MapServer version 8.6.6` 且 `SUPPORTS=` 里有需要的 `WMS_SERVER`/`WFS_SERVER`；缺项说明该构建没编进对应库，改 mapfile 无用。
+- **验证产物**：先离线 `map2img -m demo.map -o out.png -s 600 400` 看渲染，再 `mapserv -nh "QUERY_STRING=map=/abs/demo.map&SERVICE=WMS&VERSION=1.1.1&REQUEST=GetCapabilities"` 抓能力文档，最后才 `curl -sI "http://host/cgi-bin/mapserv?map=...&REQUEST=GetMap..."` 确认 200 与 `Content-Type: image/png`。
+- **排障分流**：空白图查 `EXTENT`/`BBOX`/`PROJECTION`/`STATUS ON`；能力文档缺图层查 `wms_enable_request`、`wfs_enable_request` 与 `NAME` 是否字母开头；WFS 无属性字段是 8.x 默认行为，补 `gml_include_items`。
+- **安全与权限**：`map=` 可读任意路径是 MapServer 最典型误配置，生产必须设 `MS_MAP_PATTERN`/`MS_MAP_NO_PATH`；重启 Apache/nginx 或改 CGI 权限前先向用户确认。
+- **改一处验一处**：改 `WEB.METADATA` 后只重跑 `GetCapabilities`，改 `LAYER` 样式后只重跑 `map2img`，缩小排查范围。

package/assets/mapsui/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: mapsui
-description: "Use when embedding interactive 2D maps in .NET desktop (WinForms/WPF) or mobile (MAUI) applications — tile layers, vector features, map controls. Mapsui: cross-platform .NET map component library."
+description: "Use when embedding interactive 2D maps in .NET desktop (WPF/WinUI/WinForms) or mobile (MAUI/Avalonia/Blazor) apps with Mapsui 5.1.0 (net8.0/net9.0) — Mapsui.Wpf/Mapsui.Maui packages, Map and Layers, OpenStreetMap.CreateTileLayer, Shapefile/GeoJSON via Mapsui.Nts, SphericalMercator.FromLonLat, or fixing a blank MapControl."
 tags:
   - dotnet
   - csharp
@@ -18,7 +18,7 @@ tags:
 >
 > **官方文档：** <https://mapsui.com/v5/documentation/index.html>
 >
-> **最新版本：** 5.1.0（截至2026-10，NuGet）
+> **最新版本：** 5.1.0（截至 2026-10，NuGet 稳定版；5.2.0-beta.1 为预发布）
 >
 > **许可证：** MIT
 
@@ -251,23 +251,15 @@ map.Layers.Add(new ImageLayer("Rivers") { DataSource = wmsProvider });
 map.ZoomToExtents();
 ```
 
-## AI 使用建议
+## DeepSeek Harness 使用建议
 
-### 推荐工作流
-
-1. **选择 UI 框架**：Mapsui 支持 WPF/WinUI/MAUI/Avalonia/Uno/Blazor/WinForms，根据需要选择对应的 NuGet 包
-2. **创建 Map**：实例化 `Map`，添加图层（`TileLayer` 作为底图 + `MemoryLayer` 作为矢量覆盖层）
-3. **数据转换**：通过 `SphericalMercator.FromLonLat()` 将经纬度转为 Web Mercator 坐标
-4. **绑定控件**：将 `MapControl.Map` 设置为创建的 Map 对象
-5. **添加交互**：通过 `MapControl.Info` 事件处理点击拾取，`Navigator` 控制视图
-
-### 关键注意事项
-
-- **NuGet 包完整**：确保安装了 `Mapsui.<UI框架>`、`Mapsui.Tiling`、`Mapsui.Nts` 三个包
-- **投影转换**：WGS84 经纬度必须通过 `SphericalMercator.FromLonLat()` 转换后才能用于 Mapsui 定位
-- **Shapefile 编码**：中文 Shapefile 需指定 `Encoding`（如 `Encoding.UTF8` 或 `Encoding.GetEncoding("GBK")`）
-- **样式共享**：共享 `Brush`/`Pen`/`VectorStyle` 实例可提升性能
-- **海量点优化**：使用 `RasterizingTileLayer` 包装海量点图层，按瓦片预渲染
+- **加载与引用**：用 `skill("mapsui")` 加载（用户也可输入 `/mapsui`）；示例写入会话工作区的 .NET 工程，技能目录只读。
+- **执行环境**：先 `dotnet --list-sdks`；Mapsui 5.1.0 的目标框架是 net8.0/net9.0（`Mapsui.Wpf` 为 net8.0-windows/net9.0-windows），低于 .NET 8 的工程不能直接引用。命令交给 `pwsh`，例如 `dotnet add package Mapsui.Wpf --version 5.1.0`。
+- **验证产物**：`dotnet build` 只证明编译通过；无头渲染用 `Mapsui.Rendering.Skia.MapRenderer.RenderToBitmapStream(map, ...)` 输出 PNG 的 MemoryStream（参数以 IntelliSense 为准），落盘后 `read_image` 检查；WinForms/WPF 窗口 DSH 看不到，需用户运行后提供截图。
+- **投影**：定位坐标必须 `SphericalMercator.FromLonLat(lon, lat)` 转换，直接用经纬度会定位到南太平洋。
+- **数据**：Shapefile 中文要指定 `Encoding`（UTF8 或 GBK）；矢量要素装 `Mapsui.Nts`，瓦片装 `Mapsui.Tiling`，UI 包装 `Mapsui.Wpf`/`Mapsui.Maui`。
+- **常见症状**：`MapControl` 空白先查是否赋值 `MapControl.Map`；MAUI 空白查 `UseSkiaSharp()` 与 `UseMapsui()` 是否注册。
+- **安全与权限**：新建工程、装包、运行桌面程序前先征得用户同意；PostGIS/瓦片服务的密码不要写进代码或回答。
 
 ## 相关技能