Azure Event Grid Java 技能
帮助 Java 开发者使用 Azure Event Grid 构建事件发布、订阅与接收流程。
该技能明确面向 Java 版 Azure Event Grid，覆盖发布 EventGridEvent、CloudEvent、批量发送、异步调用、命名空间接收等高频任务，实际用途清楚；扣分在于边界说明较少，缺少与 Event Hubs、Service Bus 等替代方案的对比，也没有明确版本适配范围。
示例覆盖了主路径，但全部来自静态文档，没有可见测试、验收用例或错误分支覆盖；另外主文档与参考文件的依赖版本不一致（4.27.0 与 4.32.0-beta.1），削弱了一致性和可复现性。
文档同时展示 API key 和 DefaultAzureCredential，且说明了所需环境变量，认证与外部副作用是透明的；但没有最小权限、显式确认、回滚或数据流分级说明，发送事件/接收事件本身也会产生外部效果。
可见证据只有 SKILL.md 和 examples.md 的说明与代码片段，没有独立测试、CI 结果或第三方执行证据；因此只能支持较低到中等的可审计性，不能把静态示例当作已验证行为。
安装、客户端创建、环境变量、错误处理和常见模式都写出来了，上手路径较清楚；但版本、包名和端点变量分散，命名空间接收与 CloudEvents/自定义事件的适用条件也未完全展开，仍有隐藏假设。
元数据包含 MIT 许可、Microsoft 作者和版本号，维护责任与更新路径基本清楚；但技能本身没有变更记录、兼容矩阵或支持周期说明，且示例版本不统一，维护成熟度仍有限。
- 不要把示例版本当作已验证运行结果；先按目标 SDK 版本核对 API 名称和构建器方法。
- 发布事件会产生真实外部副作用，正式环境应优先使用最小权限身份并补充失败重试与回滚策略。
它能做什么 & 适用场景
该技能面向使用 Azure Event Grid Java SDK 构建事件驱动应用的开发者。它涵盖 EventGridEvent、CloudEvent 和自定义 BinaryData 事件，以及同步、异步和批量发布。内容还展示了 DefaultAzureCredential、API 密钥、系统事件解析和 Event Grid Namespace 的 MQTT/Pull 接收模式。它适合已经拥有 Azure Event Grid 端点并需要 Java SDK 编码参考的项目。
指导开发者添加 Maven 依赖，创建同步或异步 Event Grid 发布客户端，配置 API 密钥或 Azure 身份凭据，构造并批量发送 EventGridEvent 和 CloudEvent，解析 JSON 事件负载，读取强类型事件数据，处理 Azure Storage 系统事件，并通过 Namespace 客户端接收、确认、拒绝或释放事件。示例还展示了环境变量和 HTTP 响应异常处理。
- Java 后端开发者需要向 Azure Event Grid 主题发布订单、资源或业务事件时，可使用 EventGridEvent 示例快速构造和发送事件。
- 采用 CNCF CloudEvents 1.0 的团队需要向 Azure Event Grid 发布标准化事件时，可参考 CloudEvent 客户端和批量发布模式。
- 需要降低发布延迟或整合响应式流程的 Java 项目，可采用异步客户端和 Reactor 回调示例。
- 接收 Azure webhook 负载的开发者，可使用 EventGridEvent.fromString 或 CloudEvent.fromString 解析事件并转换为业务数据类。
- 需要消费 Event Grid Namespace 主题的团队，可参考接收、确认、拒绝和延迟释放锁令牌的示例。
优缺点一览
- 覆盖 API 密钥、DefaultAzureCredential 和托管身份等多种客户端认证示例。
- 同时提供同步、异步、单事件和批量发布模式。
- 涵盖 EventGridEvent、CloudEvent、自定义事件数据、系统事件和 Namespace 接收流程。
- 包含环境变量、错误处理、幂等性、批处理和事件大小等实践提示。
- 内容主要聚焦 SDK 编码示例，没有展示创建 Azure Event Grid 资源、主题或订阅的部署步骤。
- 接收部分展示了 JSON 解析和 Namespace Pull 接收，但没有提供完整 webhook 服务端配置或运行示例。
- 示例依赖 Azure 端点、凭据和 Java/Maven 项目环境；源材料没有说明本地离线运行方式。
- README 将仓库标记为持续开发中，且该技能自身的独立测试结果未在提供材料中明确列出。
如何安装
在 Copilot CLI 或兼容的技能安装流程中运行：npx skills add microsoft/skills，然后在向导中选择所需技能。README 说明技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/，并可在多个 Agent 间建立符号链接。源材料没有提供只安装 azure-eventgrid-java 这一嵌套技能目录的专用命令。项目代码还需要添加 Maven 依赖：com.azure:azure-messaging-eventgrid:4.27.0。
如何使用
在已加载该技能的编码 Agent 中提出具体请求，例如：Event Grid Java：使用 DefaultAzureCredential 创建客户端，批量发布 CloudEvents，并处理发送异常。 也可使用触发短语“Event Grid Java”“publish events Azure”“CloudEvent SDK”“event-driven messaging”“pub/sub Azure”或“webhook events”。