Agent Skill · v1.1.0 · MIT

QGIS Automation Skill

把 QGIS Processing 能力收敛成「可脚本化、可审计、可由 AI Agent 执行」的 CLI 工作流:qgis_process 负责算法调用, 模板脚本负责固定参数组合与路径规范;配合 SKILL.md,Agent 不再输出无法落地的「打开软件点菜单」类指令。

GitHub 仓库

解决什么问题

地理处理任务常在「交互式点击」与「可复现实验」之间撕裂;本技能包面向后者。

在 CI、批处理、远程服务器或 AI Agent 场景中,GUI 操作既无法版本管理也难自动化。 QGIS Automation Skill 约定:优先使用 qgis_process run … 调用 Processing 算法 ID(如 native:buffer), 复杂多步流程再用 PyQGIS 脚本固化;失败时走统一的 error-detector 文本归类,便于写进实验记录。

典型用途包括:矢量缓冲区与裁剪、坐标系重投影、批量栅格/矢量流水线、在提交 MR 前对样例数据跑一遍回归命令等。 技能文档(SKILL.md)描述何时选用何种模式、路径与 CRS 要如何显式写出,减少「换机器就挂」的环境债。

核心能力

与仓库内脚本、模板一一对应;以下为能力摘要,细节以 README / references 为准。

Processing CLI

围绕 native:buffernative:clipnative:reprojectlayer 等封装参数模板,强调输入输出路径与覆盖策略。

环境与自检

check-env.ps1 / check-env.sh 检测 qgis_process 是否在 PATH,避免盲目执行。

错误诊断

error-detector 将 stderr 归纳到有限错误模式,便于 Agent 或人类快速对照 troubleshooting。

参考手册

references/ 内含算法 ID 查找思路、Windows 路径引号规则、常见问题排查表。

快速印象(命令形态)

真实参数请按本机 QGIS 版本与数据路径替换;以下为结构示意。

qgis_process run native:buffer
--distance=100
--input=/path/to/layer.gpkg
--output=/path/to/buffer.gpkg

仓库中的 scripts/examples/ 提供 Bash 与 PowerShell 最小可运行示例;assets/template-*.sh 系列可作为流水线片段拼接。

仓库结构(节选)

克隆后可将本 skill 目录纳入你的项目,由 Agent 读取 SKILL.md 作为行为约束。

qgis-automation-skill/ ├── SKILL.md # Agent 入口与规范 ├── README.md ├── references/ # 速查与排障 ├── scripts/ # check-env、error-detector、examples └── assets/ # buffer / clip / reproject / pipeline 模板

环境与许可

需在机器上安装 QGIS 3.16+,且 qgis_process 可用(Windows 常通过发行版自带 bat 调用)。

获取源码

完整脚本、变更记录与 Issue 讨论在 GitHub;欢迎 Star 便于后续迭代通知。

Zhangyi-cug / qgis-automation-skill