Azure Event Grid .NET 技能
为 .NET 应用提供发布、接收和处理 Azure Event Grid 事件的实用指导。
文档覆盖 API key、SAS 和 Entra ID，并建议生产环境使用托管身份，体现了基本的数据流和凭据选项透明度；但示例仍大量涉及密钥、发布、确认和故障转移，没有明确的用户确认、最小权限、敏感数据处理、重复发送风险或回滚说明，因此扣分。
技能提供了发布、拉取、解析、触发器和错误处理等连贯路径，且包含常见 HTTP 错误反馈；但未提供该技能专属的可复现测试，版本和 API 假设未在文件内验证，部分示例混用 Azure Functions 模型，异常输入和幂等失败场景覆盖不足，因此静态评估限制在10分以内并扣分。
触发词、目标用户场景以及 topics、domains、namespaces、CloudEvents 和 EventGridEvents 等范围较清楚；但未明确非适用边界、输入输出契约或环境前提，也没有中文支持和中国大陆网络可达性的证据，核心功能依赖 Azure 服务可用性，因此扣分。
文档结构清晰，包含安装、认证、示例、类型参考、最佳实践、错误处理、相关 SDK 和参考链接；技能自身有 MIT、作者和版本元数据，仓库还提供许可证、安全政策及 CI 信号，但缺少技能级变更记录、维护责任人、更新路径、FAQ 和已知限制说明，因此扣分。
内容覆盖常见 Event Grid 发布、消费、解析和函数触发任务，代码片段可作为直接起点；但静态审查无法确认代码可编译运行，基础设施配置、权限/RBAC、重试和部署前提仍需用户补充，部分结果可能需要较多审阅，因此按静态上限保守扣分。
技能提供 NuGet、API、Quickstart、Pull Delivery 和 GitHub 源码参考，仓库也有通用测试与评估工作流；但没有该技能路径对应的提交测试、执行结果或多来源交叉验证，结论主要依赖文档本身，因此不超过静态上限5分。
- 发布、确认、拒绝和故障转移会产生外部 Azure 影响；使用前应确认目标、权限、重复投递和恢复策略。
- 不要将示例中的访问密钥或 SAS 放入源代码；应验证 RBAC、凭据来源、包版本和示例 API。
- 未提供中国大陆网络可达性或中文使用说明，部署前需单独验证服务和文档访问条件。
它能做什么 & 适用场景
该技能面向使用 Azure Event Grid SDK for .NET 构建事件驱动架构的开发者。它覆盖主题和域的推送投递，以及命名空间的拉取投递。内容包括 EventGridEvent 与 CloudEvent、API 密钥、Microsoft Entra 凭据和 SAS 认证。它还提供 Azure Functions 触发器、事件解析、系统事件、批量发送、失败处理和故障转移示例。
指导开发者安装相关 NuGet 包，配置主题、域或命名空间端点及认证环境变量，创建 EventGridPublisherClient、EventGridSenderClient 和 EventGridReceiverClient。它展示如何发送单个事件和批量事件、指定域主题、接收并确认或释放事件、拒绝死信事件、解析 JSON 事件、处理系统事件，以及在 Azure Functions 中消费 EventGridEvent 或 CloudEvent。
- 使用 .NET 向 Azure Event Grid 主题或域发布订单、库存等业务事件的开发者。
- 需要通过 CloudEvents 连接 Azure Event Grid 与其他平台或事件系统的团队。
- 需要使用命名空间拉取投递、接收事件并根据处理结果确认、重试或拒绝事件的开发者。
- 在 Azure Functions 中通过 Event Grid 触发器处理原生事件或 CloudEvents 的开发者。
- 需要配置 Entra ID、访问密钥或 SAS 认证，并处理授权失败、负载过大和区域故障转移的团队。
优缺点一览
- 覆盖推送和拉取两种投递模式，以及主题、域和命名空间。
- 同时提供 EventGridEvent 和 CloudEvent 的完整 C# 示例。
- 涵盖多种认证方式、Azure Functions 消费、系统事件解析和错误处理。
- 提供批量发送、幂等处理、死信和故障转移等生产场景建议。
- 仓库 README 标注为持续开发中的项目，技能和测试仍可能更新。
- 源材料没有提供该单个技能的专门测试结果。
- 实际运行需要 Azure Event Grid 资源、端点和相应凭据；这些配置不会由技能自动创建。
- 技能主要提供代码指导，没有说明完整的项目模板或部署流程。
如何安装
安装整个技能集合：运行 npx skills add microsoft/skills，然后在向导中选择需要的技能。该技能位于 .github/plugins/azure-sdk-dotnet/skills/azure-eventgrid-dotnet/SKILL.md。在 .NET 项目中，根据投递模式安装包：dotnet add package Azure.Messaging.EventGrid；命名空间拉取投递使用 dotnet add package Azure.Messaging.EventGrid.Namespaces；CloudNative CloudEvents 互操作使用 dotnet add package Microsoft.Azure.Messaging.EventGrid.CloudNativeCloudEvents。
如何使用
当任务涉及“Event Grid”“EventGridPublisherClient”“CloudEvent”“EventGridEvent”“publish events .NET”“event-driven”或“pub/sub”时调用此技能。随后根据场景创建发布、发送或接收客户端，配置对应端点和凭据，并使用技能中的 C# 模式实现发送、接收、确认、释放、拒绝或解析事件。
对比同类
EventGridEvent 是 Azure 特有的事件格式，CloudEvent 遵循 CNCF 标准并具有更好的跨平台互操作性。主题和域使用推送投递及 EventGridPublisherClient；命名空间使用拉取投递及 EventGridSenderClient、EventGridReceiverClient。