Construction Progress Monitor

Monitors construction site evolution from multi-temporal imagery using spectral indices and a state machine to classify project stages.

Trigger

Use when the user wants to:

• Track construction progress from satellite imagery
• Classify project stages (clearing → earthwork → foundation → structure → finishing → completed)
• Detect stagnant projects (no change for N periods)
• Generate progress reports for infrastructure projects
• Audit construction timelines against planned schedules

CLI Usage

# Basic monitoring with project boundaries and schedule
python scripts/construction_progress_monitor.py \
  --projects projects.geojson \
  --schedule schedule.csv \
  --monitor-period 2024-01,2024-04,2024-07,2024-10

# With custom stage schema and stagnation threshold
python scripts/construction_progress_monitor.py \
  --projects projects.geojson \
  --schedule schedule.csv \
  --monitor-period 2024-01,2024-04,2024-07,2024-10 \
  --stage-schema stages.json \
  --stagnation-periods 2 \
  --imagery-source sentinel2

# Specify output directory
python scripts/construction_progress_monitor.py \
  --projects projects.geojson \
  --schedule schedule.csv \
  --monitor-period 2024-01,2024-04 \
  --output-dir ./cpm-output

Parameters

Parameter	Default	Description
--projects	required	Project boundaries with IDs (GeoJSON)
--schedule	required	Planned schedule CSV (project_id, node, date)
--monitor-period	required	Comma-separated monitoring dates (YYYY-MM)
--stage-schema	built-in	Custom stage definition JSON
--imagery-source	sentinel2	Imagery source identifier
--stagnation-periods	2	Periods of no change to flag stagnation
--output-dir	./cpm-output	Output directory

Output

File	Description
project_status.geojson	Per-project current stage and metrics
progress_timeseries.csv	Stage timeline per project
stage_map.tif	Raster stage classification map
exceptions.xlsx	Stagnation and anomaly report

Construction Stages

Stage	Code	Key Indicators
clearing	0	High bare soil, low NDVI, low NDBI
earthwork	1	Dominant bare soil, minimal vegetation
foundation	2	Mixed bare soil and built material
structure	3	High NDBI, low NDVI, built materials
finishing	4	Moderate NDBI, increasing NDVI
completed	5	Low NDBI, high NDVI, stable

Exit Codes

Code	Meaning
0	Success
2	Argument error
3	Dependency missing
6	Data validation failure
7	Processing failure

数据下载

本 skill 可自动从 Microsoft Planetary Computer 下载数据 (无需 API key):

python construction_progress_monitor.py --bbox 116,39,117,40 --date-range 2024-06-01,2024-06-30 --output-dir <tmp>

• --bbox W,S,E,N: WGS-84 边界框 (西, 南, 东, 北)
• --date-range START,END: 日期范围 (YYYY-MM-DD,YYYY-MM-DD)
• --aoi-file <path.geojson>: 替代 --bbox 的 GeoJSON 多边形
• --cache-dir <path>: 缓存目录 (默认 ~/.geoskill_cache)

当用户只给 --bbox + --date-range (没有 --image) 时，skill 自动下载数据。 当用户给 --image 时，走原文件路径 (向后兼容)。