1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | Azure Planetary Computer Pro Skill(azure-planetary-computer-pro) |
| 作者/维护者 | Microsoft(MicrosoftDocs/Agent-Skills 仓库,微软官方文档团队维护) |
| 来源链接 | https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-planetary-computer-pro |
| 许可证 | CC BY 4.0(数据来源:GitHub API) |
| GitHub Stars | 718(数据来源:GitHub API;该数字属整个 Agent-Skills 合集仓库,不代表本技能自身热度) |
| Forks | 117(同上,合集整体数据) |
| 最新版本 | 仓库不发布正式 release,内容随 Microsoft Learn 文档源自动化再生成;本技能文件最近一次生成时间为 2026-07-19,最近一次提交涉及该目录为 2026-07-22(数据来源:GitHub API 提交历史,与 SKILL.md 内 generated_at 元数据一致) |
| 安装方式 | Claude Code / Codex 可通过官方插件市场一键安装整套技能集,或手动复制 skills/azure-planetary-computer-pro/ 目录到本地 agent 的 skills 目录 |
2. 功能介绍与亮点
这是微软官方把 Microsoft Planetary Computer Pro(企业级地理空间数据管理服务,核心资源为 GeoCatalog)的 Microsoft Learn 文档预编译成的结构化参考技能:
- 七大主题覆盖:故障排查、方案决策、限制与配额、安全、配置、集成与编码模式、部署——覆盖 GeoCatalog 从接入决策到清理下线的完整生命周期。
- STAC 标准全流程:集成一节详细覆盖 SpatioTemporal Asset Catalog(STAC)数据的批量导入、单条目创建、按 Python 建立集合,以及与 QGIS、ArcGIS Pro 等主流地理信息系统客户端的对接方法。
- 安全与多租户专项内容密度高:7 条文档链接覆盖 Entra ID 认证、托管标识、跨租户合作伙伴应用授权、API Management 代理与 SAS 令牌,适配企业级多方数据共享场景。
- 可视化配置细节完整:涵盖集合渲染设置、色彩映射表、瓦片参数、Mosaic 拼接选项与自定义查询过滤器,直接对应 Explorer 地图预览界面的配置项。
- 明确的技能边界声明:description 中显式注明“不适用于 Azure Maps、Azure Open Datasets、Azure Data Explorer”,并指路到同仓库对应技能,避免触发混淆。
- 无本地代码执行:技能目录内仅含一份 Markdown 文件,不含任何脚本或可执行文件。
亮点:微软官方出品、内容完全溯源到 learn.microsoft.com 权威文档;单文件约 9.4 千字节,35 条文档直链;七大主题中缺失的仅“最佳实践”与“架构设计模式”两项,其余覆盖完整。
3. 适用场景
固定分类:数据分析与可视化。
适用于需要管理、检索或分发大规模地理空间数据集(卫星影像、无人机航拍、地形高程等)的数据工程师与 GIS 开发者——无论是搭建符合 STAC 标准的地理空间数据目录、为多租户企业客户配置安全的跨组织数据共享、把 GeoCatalog 接入 QGIS/ArcGIS Pro 等桌面 GIS 工具,还是排查数据接入(ingestion)失败问题,都可以让 agent 按需调取该技能获取官方权威指导。农业、气候环境监测、保险精算、城市规划、应急测绘等依赖卫星与遥感数据的下游行业均可受益。
4. 跨 Agent 兼容性
- Claude Code:原生支持——仓库提供
.claude-plugin/插件清单(含marketplace.json与plugin.json),/plugin marketplace add MicrosoftDocs/agent-skills后/plugin install azure-agent-skills@microsoft-agent-skills即可安装整套技能(含本技能)。 - Codex:原生支持——仓库同时提供
.codex-plugin/plugin.json,codex plugin marketplace add MicrosoftDocs/agent-skills后从/plugins安装。 - OpenClaw:未验证——README 未列出该 agent 的专门安装说明;技能遵循 SKILL.md 开放标准,理论上可手动复制安装,但未见官方或社区的兼容性说明。
- Hermes Agent:需适配——聚合型多技能仓库(本仓库含 200+ 个技能子目录)下,通用的一键安装命令通常无法自动发现单个子技能,需先手动定位到
skills/azure-planetary-computer-pro子目录再安装。
5. 推荐理由
Planetary Computer Pro 的核心资源 GeoCatalog 涉及 STAC 标准、跨租户安全授权、瓦片渲染配置等专属知识,且服务本身处于持续演进阶段,agent 仅凭训练知识容易给出过时或笼统的回答。这个技能把 Microsoft Learn 的权威内容预编译成结构化索引,35 条直链覆盖数据接入、安全配置、可视化与桌面 GIS 客户端集成等高频场景,让 agent 在回答“STAC 集合怎么批量导入”“跨租户合作伙伴如何安全访问我的 GeoCatalog”“QGIS 怎么连接”这类具体问题时有据可查,边界声明清晰。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 MicrosoftDocs 系微软官方文档团队、内容对象为微软自有产品 Planetary Computer Pro,属第一方官方出品;所属 Agent-Skills 合集仓库 718 星不计入单个子技能;检索 GitHub、Reddit 等渠道均未找到针对该具体子技能的独立第三方讨论 |
| 可用性 | 7 | 七大主题中覆盖五项完整、两项(最佳实践、架构设计模式)缺失,35 条官方文档直链均带行号索引;插件市场一键安装或手动复制单文件均简便;最近一次生成/提交为 2026-07-19/22,距今约五周 |
| 安全性 | 9 | 官方出品、完全开源可审计(CC BY 4.0);技能目录内无任何脚本或可执行文件,仅一份 Markdown;运行时唯一的“外联”是拉取 learn.microsoft.com 官方文档页面,目标完全透明;不涉及任何凭据处理,全文逐段检查未发现可疑指令 |
安全检查清单:
| 检查项 | 结果 |
|---|---|
| ① Shell 命令执行范围 | 无——技能目录内不含任何脚本或可执行文件 |
| ② 运行时联网外发 | 需要网络访问以拉取文档内容,目标固定为 learn.microsoft.com 官方页面,外联目标透明 |
| ③ API key/凭据 | 不涉及,技能本身不需要任何凭据;文档内容涉及的 Entra ID/托管标识/SAS 令牌均为用户在自己 Azure 环境中配置,非技能索取 |
| ④ 可疑指令/注入迹象 | 未发现(已逐段扫描全文,无隐藏指令或诱导性措辞) |
| ⑤ 作者/组织信誉 | 微软官方文档组织 MicrosoftDocs,无造假迹象 |
| ⑥ License | CC BY 4.0,明确 |
| ⑦ 最近维护时间 | 本技能文件 2026-07-19 生成、2026-07-22 提交,所属仓库整体最近提交为 2026-08-17,持续维护中 |
7. 跟同类 Skills 相比的优势
| 项目 | 定位 | 与本技能的差异 |
|---|---|---|
geospatial-skills(isaaccorley,含 search-stac 子技能) |
开源地理空间工具箱,覆盖 GDAL 栅格处理、GeoParquet 校验、STAC 检索、Overture 开源地图数据等多个操作型子技能,需要本地安装 Python 地理空间依赖栈 | 是操作型技能集合,直接在本地执行代码处理地理数据文件;本技能是知识参考型,不执行任何代码,只提供 Azure 托管服务 GeoCatalog 的官方配置与排错文档索引,服务对象是“用 Azure 云服务”而非“本地跑地理空间算法”的用户 |
| scientific-agent-skills 的 geomaster(K-Dense-AI) | 面向科研场景的综合地理空间分析技能,覆盖遥感影像处理(Sentinel/Landsat/MODIS)、空间统计、点云处理,可调用包括 Planetary Computer 在内的多个开放数据源做分析 | 定位是跨平台的分析方法论,Planetary Computer 只是它可调用的众多数据源之一;本技能专注于单一 Azure 产品(Planetary Computer Pro 的企业版 GeoCatalog)本身的部署、安全与运维知识,二者可互补而非替代 |
8. 用户评价
该技能所属仓库持续快速迭代,但目前在 GitHub、Reddit、Hacker News 等第三方渠道尚未找到针对 azure-planetary-computer-pro 这一具体子技能的独立具名用户评价;所属仓库 Issues 区目前也没有标题提及该技能的记录。其对应的底层 Azure 产品目前处于预览阶段,公开评价渠道(PeerSpot 等)尚未收录相关评价。
9. 其他补充
该技能与仓库内另外约 200 个同结构技能共享同一套自动化生成流水线(docs2skills),按 Compute、集成、数据与分析、AI/ML、安全与身份、网络、基础设施、管理、专项九大类组织,覆盖 Azure 几乎全部主流服务;有进一步扩展安装需求时可按角色合集选择性安装。
10. 安装使用方式
- 插件市场(Claude Code):
/plugin marketplace add MicrosoftDocs/agent-skills,再执行/plugin install azure-agent-skills@microsoft-agent-skills,随后运行/reload-plugins或重启生效,将安装该仓库全部技能。 - 插件市场(Codex):
codex plugin marketplace add MicrosoftDocs/agent-skills,再从/plugins浏览器中选择安装azure-agent-skills。 - 手动安装(适用于 OpenClaw / Hermes Agent 等其他 agent):克隆仓库后,将
skills/azure-planetary-computer-pro/目录复制到本地 agent 的 skills 路径(如.claude/skills/、.agent/skills/等,具体路径因 agent 而异)。 - 使用前无需额外认证或 API key;技能触发后会在需要时通过
mcp_microsoftdocs:microsoft_docs_fetch(如已安装 Microsoft Docs MCP)或普通网页抓取工具拉取具体文档内容。
11. 注意事项
- 技能内容为预编译的文档索引而非实时文档镜像,若
generated_at元数据显示的生成时间超过 3 个月,SKILL.md 会提示 agent 建议用户拉取仓库最新版本。 - 七大主题中“最佳实践”与“架构设计模式”两项暂缺文档链接,遇到相关问题时该技能提供的指引不如其他主题完整。
- 默认安装方式是整套插件(200+ 个技能一次性安装),若只想安装本技能,需改用手动复制目录的方式。
- 跨 Agent 兼容性仅确认 Claude Code / Codex 原生支持;OpenClaw 未验证,Hermes Agent 在聚合仓库场景下需手动定位子目录安装。
- 底层 Azure 产品 Planetary Computer Pro 本身处于预览阶段,仅在部分区域可用,且目前仅支持创建公开可访问的目录,企业私有部署场景需留意该限制。
- 技能本身不执行任何本地代码,也不直接操作用户的 GeoCatalog 资源,只提供配置与排错的文档级指导,实际执行仍需用户自行在 Azure 门户、CLI 或 SDK 中操作。
- 离线环境下只能使用 SKILL.md 内置的分类目录与直链列表,无法获取链接指向的具体文档正文。