Azure Queue Storage Python 技能
帮助编码代理使用 Python 构建安全、可靠的 Azure Queue Storage 异步消息处理。
文档明确优先使用 DefaultAzureCredential、限制生产凭据链，并要求客户端生命周期管理，降低密钥暴露和资源泄漏风险；但删除队列、清空消息、删除消息等外部破坏性操作没有用户确认、权限范围、敏感数据处理、审计或回滚说明，因此扣分。
主路径涵盖同步、异步、发送、接收和可见性超时，且引用文件补充了异步凭据清理和失败重新抛出；但示例之间存在生命周期指导不完全一致，错误处理、重试、幂等性、毒消息处置和依赖版本验证有限，静态审查不能证明可运行，因此不超过10分。
触发词、Python SDK范围、同步/异步模式和 Service Bus 的非适用提示较清楚；但输入前提、预期输出、边界条件、语义排除规则、中国语言支持及中国大陆网络可达性均未说明，因此扣分。
具备 front matter、MIT 许可、作者、版本、安装说明、分层参考文件和能力索引，结构较易导航；但没有 changelog、维护责任与更新流程的明确说明，未锁定依赖版本，也缺少 FAQ、故障排查和完整参数说明，因此扣分。
提供了队列创建、消息发送/接收、更新、删除、清空、属性、异步和 Base64 示例，核心编码任务可直接参考；但缺少可验证的完整端到端输出、生产级错误与监控实现，破坏性操作和消息重试语义仍需用户补充，因此只能给中等分。
仓库包含 CI 工作流和通用 harness 测试，且技能自身引用文件可审计；但提供材料没有针对该技能的提交测试套件、第三方执行结果或 API 交叉验证，结论主要来自静态文档，因此仅给有限分。
- 不要将 clear_messages、delete_queue 或 delete_message 示例直接用于生产自动化；应先确认授权、范围、幂等性、审计和恢复策略。
- 应根据当前 azure-storage-queue 和 azure-identity 文档核对 API、异步迭代、凭据生命周期及消息编码行为，并固定经过验证的依赖版本。
- DefaultAzureCredential 可能读取多个本地或环境凭据；生产环境应显式限制凭据来源并避免把消息内容写入日志。
- 文档未说明中国大陆网络、区域端点或中文错误排查支持，部署前需单独验证。
它能做什么 & 适用场景
该技能面向使用 Azure Queue Storage Python SDK 的开发者，覆盖队列和消息的常见操作。它提供同步与异步客户端示例，包括创建、删除、列出队列，以及发送、接收、查看、更新和删除消息。内容优先推荐 DefaultAzureCredential，并要求生产代码使用客户端上下文管理器。它适合任务分发和异步处理，但不负责 Azure 资源 provisioning、权限配置或完整生产架构设计。
指导开发者安装 azure-storage-queue 与 azure-identity，配置存储账户 URL 和相关环境变量，使用 QueueServiceClient 与 QueueClient 操作队列。它展示字符串、JSON 和 Base64 编码消息的发送，带可见性超时和生存时间的消息处理，消息查看、更新、删除与清空，以及队列属性和元数据管理。它还展示 azure.storage.queue.aio 和 azure.identity.aio 的异步用法，并说明如何根据 dequeue_count 识别可能的毒消息。
- Python 后端开发者需要把任务放入 Azure Queue Storage，并由异步工作程序稍后处理。
- 需要在本地开发和 Azure 生产环境之间复用身份认证代码的团队。
- 需要通过可见性超时、删除确认和 dequeue_count 管理消息重试的开发者。
- 需要使用异步 QueueClient 支撑较高吞吐消息处理的 Python 应用。
- 需要查看消息或读取队列元数据而不改变消息可见性的运维与开发人员。
优缺点一览
- 覆盖同步和异步 Python 客户端。
- 提供队列生命周期、消息处理、可见性超时、生存时间和元数据示例。
- 明确推荐 DefaultAzureCredential，并强调确定性释放客户端和异步凭据资源。
- 包含 JSON 消息和二进制 Base64 编码示例。
- 未提供 Azure 存储账户创建、网络配置或角色分配步骤。
- 未说明依赖版本、定价、吞吐限制或具体重试策略。
- 源材料没有给出此单个技能的测试场景或测试覆盖证据。
- 高级会话和主题等能力仅建议考虑 Service Bus，未在本技能中实现。
如何安装
在项目中运行 npx skills add microsoft/skills，在安装向导中选择此技能；README 说明技能会安装到所选代理的目录，例如 GitHub Copilot 使用 .github/skills/。该技能在仓库中的源路径是 .github/plugins/azure-sdk-python/skills/azure-storage-queue-py/SKILL.md。安装 Python 依赖：pip install azure-storage-queue azure-identity。
如何使用
当任务涉及“queue storage”“QueueServiceClient”“QueueClient”“message queue”或“dequeue”时调用此技能。例如：请使用 Azure Queue Storage SDK for Python，采用 DefaultAzureCredential 和上下文管理器，实现发送、接收并在成功处理后删除消息。 使用前设置 AZURE_STORAGE_ACCOUNT_URL；若生产环境使用 DefaultAzureCredential，还需设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据。
对比同类
技能明确将 Service Bus 作为需要会话、主题等高级功能时的考虑选项；除此之外，源材料未提供详细对比。