Azure Tables Python 技能
帮助 Python 开发者使用 Azure Tables 完成安全认证、实体管理、查询与批量事务操作。
文档推荐DefaultAzureCredential、生产环境限制凭据链，并要求客户端和异步凭据使用上下文管理器，体现了最小化凭据暴露和资源清理意识；但示例包含创建、更新、删除表和实体等外部副作用，没有用户确认、回滚/恢复、数据敏感性处理或权限范围说明，因此扣分。
核心客户端、CRUD、查询、批处理和异步路径的说明总体一致，并提供了事务异常示例；但未提供该技能专属测试、版本/API复现证据，资源生命周期衔接不完整，异常覆盖和异常输入反馈较薄，因此静态评分不超过10并扣分。
触发词、Python受众以及Azure Storage Tables/Cosmos DB Table API场景较清晰；但非适用范围、服务差异、网络/区域可达性、中文使用说明和精确触发边界不足，可能在相邻Azure存储需求中误触发，因此扣分。
文档结构清晰，包含安装、环境变量、认证、客户端类型、操作示例、最佳实践、MIT许可、作者和1.0.0版本，并有参考文件索引；但缺少变更日志、维护责任人的明确更新路径、依赖版本约束、完整故障排查和更多限制说明，因此扣分。
文档能直接支持常见的表客户端初始化、实体CRUD、查询、批处理和异步代码生成，核心任务价值明确；但示例缺少完整可运行的端到端上下文、资源清理/删除路径、部署前权限配置和生产级错误处理，仍需较多人工审查，因此未给满分。
技能自身包含具体代码、参数和参考文件，仓库还提供通用CI与测试工具；但所给材料没有该技能覆盖的提交测试或第三方执行结果，且静态审查未执行代码，关键API正确性只能有限核验，因此扣分。
- 删除表和实体的示例具有不可逆或高影响外部副作用；生产使用前应加入显式确认、权限最小化和备份/恢复策略。
- 示例未固定azure-data-tables和azure-identity版本，也未提供该技能专属的可重复测试；请根据当前官方API文档核对方法签名和查询参数。
- 文档主要为英文，未说明中国大陆网络、Azure区域和终结点可达性；部署前应单独验证目标环境。
它能做什么 & 适用场景
该技能面向 Azure Storage Tables 和 Cosmos DB Table API，提供 Python SDK 的使用指导。内容涵盖同步与异步客户端、表生命周期、实体 CRUD、查询、属性选择和批量事务。它建议使用 DefaultAzureCredential，并要求通过上下文管理器释放客户端和凭据资源。适合需要在 Python 应用中实现 NoSQL 键值存储的开发者。
指导安装 azure-data-tables 和 azure-identity，配置 Azure Storage Tables 或 Cosmos DB Table API 端点，并编写 TableServiceClient 与 TableClient 代码。它说明如何创建、删除和列出表，创建、读取、更新、删除实体，执行分区内查询、参数化过滤、属性选择和跨分区枚举。它还展示同一分区内的批量事务、同步与异步客户端，以及 PartitionKey、RowKey 和常见 Python 数据类型的使用。
- Python 开发者需要为 Azure Storage Tables 建立实体 CRUD 服务时，使用该技能生成 TableClient 代码。
- 应用需要将结构化键值数据写入 Cosmos DB Table API 时，使用该技能配置端点和认证。
- 团队需要按分区查询订单或业务实体，并减少跨分区查询时，参考其查询和分区键建议。
- 服务需要在同一分区内批量创建或更新多个实体时，采用其事务操作示例。
- 高吞吐 Python 服务需要异步访问表数据时，参考其 aio 客户端模式。
优缺点一览
- 覆盖 Azure Storage Tables 与 Cosmos DB Table API。
- 同时提供同步和异步 Python 客户端示例。
- 包含表管理、实体 CRUD、查询、属性选择和批量事务。
- 强调 DefaultAzureCredential、参数化查询和上下文管理器等实践。
- 每个实体都必须包含 PartitionKey 和 RowKey。
- 批量事务只能处理同一分区中的操作。
- 跨分区查询被明确标为应谨慎使用的高成本模式。
- 源材料未提供该技能专属的测试覆盖或完整参考文件内容。
如何安装
运行 npx skills add microsoft/skills，在向导中选择此技能。技能会安装到所选 Agent 的目录，例如 GitHub Copilot 使用 .github/skills/，并可在多个 Agent 间建立链接。
如何使用
向编码 Agent 提出类似请求：Help me implement Azure Table Storage entity CRUD in Python using TableClient and DefaultAzureCredential. 触发词包括 table storage、TableServiceClient、TableClient、entities、PartitionKey 和 RowKey。使用前设置对应端点环境变量，并根据场景选择同步或异步客户端。