geoskill-地籍变化检测

原始内容

---
name: cadastral-change-detection
description: >
  Topology-aware cadastral parcel change detection between two epochs.
  Identifies new, deleted, expanded, reduced, split, and merged parcels
  from cadastral vector data (宗地/地块/调查图斑). Use when comparing
  two epochs of land parcels, auditing boundary changes, or generating
  cadastral change ledgers.
---

## Prerequisites / 先准备 X 文件

> ⚠️ **必读** — 本 skill 不属于即用型，需要先准备特定文件才能跑。

本 skill 需要 **两期宗地矢量**（GeoJSON / Shapefile），来自地方不动产登记。

👉 完整教程见仓库根目录 `PREREQUISITES.md` 2.1 节。

**先准备 X 文件**：`references/sample_before.geojson` + `references/sample_after.geojson` 试跑，再换成真实宗地。

快速试跑命令：

```bash
python cadastral_change_detection.py --before references/sample_before.geojson --after references/sample_after.geojson --output-dir ./test
```


# Cadastral Change Detection

Compares two epochs of cadastral parcels to detect object-level changes with topology awareness.

## Trigger

Use when the user wants to:
- Compare two epochs of parcel/cadastral data
- Identify new/deleted/changed parcels
- Detect split and merge events
- Audit boundary adjustments
- Generate change ledgers and topology issue reports

## CLI Usage

```bash
# Basic comparison
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson

# With custom parameters
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson \
  --id-field ZDBM \
  --field-map field_map.json \
  --tolerance 0.3 \
  --area-threshold 0.1 \
  --match-iou 0.1 \
  --output-dir ./ccd-output

# Dry run (validate only)
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson \
  --dry-run
```

## Parameters

| Parameter | Default | Description |
|---|---|---|
| `--before` | required | 前期宗地数据 (GeoJSON/Shapefile) |
| `--after` | required | 后期宗地数据 (GeoJSON/Shapefile) |
| `--id-field` | auto | 宗地唯一标识字段名 |
| `--field-map` | None | 字段映射 JSON (前期字段→后期字段) |
| `--tolerance` | 0.0 | 几何容差 (CRS 单位) |
| `--area-threshold` | 0.05 | 面积变化阈值比例 |
| `--match-iou` | 0.1 | IoU 匹配阈值 |
| `--rules` | None | 业务规则 JSON 文件路径 |
| `--output-dir` | ./cadastral-change-output | 输出目录 |
| `--dry-run` | False | 仅验证参数 |
| `--bbox` | None | (reserved) standard flag, has no effect on this skill |
| `--date-range` | None | (reserved) standard flag, has no effect on this skill |
| `--aoi-file` | None | (reserved) standard flag, has no effect on this skill |

## 数据下载 (Data Download)

This skill does **not** auto-download cadastral data. Cadastral /
land-parcel datasets are jurisdiction-specific and not available from
open archives. The user must supply two epochs of vector data
(`--before` and `--after`).

The `--bbox`, `--date-range`, and `--aoi-file` flags are still
registered (for CLI consistency with the other 49 GeoSkills) but
have no effect on the analysis. Supplying `--bbox` without
`--before/--after` raises a clear error.

## Output

| File | Description |
|---|---|
| `parcel_changes.geojson` | 变更宗地图层（含变更类型与指标） |
| `change_ledger.xlsx` | 变更台账（Excel 汇总表） |
| `topology_issues.geojson` | 拓扑问题图层（重叠/缝隙） |
| `field_changes.csv` | 属性字段变更记录 |
| `audit_report.pdf` | 审核报告（HTML 格式） |
| `request.json` | 请求参数记录 |
| `dataset-manifest.json` | 数据集清单 |
| `output-manifest.json` | 输出清单 |
| `qa.json` | 质量检查结果 |
| `run.log` | 运行日志 |

## Change Types

| Type | Meaning |
|---|---|
| `new` | 新增宗地（仅后期存在） |
| `deleted` | 删除宗地（仅前期存在） |
| `expanded` | 面积扩大（超阈值） |
| `reduced` | 面积缩小（超阈值） |
| `unchanged` | 未变化（面积在容差内） |
| `split` | 分割（1前期→N后期） |
| `merge` | 合并（N前期→1后期） |
| `boundary_adjust` | 边界调整（面积不变但边界位移） |

## Exit Codes

| Code | Meaning |
|---|---|
| 0 | 成功 |
| 2 | 参数错误 |
| 3 | 依赖缺失 |
| 6 | 数据校验失败 |
| 7 | 处理失败 |

## Constraints

- 几何容差按 CRS 单位配置，禁止在经纬度直接用米容差
- 图匹配处理一对多/多对一并保存映射
- 面积差区分几何精度误差与业务阈值
- 敏感数据默认不联网、不上传

name: cadastral-change-detection description: > Topology-aware cadastral parcel change detection between two epochs. Identifies new, deleted, expanded, reduced, split, and merged parcels from cadastral vector data (宗地/地块/调查图斑). Use when comparing two epochs of land parcels, auditing boundary changes, or generating cadastral change ledgers.

Prerequisites / 先准备 X 文件

⚠️ 必读 — 本 skill 不属于即用型，需要先准备特定文件才能跑。

本 skill 需要 两期宗地矢量（GeoJSON / Shapefile），来自地方不动产登记。

👉 完整教程见仓库根目录 PREREQUISITES.md 2.1 节。

先准备 X 文件：references/sample_before.geojson + references/sample_after.geojson 试跑，再换成真实宗地。

快速试跑命令：

python cadastral_change_detection.py --before references/sample_before.geojson --after references/sample_after.geojson --output-dir ./test

Cadastral Change Detection

Compares two epochs of cadastral parcels to detect object-level changes with topology awareness.

Trigger

Use when the user wants to:

Compare two epochs of parcel/cadastral data
Identify new/deleted/changed parcels
Detect split and merge events
Audit boundary adjustments
Generate change ledgers and topology issue reports

CLI Usage

# Basic comparison
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson

# With custom parameters
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson \
  --id-field ZDBM \
  --field-map field_map.json \
  --tolerance 0.3 \
  --area-threshold 0.1 \
  --match-iou 0.1 \
  --output-dir ./ccd-output

# Dry run (validate only)
python scripts/cadastral_change_detection.py \
  --before before.geojson \
  --after after.geojson \
  --dry-run

Parameters

Parameter	Default	Description
`--before`	required	前期宗地数据 (GeoJSON/Shapefile)
`--after`	required	后期宗地数据 (GeoJSON/Shapefile)
`--id-field`	auto	宗地唯一标识字段名
`--field-map`	None	字段映射 JSON (前期字段→后期字段)
`--tolerance`	0.0	几何容差 (CRS 单位)
`--area-threshold`	0.05	面积变化阈值比例
`--match-iou`	0.1	IoU 匹配阈值
`--rules`	None	业务规则 JSON 文件路径
`--output-dir`	./cadastral-change-output	输出目录
`--dry-run`	False	仅验证参数
`--bbox`	None	(reserved) standard flag, has no effect on this skill
`--date-range`	None	(reserved) standard flag, has no effect on this skill
`--aoi-file`	None	(reserved) standard flag, has no effect on this skill

数据下载 (Data Download)

This skill does not auto-download cadastral data. Cadastral / land-parcel datasets are jurisdiction-specific and not available from open archives. The user must supply two epochs of vector data (--before and --after).

The --bbox, --date-range, and --aoi-file flags are still registered (for CLI consistency with the other 49 GeoSkills) but have no effect on the analysis. Supplying --bbox without --before/--after raises a clear error.

Output

File	Description
`parcel_changes.geojson`	变更宗地图层（含变更类型与指标）
`change_ledger.xlsx`	变更台账（Excel 汇总表）
`topology_issues.geojson`	拓扑问题图层（重叠/缝隙）
`field_changes.csv`	属性字段变更记录
`audit_report.pdf`	审核报告（HTML 格式）
`request.json`	请求参数记录
`dataset-manifest.json`	数据集清单
`output-manifest.json`	输出清单
`qa.json`	质量检查结果
`run.log`	运行日志

Change Types

Type	Meaning
`new`	新增宗地（仅后期存在）
`deleted`	删除宗地（仅前期存在）
`expanded`	面积扩大（超阈值）
`reduced`	面积缩小（超阈值）
`unchanged`	未变化（面积在容差内）
`split`	分割（1前期→N后期）
`merge`	合并（N前期→1后期）
`boundary_adjust`	边界调整（面积不变但边界位移）

Exit Codes

Code	Meaning
0	成功
2	参数错误
3	依赖缺失
6	数据校验失败
7	处理失败

Constraints

几何容差按 CRS 单位配置，禁止在经纬度直接用米容差
图匹配处理一对多/多对一并保存映射
面积差区分几何精度误差与业务阈值
敏感数据默认不联网、不上传