Azure Blob Storage Java 技能
帮助 Java 开发者可靠地构建 Azure Blob Storage 文件存储功能。
文档展示了 SAS、连接字符串、共享密钥和 DefaultAzureCredential 等认证方式，并覆盖上传、下载、复制、删除及 SAS 生成等外部副作用；但未明确最小权限、敏感凭据不得硬编码、用户确认、数据流、删除恢复或回滚要求，因此扣分。
核心 Blob Storage Java 操作路径较完整，包含一定异常处理示例；但未提供可执行验证，部分示例缺少导入，字节长度与字符串长度混用等问题可能导致不可靠行为，异常输入和失败诊断也较薄弱，因此扣分。
名称、描述、触发短语和主要场景清晰，覆盖容器、上传、下载、流式处理、元数据和 SAS；但未声明非适用边界、输入输出约束或中文使用说明，环境与中国大陆网络可达性也未说明，因此扣分。
结构清晰，按安装、客户端、核心模式、错误处理和环境变量组织，并有独立 examples.md；技能含 MIT 许可证、作者和版本号，但没有变更记录、维护责任、更新路径、版本兼容说明或系统化 FAQ，因此扣分。
文档直接提供常见 Azure Blob Java SDK 代码模板，能覆盖多数基础开发任务并减少查找成本；但示例未静态验证，存在导入和细节正确性不确定，生产级重试、并发、分页、权限和安全配置仍需用户补充，因此未给满分。
存在版本化 Maven 依赖、具体 API 示例、错误代码示例和完整示例，具备一定审计性；但没有该技能专属测试、构建结果或第三方执行证据，结论主要依赖文档本身，因此扣分。
- 不要在源代码中硬编码连接字符串、共享密钥或 SAS；优先使用最小权限的托管身份，并在执行删除、覆盖、复制和 SAS 生成前确认范围。
- 示例应在目标 SDK 版本和实际项目依赖下编译验证，特别检查缺失导入、流长度的字节语义、异常处理、重试、分页和资源清理。
- 未提供中国大陆网络可达性、服务端点替代方案或中文排障说明；部署前需自行确认 Azure 端点和认证服务可访问。
它能做什么 & 适用场景
这是一个面向 Azure Storage Blob SDK for Java 的 Agent Skill，适合编写上传、下载和管理 Blob Storage 数据的 Java 代码。它涵盖服务、容器、Blob 客户端创建，以及 SAS、连接字符串和 DefaultAzureCredential 身份验证。内容还包括流式读写、批量上传、元数据、属性、租约、复制、删除和错误处理。该技能位于 Microsoft agent-skills 单体仓库中，仓库整体包含 190 个技能并处于持续开发状态。
指导 Agent 生成 Maven 依赖和 Java 示例，创建 BlobServiceClient、BlobContainerClient 与 BlobClient；上传字符串、文件和输入流，设置 HTTP 标头、元数据及请求条件；将 Blob 下载到 BinaryData、文件、输出流或输入流；列出 Blob、按层级浏览、删除、复制、生成 SAS、读取属性、设置元数据、管理租约，并处理 BlobStorageException 的状态码和错误码。
- Java 后端开发者需要把本地文件上传到 Azure Blob Storage，并支持覆盖或“仅当不存在时上传”。
- 应用需要从 Blob Storage 下载文本、二进制文件或流式数据并在内存中处理。
- 团队需要按容器、虚拟目录或前缀列出 Blob，并读取元数据。
- 服务需要使用 SAS、连接字符串或 DefaultAzureCredential 连接存储账户。
- 并发写入场景需要通过 Blob 租约或请求条件控制访问。
优缺点一览
- 覆盖 Blob Storage 常见生命周期操作，包括容器、上传、下载、列举、删除和复制。
- 同时提供文件、BinaryData、InputStream 和 OutputStream 等数据处理模式。
- 包含 SAS、DefaultAzureCredential、元数据、HTTP 标头、租约和错误处理示例。
- README 报告该 Java 技能有 12 个测试场景。
- 内容聚焦 Azure Storage Blob SDK，不涵盖其他 Azure 存储服务。
- 未说明 Java 版本、项目构建流程或 Azure 资源创建步骤。
- 示例依赖有效的存储端点及凭据；具体权限配置未完整展开。
- 仓库 README 标注项目仍在积极开发，SDK 模式和测试可能继续更新。
如何安装
在支持该仓库技能的 Agent 环境中运行 npx skills add microsoft/skills，在安装向导中选择 azure-storage-blob-java。README 说明技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/；该技能的仓库路径是 .github/plugins/azure-sdk-java/skills/azure-storage-blob-java/SKILL.md。
如何使用
向 Agent 提出包含触发短语的任务，例如“使用 Azure Blob Storage Java SDK 上传文件”或“实现 blob streaming download”。技能建议使用 com.azure:azure-storage-blob 版本 12.33.0，并根据场景采用 SAS、连接字符串或 DefaultAzureCredential。具体项目构建命令、Java 版本和 Azure 资源创建步骤未在该技能中说明。