Geoskill: Geospatial Report Generator

Render reports (HTML/DOCX/PDF) from other skills' output-manifest.json. Auxiliary tool only — does not analyze data, does not download anything. Workflow: run another skill to produce output-manifest.json first, then hand the manifest (or its parent directory) to this skill to render the final report. Use when the user already has skill outputs and wants a formatted deliverable document.

Prerequisites / 先准备 X 文件

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

本 skill 不分析数据，只把 其他 skill 的 output-manifest.json 渲染成报告。

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

先准备 X 文件：先跑任意一个分析 skill 拿到 manifest。

快速试跑命令：

bash

python geospatial_report_generator.py --input-dir ./output --format all --title 'My Report'

⚠️ 本 skill 不做数据分析，也不下载数据。它只是「读 manifest → 渲染报告」。 工作流：先用其他 skill 跑出 output-manifest.json → 然后用本 skill 渲染成报告。 --bbox / --aoi-file 接口仅为上下文记录 (写到 output-manifest.json)，不会触发任何下载。

Geospatial Report Generator

Auxiliary report-rendering tool. Reads output-manifest.json (or qa-report.json) from any other skill and renders it into HTML, DOCX, and/or PDF reports. This skill does not analyze data, does not download data, and does not contain any analysis or QA logic. It only formats whatever is already present in the input manifest.

For classification purposes this skill is a 报告生成器（辅助工具） / report generator (auxiliary tool), not an analysis skill. The output-manifest.json it writes records mode: "report_generator" (or "synthetic" when --synthetic is used for self-test).

Trigger

Use when the user wants to:

• Render a report from existing skill outputs (i.e. from an output-manifest.json already produced by another skill)
• Summarize QA findings into a deliverable document (HTML/DOCX/PDF)
• Combine multiple skill outputs into one report

Boundaries

• Does not perform data analysis or QA — it only formats what the input manifest already contains
• Does not download any data — fully offline, all inputs are local files supplied by the caller
• Conclusions are limited to what the manifest supports
• Compliance/certification requires human review

CLI Usage

bash

# From a single manifest
python scripts/geospatial_report_generator.py --manifest qa-output/qa-report.json

# From a directory (auto-discovers manifests)
python scripts/geospatial_report_generator.py --input-dir ./project-output

# DOCX output with custom title
python scripts/geospatial_report_generator.py --input-dir ./output --format docx --title "Flood Analysis Report"

# All formats
python scripts/geospatial_report_generator.py --manifest manifest.json --format all

Arguments

Argument	Description
--manifest	Path to output-manifest.json (mutual exclusive with --input-dir)
--input-dir	Directory to scan for manifests
--output-dir, -o	Output directory (default: ./report-output)
--format	html (default), docx, pdf, or all
--title	Report title
--language	zh (default) or en
--sections	Comma-separated section names

Output

File	Description
report.html	HTML report
report.docx	Word document (if python-docx available)
report.pdf	PDF document (if weasyprint available)
report-manifest.json	Machine-readable report metadata

Exit Codes

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

Dependencies

• Pure Python stdlib for HTML generation
• python-docx (optional) for DOCX output
• weasyprint (optional) for PDF output
• Falls back to HTML if optional deps missing