开发与工程 ✓ Microsoft · 官方

Azure 消息 SDK 故障诊断

定位并解决 Azure Event Hubs 与 Service Bus SDK 的连接、认证和消息处理问题。

42/ 100
不推荐

当前收益不足以覆盖风险或不确定性。

查看评分依据 ↓
可直接使用于
Codex · Claude Code
Star 数
★ 2.7k
最近更新
3 个月前
License
MIT
azure-messagingevent-hubsservice-busamqp
+2sdk-troubleshootingmessage-processing

这个 Skill 能做什么,适合哪些场景?

这是 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 诊断日志和资源健康状态判断服务端或客户端问题的工程师。

如何安装这个 Skill?

使用前请注意
  • 快速参考仅列出两个 MCP 工具,但后续工具表列出五个工具;需确认实际可用名称和权限。
  • “应用修复”可能涉及外部 Azure 资源或配置变更,但没有用户确认、变更范围或恢复步骤。
  • 连接字符串等凭据相关信息应在诊断提示和输出中明确禁止泄露并要求脱敏。
  • azure-diagnostics 下的关键故障排查指南未包含在给定证据中,无法确认其内容、版本和可达性。
  • 未提供中国大陆网络访问、中文文档或中文错误处理的证据。
开始前你需要
Agent 需要具备
  • 网络访问
  • MCP Server
需要预先安装
  • Azure MCP servers

该技能位于仓库的 .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。单独安装此技能的专用命令未在来源中说明。

通用方式:手动安装到 Claude Code(macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/azure-skills/skills/azure-messaging" ~/.claude/skills/
rm -rf "$tmp"

根据源仓库地址和 Skill 路径自动生成,只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式,请优先按作者说明操作;想只在当前项目中使用,把 ~/.claude/skills 换成项目里的 .claude/skills。

如何使用这个 Skill?

在已加载该技能并可访问 Azure MCP 工具的编码代理中,提交具体问题,例如:排查 Event Hubs 消费者持续 receiver disconnected 的原因,或 Service Bus 批处理时出现 message lock expired,请检查配置和诊断日志。技能会先识别 SDK 与版本线索,再检查资源健康、错误信息、文档和配置。来源未说明具体 SDK 语言的固定调用格式。

这个 Skill 有哪些优点和局限?

优点
  • 覆盖 Event Hubs 和 Service Bus 两类 Azure 消息服务。
  • 涵盖连接、认证、AMQP、锁、会话、检查点和消息处理等常见故障。
  • 诊断流程明确,包含资源健康、日志、文档和配置检查。
  • 可使用 Azure MCP 工具查询资源、健康状态和诊断日志。
局限
  • 依赖 Azure MCP 工具;来源未说明这些工具的配置和权限步骤。
  • 主要面向故障排查,不提供完整的消息架构设计或端到端 SDK 教程。
  • 来源未提供该单项技能的独立测试覆盖或按语言划分的详细示例。
  • 修复建议依赖错误信息、资源状态和可查询文档,无法保证脱离这些输入独立定位问题。

这个 Skill 与同类方案有什么区别?

与相关 Skills 并排比较;分数均按同一 FSRS 标准得出。

Skill FS 评分 Star 数 最近更新 License
Azure 消息 SDK 故障诊断 本页 ✓ Microsoft · 官方 42 · 不推荐 ★ 2.7k 3 个月前 MIT
Azure Service Bus Python 技能 ✓ Microsoft · 官方 45 · 不推荐 ★ 2.7k 3 个月前 MIT
Azure Event Hubs Java 开发技能 ✓ Microsoft · 官方 57 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Event Hubs Rust 技能 ✓ Microsoft · 官方 49 · 谨慎使用 ★ 2.7k 3 个月前 MIT
Azure Service Bus .NET 技能 ✓ Microsoft · 官方 47 · 谨慎使用 ★ 2.7k 3 个月前 MIT

FollowSkills 如何评估这个 Skill?

FollowSkills 评估 · FSRS-2.0
不推荐
42/ 100 五分制 2.1 / 5
1信任安全13 / 25 · 2.6/5

技能限定在 Azure Event Hubs 和 Service Bus 故障排查,未显示恶意或过度权限要求;但要求检查连接字符串、实体名称和消费者组,却没有敏感数据脱敏、最小权限、用户确认、数据流披露、回滚或外部修改边界,因此扣分。

2可靠稳定6 / 20 · 1.5/5

流程提供了 SDK 识别、健康检查、错误匹配、文档查询和配置检查等基本顺序,但没有本技能专属脚本、示例、异常输入处理或可诊断失败消息;MCP 工具清单还存在前后不一致,因此仅给出静态评估下的有限分数。

3适用触发6 / 15 · 2.0/5

触发词和适用场景覆盖连接、认证、锁、重连、检查点及批处理问题,目标较清楚;但未声明不适用范围、输入输出格式、语言版本边界,也没有中文支持或中国大陆网络可达性的证据,因此扣分。

4规范维护7 / 15 · 2.3/5

SKILL.md 结构清晰,包含元数据、快速参考、使用条件、工具表和流程;MIT 许可、作者和版本号明确,但引用的 azure-diagnostics 路径未随证据提供,缺少安装依赖、示例、FAQ、已知限制、变更记录和明确维护更新路径,因此扣分。

5有效结果6 / 15 · 2.0/5

该技能能为 Azure 消息 SDK 故障提供方向性诊断流程,并要求引用 Microsoft Learn;但没有具体命令、参数、语言实现或可直接交付的诊断输出格式,且关键内容依赖外部 MCP 和未提供的参考资料,用户仍可能需要较多补充工作,因此扣分。

6证据核验4 / 10 · 2.0/5

仓库存在通用 CI、评估工作流和测试代码,说明仓库具备一定审计基础;但提供的证据没有覆盖 azure-messaging 的专属测试、真实执行结果或多源复现,且核心参考文档缺失,因此只能给有限可验证性分数。

1 2 3 4 5 6

点击维度查看打分理由

评估于 2026年7月20日 审查版本 9ccaf7c3704a 评估证据[1][2][3][4][5][6][7][8][9][10]

证据充分度:低 — 主要依赖静态检查、作者材料或有限演示;适合发现线索,不适合做高风险决策。

查看完整评分方法 →

常见问题

这个技能需要哪些权限?
来源没有列出具体权限。它明确会使用资源健康、资源列表和诊断日志相关 MCP 工具,因此实际权限取决于这些 Azure MCP 工具的配置。
它支持哪些 Azure 消息服务?
明确支持 Azure Event Hubs 和 Azure Service Bus,包括队列、主题、订阅、消费者组及相关 SDK 故障。
它能直接修复生产环境问题吗?
来源描述的是诊断和提出修复建议,没有明确说明会自动修改 Azure 资源或应用代码。
它适合新建消息应用吗?
它更适合已有 Event Hubs 或 Service Bus 应用的故障排查;来源没有把完整应用开发或架构设计列为主要用途。

同仓库的其他 Skills

均来自 microsoft/agent-skills

自动化与运维 ✓ Microsoft · 官方

Azure 生产诊断

系统排查 Azure 生产故障,定位根因并提出安全的修复建议。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Service Bus Python 技能

为 Python 开发者提供 Azure Service Bus 队列与发布/订阅消息模式的实用指导。

★ 2.7k FS 45 不推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Java 开发技能

帮助 Java 开发者构建高吞吐、可 checkpoint 的 Azure 事件流应用。

★ 2.7k FS 57 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Rust 技能

帮助 Rust 开发者使用官方 Azure SDK 构建事件发送、批量处理和分区消费流程。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Service Bus .NET 技能

帮助 .NET 开发者构建可靠的 Azure 企业消息系统。

★ 2.7k FS 47 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Queue Storage Python 技能

帮助编码代理使用 Python 构建安全、可靠的 Azure Queue Storage 异步消息处理。

★ 2.7k FS 55 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Grid .NET 技能

为 .NET 应用提供发布、接收和处理 Azure Event Grid 事件的实用指导。

★ 2.7k FS 53 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Service Bus TypeScript 技能

用 Azure Service Bus 构建可靠的企业消息应用。

★ 2.7k FS 50 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs Python 技能

为 Python 应用提供高吞吐事件流的发送、接收与检查点模式。

★ 2.7k FS 49 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Grid Java 技能

帮助 Java 开发者使用 Azure Event Grid 构建事件发布、订阅与接收流程。

★ 2.7k FS 47 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Service Bus Rust 技能

帮助 Rust 开发者使用 Azure Service Bus 构建队列与发布订阅消息流程。

★ 2.7k FS 47 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Identity Python 认证技能

为 Python Azure 应用提供基于 Microsoft Entra ID 的可复用身份认证指导。

★ 2.7k FS 60 推荐 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Identity TypeScript

为 TypeScript Azure 应用配置安全、可切换的 Microsoft Entra ID 身份验证。

★ 2.7k FS 57 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 对话语言理解 Python 技能

帮助 Python 开发者使用 Azure SDK 分析对话意图和实体。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Grid Python 技能

帮助 Python 开发者使用 Azure Event Grid 构建可靠的事件发布流程。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Event Hubs TypeScript 技能

帮助 TypeScript 开发者构建高吞吐、可分区且支持检查点的 Azure Event Hubs 流处理应用。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Bot Service Python 管理技能

用 Python 创建、管理和配置 Azure Bot Service 机器人及其通信渠道。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure 升级助手

评估并自动升级 Azure 工作负载、托管计划、SKU 及旧版 Java SDK。

★ 2.7k FS 52 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Identity for .NET

为 .NET Azure SDK 客户端提供 Microsoft Entra ID 身份验证指导。

★ 2.7k FS 50 谨慎使用 3 个月前
开发与工程 ✓ Microsoft · 官方

Azure Web PubSub Python 技能

帮助 Python 开发者构建基于 WebSocket 的 Azure 实时消息与发布订阅功能。

★ 2.7k FS 50 谨慎使用 3 个月前

相关 Skills