把 QGIS Processing 能力收敛成「可脚本化、可审计、可由 AI Agent 执行」的 CLI 工作流:qgis_process 负责算法调用,
模板脚本负责固定参数组合与路径规范;配合 SKILL.md,Agent 不再输出无法落地的「打开软件点菜单」类指令。
地理处理任务常在「交互式点击」与「可复现实验」之间撕裂;本技能包面向后者。
在 CI、批处理、远程服务器或 AI Agent 场景中,GUI 操作既无法版本管理也难自动化。
QGIS Automation Skill 约定:优先使用 qgis_process run … 调用 Processing 算法 ID(如 native:buffer),
复杂多步流程再用 PyQGIS 脚本固化;失败时走统一的 error-detector 文本归类,便于写进实验记录。
典型用途包括:矢量缓冲区与裁剪、坐标系重投影、批量栅格/矢量流水线、在提交 MR 前对样例数据跑一遍回归命令等。
技能文档(SKILL.md)描述何时选用何种模式、路径与 CRS 要如何显式写出,减少「换机器就挂」的环境债。
与仓库内脚本、模板一一对应;以下为能力摘要,细节以 README / references 为准。
围绕 native:buffer、native:clip、native:reprojectlayer 等封装参数模板,强调输入输出路径与覆盖策略。
check-env.ps1 / check-env.sh 检测 qgis_process 是否在 PATH,避免盲目执行。
error-detector 将 stderr 归纳到有限错误模式,便于 Agent 或人类快速对照 troubleshooting。
references/ 内含算法 ID 查找思路、Windows 路径引号规则、常见问题排查表。
真实参数请按本机 QGIS 版本与数据路径替换;以下为结构示意。
仓库中的 scripts/examples/ 提供 Bash 与 PowerShell 最小可运行示例;assets/template-*.sh 系列可作为流水线片段拼接。
克隆后可将本 skill 目录纳入你的项目,由 Agent 读取 SKILL.md 作为行为约束。
需在机器上安装 QGIS 3.16+,且 qgis_process 可用(Windows 常通过发行版自带 bat 调用)。