Refactored System — Development skill for Claude Code

DJI 上云技能家族

[](LICENSE) · [English](README_EN.md) | [中文](README.md)

处理大疆行业无人机云平台接入的 Agent 技能集合。当前包含两个技能：

• dji-wpml：处理大疆 WPML 航线文件（template.kml / waylines.wpml / .kmz 归档）的生成、解析、修改与校验
• cloud-api：处理大疆上云 API（MQTT/HTTPS/WebSocket/JSBridge）的接入、解析、调试与问题定位（机场 / DJI Pilot 2 上云）

这是什么

符合 Anthropic 开放 Skill 标准（agentskills.io）的技能包。让 AI 在处理大疆航线文件、云平台接入时按已整理的规则和参考资料工作，并通过可用的校验脚本检查结果，减少依赖猜测；正式兼容性仍须以对应官方文档为准。

**知识来源**：以 DJI 官方文档（`docs/Cloud-API-Doc`，即官方 `dji-sdk/Cloud-API-Doc` 仓库的 clone）为主，部分目标检测字段依据既有 DJI Pilot 2 导出文件观察整理。两类证据分开标注；原始导出及其软件/固件版本未随仓库提供，不承诺目标检测字段的通用兼容性。官方文档版权归 DJI，**不随本仓库分发**，使用前需自行 clone（见"使用前提"）。

当前本地复核基准为 `4ec6b0c7f9472aeb09a0a47949855d19c473ea07`（2024-11-07），不是官方最新版本声明。每份参考文档附有来源路径、适用范围和脚本覆盖边界；完整记录见 [知识来源与更新复核](KNOWLEDGE_SOURCES.md)。

**商标声明**：DJI、大疆及其相关名称、Logo 均为大疆创新科技有限公司（SZ DJI Technology Co., Ltd.）或其关联方的注册商标。本仓库仅为技术学习/参考用途，**与 DJI 无隶属、赞助或背书关系**，不代表 DJI 官方立场。仓库自身代码按 [LICENSE](LICENSE) 授权。

**内容声明**：本仓库 `reference/` 下的参考文档为 DJI 官方文档的学习笔记式提炼（非原文），并含少量基于 DJI Pilot 2 实际导出文件的字段整理（已做占位化处理）。**不替代官方文档**，正式开发请以官方文档为准；其中大疆相关内容版权归 DJI 所有。

目录结构

git-skill/
├── README.md                  # 本文件
├── README_EN.md               # 英文版 README
├── KNOWLEDGE_SOURCES.md       # 本地知识基准、证据分类与更新复核清单
├── docs/Cloud-API-Doc/        # DJI 官方文档仓库（知识源，需自行 clone，不随仓库分发）
├── dji-wpml/
│   ├── SKILL.md               # 技能主入口（何时用、硬性规则、按需加载路由）
│   ├── reference/
│   │   ├── template-kml.md    # template.kml 参考（创建/任务/模板信息、各模板字段）
│   │   ├── waylines-wpml.md   # waylines.wpml 参考（执行文件）
│   │   ├── common-elements.md # 共用元素（机型/负载/动作/偏航/转弯参数）
│   │   └── kmz-archive.md     # KMZ 归档规则
│   ├── scripts/
│   │   ├── validate_wayline.py # 校验脚本（纯 Python 标准库）
│   │   └── package_kmz.py      # KMZ 打包脚本（纯 Python 标准库）
│   ├── examples/
│   │   ├── waypoint.kml        # 航点飞行模板示例
│   │   ├── mapping.kml         # 建图航拍模板示例
│   │   ├── mapping3d.kml       # 倾斜摄影模板示例
│   │   ├── mappingStrip.kml    # 航带飞行模