这个 Skill 能做什么，适合哪些场景？
该技能面向使用 @azure/storage-blob 的 TypeScript/JavaScript 开发者，覆盖 Azure Blob Storage 的客户端创建、身份验证和常见存储操作。它提供容器与 Blob 的创建、列举、删除、复制、属性和元数据管理示例，也涵盖块 Blob、追加 Blob、页 Blob、SAS 令牌及流式传输。内容同时说明 Node.js 与浏览器能力差异，并给出错误处理和实践建议。它适合需要快速建立 Azure Blob Storage 集成的编码代理场景，但不是独立运行的存储服务。
提供安装 @azure/storage-blob 与 @azure/identity 的步骤，指导代理读取 Azure 存储账户环境变量并创建 BlobServiceClient、ContainerClient 和 BlobClient。它给出容器创建、列举和删除，Blob 上传、下载、列举、删除和复制，以及属性、元数据和 HTTP 标头管理的 TypeScript/JavaScript 代码。它还展示 Microsoft Entra 凭据、连接字符串、共享密钥和 SAS 令牌认证，SAS 生成，以及块 Blob、追加 Blob和页 Blob 的使用方式。内容包括 Node.js 文件与流操作、浏览器上传、RestError 状态码处理和平台差异。
- TypeScript 后端开发者需要将文本、Buffer 或本地文件上传到 Azure Blob Storage 时。
- Node.js 应用需要使用流式传输处理大型文件，并显示上传进度时。
- 浏览器应用需要通过 SAS 令牌执行客户端 Blob 上传时。
- 开发者需要列举容器或 Blob、按前缀筛选并管理虚拟目录时。
- 日志或审计系统需要追加 Blob，或虚拟磁盘场景需要页 Blob 时。
如何安装这个 Skill？
- 不要将账户密钥、连接字符串或 SAS 令牌打印到日志、客户端代码或长期存储中；优先使用用户委托 SAS、HTTPS、短过期时间和最小权限。
- 在采用示例前核对当前 @azure/storage-blob 版本的真实 API，尤其是 uploadStream、浏览器上传、并发参数和响应流类型。
- 删除、覆盖、复制和生成写入型 SAS 可能造成外部数据影响；应在应用层加入明确确认、范围限制、审计和恢复策略。
- Azure 服务端点、身份认证和网络访问可能受中国大陆网络及企业策略影响，部署前需验证可达性。
- Shell / 命令行
- 网络访问
- 本地文件系统
Node.js >= 18.0.0@azure/storage-blob@azure/identity
在项目中运行：
npx skills add microsoft/skills
在安装向导中选择需要的技能。集合技能会安装到所选编码代理的目录，例如 GitHub Copilot 使用的 .github/skills/，多代理场景下也可建立符号链接。该技能的仓库路径为 .github/plugins/azure-sdk-typescript/skills/azure-storage-blob-ts/SKILL.md。使用 SDK 时，项目依赖安装命令为：
npm install @azure/storage-blob @azure/identity
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/azure-sdk-typescript/skills/azure-storage-blob-ts" ~/.claude/skills/
rm -rf "$tmp"根据源仓库地址和 Skill 路径自动生成，只复制这个 Skill 的文件夹。如果上文有作者提供的安装方式，请优先按作者说明操作；想只在当前项目中使用，把 ~/.claude/skills 换成项目里的 .claude/skills。
如何使用这个 Skill？
安装后，把下面任意一句发给 Agent 即可触发：
- 请用 @azure/storage-blob 和 DefaultAzureCredential 创建 BlobServiceClient，上传文件并处理 RestError。
- 上传、下载、列举或管理 Azure Blob Storage 中的 Blob
将该技能提供给编码代理后，可使用明确触发词，例如：“请用 @azure/storage-blob 和 DefaultAzureCredential 创建 BlobServiceClient，上传文件并处理 RestError。”也可以直接请求“上传、下载、列举或管理 Azure Blob Storage 中的 Blob”。实际账户名称、凭据、连接字符串或 SAS 值需要由项目环境提供；技能未定义独立的配置文件或运行命令。
这个 Skill 有哪些优点和局限？
- 覆盖容器、Blob、认证、SAS、元数据、错误处理和 Node.js/浏览器差异。
- 示例直接对应 @azure/storage-blob 的主要客户端和操作。
- 包含流式上传、文件下载、分页 Blob 和多种 Blob 类型的具体模式。
- README 显示该 TypeScript 技能有 17 个测试场景。
- 要求 Node.js 18 或更高版本，并依赖 Azure SDK 包。
- 共享密钥、SAS 生成以及文件和流方法部分仅适用于 Node.js。
- 示例依赖 Azure 存储账户、环境变量和相应权限；技能本身不提供资源 provisioning。
- 集合处于积极开发阶段，内容和测试仍可能更新。
这个 Skill 与同类方案有什么区别？
与相关 Skills 并排比较；分数均按同一 FSRS 标准得出。
| Skill | FS 评分 | Star 数 | 最近更新 | License |
|---|---|---|---|---|
| Azure Blob Storage TypeScript 技能 本页 ✓ Microsoft · 官方 | 51 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure Queue Storage TypeScript 技能 ✓ Microsoft · 官方 | 48 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Microsoft 365 Agents TypeScript 技能 ✓ Microsoft · 官方 | 48 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure Blob Storage Python 技能 ✓ Microsoft · 官方 | 55 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
| Azure Blob Storage Java 技能 ✓ Microsoft · 官方 | 47 · 谨慎使用 | ★ 2.7k | 3 个月前 | MIT |
FollowSkills 如何评估这个 Skill？
文档推荐 Entra ID、用户委托 SAS、HTTPS、短期令牌和最小权限，并披露了密钥、连接字符串及 SAS 的数据流；但仍展示账户密钥、匿名访问、账户级全权限 SAS，并直接打印 SAS URL，缺少用户确认、密钥泄露后的撤销/回滚流程和更严格的敏感数据处理约束，因此扣分。
涵盖安装、认证、容器、Blob、流式传输、SAS 和错误处理，且错误示例包含状态码反馈；但未提供该技能关键路径的专门测试，主文档与引用资料在 uploadStream 参数、浏览器上传 API 等处存在疑似不一致，部分环境和类型假设未验证，因此静态评分受限。
触发词、目标 SDK、Node.js 与浏览器差异及主要使用场景较清楚；但未明确非适用范围、权限前置条件、版本兼容边界或中文使用说明，也未说明中国大陆网络访问 Azure 端点可能存在的环境限制，因此扣分。
文档按安装、认证、操作、SAS、流式模式和最佳实践分层，带 MIT 许可、作者和 1.0.0 版本，并提供引用资料；但当前版本仅写作 12.x，缺少变更日志、明确维护责任、更新路径、FAQ 和系统化限制说明，因此扣分。
能够覆盖 Blob Storage 常见上传、下载、列举、删除、复制、元数据、流式处理及 SAS 生成任务，示例数量充足；但示例存在潜在 API/类型错误，未给出可验证的完整项目输出或测试结果，用户仍可能需要较多校正，因此按静态上限评分。
引用资料链接到 Azure SDK 官方仓库和官方文档，仓库还提供通用 CI、评估工作流和测试代码；但没有该技能专属的验收标准、测试覆盖或执行结果，且本次未执行代码，只能给予有限可审计性。
点击维度查看打分理由
证据充分度：低 — 主要依赖静态检查、作者材料或有限演示；适合发现线索，不适合做高风险决策。
查看完整评分方法 →