Azure 消息 SDK 故障诊断
定位并解决 Azure Event Hubs 与 Service Bus SDK 的连接、认证和消息处理问题。
技能限定在 Azure Event Hubs 和 Service Bus 故障排查，未显示恶意或过度权限要求；但要求检查连接字符串、实体名称和消费者组，却没有敏感数据脱敏、最小权限、用户确认、数据流披露、回滚或外部修改边界，因此扣分。
流程提供了 SDK 识别、健康检查、错误匹配、文档查询和配置检查等基本顺序，但没有本技能专属脚本、示例、异常输入处理或可诊断失败消息；MCP 工具清单还存在前后不一致，因此仅给出静态评估下的有限分数。
触发词和适用场景覆盖连接、认证、锁、重连、检查点及批处理问题，目标较清楚；但未声明不适用范围、输入输出格式、语言版本边界，也没有中文支持或中国大陆网络可达性的证据，因此扣分。
SKILL.md 结构清晰，包含元数据、快速参考、使用条件、工具表和流程；MIT 许可、作者和版本号明确，但引用的 azure-diagnostics 路径未随证据提供，缺少安装依赖、示例、FAQ、已知限制、变更记录和明确维护更新路径，因此扣分。
该技能能为 Azure 消息 SDK 故障提供方向性诊断流程，并要求引用 Microsoft Learn；但没有具体命令、参数、语言实现或可直接交付的诊断输出格式，且关键内容依赖外部 MCP 和未提供的参考资料，用户仍可能需要较多补充工作，因此扣分。
仓库存在通用 CI、评估工作流和测试代码，说明仓库具备一定审计基础；但提供的证据没有覆盖 azure-messaging 的专属测试、真实执行结果或多源复现，且核心参考文档缺失，因此只能给有限可验证性分数。
- 快速参考仅列出两个 MCP 工具，但后续工具表列出五个工具；需确认实际可用名称和权限。
- “应用修复”可能涉及外部 Azure 资源或配置变更，但没有用户确认、变更范围或恢复步骤。
- 连接字符串等凭据相关信息应在诊断提示和输出中明确禁止泄露并要求脱敏。
- azure-diagnostics 下的关键故障排查指南未包含在给定证据中，无法确认其内容、版本和可达性。
- 未提供中国大陆网络访问、中文文档或中文错误处理的证据。
它能做什么 & 适用场景
这是 microsoft/skills 仓库中 azure-messaging 技能，专门处理 Azure Event Hubs 和 Azure Service Bus SDK 故障。它覆盖连接失败、认证错误、AMQP 链路问题、消息或会话锁过期、处理器停止工作、重复事件和检查点偏移重置等场景。技能通过 Azure MCP 工具检查资源健康状况、查询资源和诊断日志，并搜索 Microsoft Learn 文档。它适合需要排查 Azure 消息服务运行时问题的开发者，但不是通用的消息架构设计或完整 SDK 编程教程。
识别 SDK 和版本线索，检查 Azure 消息命名空间的服务健康状况，分析错误消息和 AMQP 错误，核对连接字符串、实体名称和消费者组等配置，使用 Event Hubs 和 Service Bus MCP 工具列出命名空间及实体，使用监控 MCP 工具查询 KQL 诊断日志，并通过文档 MCP 工具搜索 Microsoft Learn，最后给出基于文档的修复建议。
- 使用 Event Hubs 消费者或事件处理器的开发者遇到连接断开、无法接收消息或检查点重置。
- 使用 Service Bus 队列、主题或订阅的开发者遇到认证失败、AMQP 链路分离或接收器断开。
- 处理批量消息的团队遇到消息锁丢失、锁续期失败或批处理锁超时。
- 使用会话接收器的开发者遇到会话锁过期或会话错误。
- 需要通过 Azure 诊断日志和资源健康状态判断服务端或客户端问题的工程师。
优缺点一览
- 覆盖 Event Hubs 和 Service Bus 两类 Azure 消息服务。
- 涵盖连接、认证、AMQP、锁、会话、检查点和消息处理等常见故障。
- 诊断流程明确，包含资源健康、日志、文档和配置检查。
- 可使用 Azure MCP 工具查询资源、健康状态和诊断日志。
- 依赖 Azure MCP 工具；来源未说明这些工具的配置和权限步骤。
- 主要面向故障排查，不提供完整的消息架构设计或端到端 SDK 教程。
- 来源未提供该单项技能的独立测试覆盖或按语言划分的详细示例。
- 修复建议依赖错误信息、资源状态和可查询文档，无法保证脱离这些输入独立定位问题。
如何安装
该技能位于仓库的 .github/plugins/azure-skills/skills/azure-messaging/SKILL.md。安装整个技能集合可运行 npx skills add microsoft/skills，然后在向导中选择需要的技能。README 也记录了 Azure Skills 插件的 Copilot CLI 安装方式：/plugin marketplace add microsoft/skills，再运行 /plugin install azure-skills@skills。单独安装此技能的专用命令未在来源中说明。
如何使用
在已加载该技能并可访问 Azure MCP 工具的编码代理中，提交具体问题，例如：排查 Event Hubs 消费者持续 receiver disconnected 的原因，或 Service Bus 批处理时出现 message lock expired，请检查配置和诊断日志。技能会先识别 SDK 与版本线索，再检查资源健康、错误信息、文档和配置。来源未说明具体 SDK 语言的固定调用格式。