Azure Blob Storage Python 技能
帮助 Python 开发者安全高效地操作 Azure Blob Storage。
文档推荐 DefaultAzureCredential、限制生产凭据链并避免账户密钥，且展示用户委派 SAS 和最小读取权限，降低凭据风险；但上传、删除、SAS 生成等外部和破坏性操作没有用户确认、回滚或恢复说明，数据传输、敏感数据处理和权限边界也不完整，因此扣分。
核心客户端层级、上传、下载、列举和异步示例大体一致，且强调上下文管理；但缺少异常处理、重试、分页、冲突、权限失败和网络失败反馈，异步示例在主文档中还出现凭据生命周期不一致，静态证据不足，按校准不超过10分。
触发词、目标 SDK、典型场景和同步/异步模式较清楚；但未明确非适用范围、输入输出契约、版本兼容边界或中文使用指导，也未说明中国大陆网络对 Azure 终端点和认证服务的可达性，因此扣分。
具备清晰的安装、认证、客户端层级、核心流程、性能和参考文件结构，含 MIT、作者和1.0.0版本元数据；但依赖未锁定，缺少变更日志、维护责任、更新路径、故障排查和完整限制说明，且引用的参考内容有重复。
能够直接覆盖常见 Blob 容器、上传、下载、列举、删除、元数据和 SAS 任务，示例可作为起点；但示例不是完整可运行工作流，缺少资源清理、生产错误处理和验证步骤，删除等高影响操作仍需大量人工审查，静态校准限制最高为7分。
技能文件、参考文件、许可证、固定修订版和仓库 CI/测试基础设施提供了可审计材料；但没有该技能专属测试、真实执行结果或针对关键 API 的第三方交叉验证，不能声称独立复现，故低分。
- 删除 Blob 示例没有确认、软删除/快照恢复或回滚说明，直接采用前应由用户确认资源范围。
- 生产依赖未固定版本，且示例没有覆盖权限不足、网络失败、重试、分页和大文件边界。
- 文档未说明 Azure 认证与服务端点在中国大陆网络环境中的可达性，也未提供中文使用说明。
它能做什么 & 适用场景
该技能为 Azure Blob Storage Python SDK 提供可直接用于编码代理的操作指南。内容涵盖容器和 Blob 的创建、上传、下载、列举、删除、属性与元数据管理，以及大文件并发传输。它优先推荐 DefaultAzureCredential、Microsoft Entra 身份验证和上下文管理器，适合需要在本地开发与 Azure 生产环境之间保持一致认证方式的 Python 项目。
指导代理安装 azure-storage-blob 和 azure-identity，配置存储账户环境变量，并使用 BlobServiceClient、ContainerClient 和 BlobClient 执行容器创建、Blob 上传、下载、列举、层级遍历、删除、属性读取、元数据设置和内容类型设置。它还展示了大文件分块与并发传输、用户委派 SAS 令牌生成，以及同步和异步客户端用法。
- Python 开发者需要将本地文件、字节或数据流上传到 Azure Blob Storage 时。
- 后端工程师需要从 Blob 下载文件到磁盘、内存或现有缓冲区时。
- 应用需要按前缀列出 Blob，或遍历虚拟目录层级时。
- 团队需要使用 Microsoft Entra 身份而非连接字符串或账户密钥访问存储时。
- 处理大型上传或下载，并需要配置分块大小和并发度时。
优缺点一览
- 覆盖 Azure Blob Storage 的核心对象操作和常见文件传输流程。
- 明确推荐 DefaultAzureCredential、用户委派 SAS 和生产环境凭据约束。
- 同时提供同步、异步、流式传输和并发传输示例。
- 包含资源释放、内存效率和内容类型等实践建议。
- 内容聚焦 Blob Storage SDK，不覆盖其他 Azure 存储服务。
- 源材料未提供该单个技能的独立测试结果或版本兼容矩阵。
- 需要 Python、Azure SDK 包、Azure 存储账户和相应身份权限。
- 部分运行环境、权限配置和错误处理细节未展开说明。
如何安装
运行 npx skills add microsoft/skills，在安装向导中选择需要的技能。该技能位于 .github/plugins/azure-sdk-python/skills/azure-storage-blob-py/SKILL.md。README 未说明单独安装该技能的专用命令。
如何使用
在支持 Agent Skills 的编码代理中提出具体请求，例如：“使用 azure-storage-blob Python SDK，通过 DefaultAzureCredential 上传并下载一个 Blob。”按照技能指南安装 azure-storage-blob azure-identity，设置 AZURE_STORAGE_ACCOUNT_NAME 或 AZURE_STORAGE_ACCOUNT_URL，并在生产环境按需设置 AZURE_TOKEN_CREDENTIALS=prod。同步或异步代码都应使用相应客户端和上下文管理器；更具体的运行环境配置未在源材料中说明。