azure-storage-file-share-ts
作者 microsoftazure-storage-file-share-ts 是面向后端开发的 Azure File Share JavaScript/TypeScript 技能，基于 @azure/storage-file-share。可用于创建共享、管理目录、上传或下载文件，以及在 Azure Files SMB 工作流中处理文件元数据。它旨在减少 SDK 配置和鉴权中的试错成本。
该技能评分为 82/100，说明它是目录用户的一个扎实候选项。仓库提供了真实的 Azure Files TypeScript SDK 工作流、清晰的触发词、安装/鉴权示例，以及足够的操作细节，能帮助智能体比通用提示更少地依赖猜测来使用它。
- 对 Azure Files 任务的触发性明确：描述中直接提到文件共享操作、SMB，以及 ShareServiceClient 和 ShareClient 等 SDK 标识符。
- 操作流程内容充实：包含安装、环境变量、鉴权模式和代码示例。
- 仓库元数据可信且非占位：frontmatter 合法、MIT 许可证、Microsoft 作者，并且没有实验性或仅演示用途的标记。
- 描述字段很短，因此用户需要结合正文来理解范围和限制。
- 缺少支持文件（没有 scripts、references 或 resources），因此某些高级用法或边缘场景可能需要查阅外部 SDK 文档。
azure-storage-file-share-ts 技能概览
azure-storage-file-share-ts 是用于通过 @azure/storage-file-share 操作 Azure Files 的 Azure File Share TypeScript/JavaScript 技能。它最适合需要创建共享、管理目录、上传或下载文件，以及处理文件元数据的后端开发者，且这些场景都基于 Azure SMB 文件共享模型。
它要解决的核心任务很直接：把存储账户和认证方式，转成稳定可用的 file-share 操作，而不是让你自己猜 SDK 应该怎么初始化。azure-storage-file-share-ts 技能最有价值的地方，在于它能把“我需要访问 Azure file share”这件事，落到可运行代码上，并且带上正确的客户端类型、认证模式和环境变量用法。
这个技能适合做什么
当你需要下面这些能力时，就该用这个技能：
- 创建或连接 Azure file share
- 读取、写入、重命名或删除文件和目录
- 在 Node.js 或 TypeScript 中使用偏 SMB 的 Azure Files 工作流
- 在后端服务中统一 file-share 访问方式
为什么值得安装
azure-storage-file-share-ts skill 能减少在凭据、客户端初始化和包选择上的配置失误。它比通用 Azure 提示更具体，因为它聚焦的是实际 SDK、预期运行时，以及生产环境里真正重要的认证路径。
最适合放在哪些场景
这个 azure-storage-file-share-ts for Backend Development 技能最适合服务端应用、API、worker 任务和内部工具。它不是泛泛的云存储教程；它面向的是会影响认证方式、连接方式和文件操作结构的实现决策。
如何使用 azure-storage-file-share-ts 技能
安装并确认 SDK 上下文
进行 azure-storage-file-share-ts install 时，请使用技能里 package 级别的 SDK 指引，并确认你的项目目标运行环境是 Node.js 18 或更高版本。核心包是 @azure/storage-file-share，如有需要再加上 @azure/identity。
典型安装方式如下：
npm install @azure/storage-file-share @azure/identity
先把输入说准确
这个技能在你明确说明要做什么操作、采用哪种认证方式时效果最好。一个高质量的提示应当说明：
- 需要的是 share、directory 还是 file 操作
- 可用的认证方式：connection string、shared key 还是 Azure AD
- 代码是 TypeScript 还是 JavaScript
- 源路径和目标路径长什么样
- 是否有上传大小、覆盖行为或环境变量使用方面的限制
提示示例：
“使用 azure-storage-file-share-ts 创建一个 TypeScript 示例，连接 AZURE_STORAGE_CONNECTION_STRING，在 share 不存在时自动创建，上传本地文件到某个目录，并返回清晰的错误处理。”
先读这些文件
在做 azure-storage-file-share-ts usage 时，先读 SKILL.md，再查看仓库里与下面主题相关的示例：
- installation
- environment variables
- authentication
- connection string setup
- shared key 或 token-based credential 示例
如果仓库只提供了一个文件，先把重点放在定义客户端创建和认证流程的部分，再去复制任何操作代码。
按仓库的实际工作流来用
一个实用的 azure-storage-file-share-ts guide 工作流是：
- 先选与你部署环境匹配的认证模型
- 创建
ShareServiceClient - 选择 share 或 directory 目标
- 先完成一个操作，再扩展到批量处理或生命周期处理
- 先确认环境变量是否正确，再假设是 SDK 出了问题
为了得到更好的结果，请把需求收窄。与其一次要求所有 file-share 操作，不如只要一条完整路径，比如“连接、创建 share、上传文件”。
azure-storage-file-share-ts 技能常见问题
azure-storage-file-share-ts 只适用于 Azure Files 吗？
是的。azure-storage-file-share-ts 技能用于 Azure File Share 操作，不是 Blob Storage。如果你的任务是对象存储、队列处理，或者是在 Azure Files 的 SMB 语义之外做通用文件同步，那就不是这个技能的适用范围。
必须用 TypeScript 才能用吗？
不需要。这个 SDK 同时支持 JavaScript 和 TypeScript。即使你的项目只是普通 Node.js，azure-storage-file-share-ts skill 依然有用，因为真正要选的是 Azure Files SDK 和认证模式，而不是语言语法本身。
这会比自己写一个通用提示更省事吗？
通常会。通用提示很容易生成导入错误的包、使用错误的凭据类型，或者跳过 Azure 特有的环境配置。azure-storage-file-share-ts install 和使用指引能让结果更贴近实际 SDK。
什么情况下不该用这个技能？
如果你并不是在处理 Azure File Shares，如果你需要浏览器端存储访问，或者你的应用无法使用这个 SDK 支持的凭据模型，就不该用它。如果你需要的是完整的基础设施或部署指南，而不是 SDK 使用方式，它也不合适。
如何改进 azure-storage-file-share-ts 技能
把你的认证方式和运行时说清楚
提升质量最大的做法，是明确说明应用如何认证。请说明你手头是 connection string、account key，还是 Azure AD access。同时还要指出 Node.js 版本、包管理器，以及代码是否必须优先以 TypeScript 编写。这样可以避免对 azure-storage-file-share-ts usage 产生错误假设。
一次只问一条操作路径
最常见的失败模式，是笼统地要求一个“Azure Files helper”，却没有定义具体要做什么。更好的输入包括：
- “在缺失时创建 share 和 directory”
- “把一个 buffer 上传到已有 share”
- “列出某个目录中的文件，只返回名称”
- “下载文件并保存到本地”
这类更窄的提示通常会产出更干净的代码，也更少出现不受支持的分支。
给出运行约束
如果代码必须在生产环境运行，请说明覆盖规则、secret 处理、重试预期，以及应用是在 CI、容器里还是长期运行的后端服务中执行。这些细节比额外功能要求更重要，因为它们会改变认证和错误处理方案。
用真实路径做验证
拿到第一版结果后，用你真实的 share 名称、目录路径和文件名继续迭代。把占位符换成真实值，并让技能调整 imports、客户端初始化和路径处理。这是让 azure-storage-file-share-ts 真正好用、而不是只停留在仓库扫读层面的最快方式。