Azure Fabric 容量管理助手
用 Python SDK 管理 Microsoft Fabric 容量及其生命周期。
证据显示使用 DefaultAzureCredential、避免连接字符串，并建议生产环境限制凭据链，具备一定最小权限与审计意识；但创建、更新、暂停、删除等有外部和计费影响的操作没有用户确认、回滚或恢复流程，数据流与权限范围也未充分说明，因此扣分。
文档覆盖基本 CRUD、LRO 和上下文管理，但存在明显可复现风险：示例使用未导入的 FabricCapacityAdministration，主文档使用 CapacitySku 而参考文档使用 RpSku，list_skus 调用签名互相矛盾，且缺少异常处理和可诊断失败反馈。静态评估不得超过 10 分，故保守给分。
触发词、目标用户和核心场景较明确，覆盖 Fabric capacity 管理；但未清晰界定不适用范围、权限前置条件、异步用法或中国大陆网络环境，且对 SDK/API 版本差异提示不足，因此扣分。
具备 YAML 元数据、MIT 许可、安装说明、环境变量、分层参考文件和版本号，信息架构基本清楚；但版本仅为 1.0.0，没有变更记录、维护责任与更新路径说明，引用文件内容还存在不一致，故未满分。
可直接帮助用户理解并生成常见容量管理代码，且包含 LRO、SKU 和状态说明；然而关键示例可能无法直接运行，删除等操作缺少安全流程，错误处理、分页、监控和生产验证不完整，静态证据不足以证明结果正确性，因此不超过 7 分。
仓库提供可审计的源文档、MIT 许可证以及通用 CI/测试材料，但所给测试未覆盖该技能的关键 Python SDK 路径，也没有该技能专属验收测试或第三方执行结果；主要结论仍依赖文档声明，因此不超过 5 分。
- 在采用示例前核对当前 azure-mgmt-fabric 版本的模型、方法名和 list_skus 参数签名；尤其修复 FabricCapacityAdministration 未导入以及 CapacitySku/RpSku 不一致。
- 对创建、扩容、暂停和删除操作增加显式确认、权限最小化、审计记录和可行的恢复/回滚方案；删除示例不应默认直接执行。
- 补充异常分类、轮询超时、重试边界、分页、权限不足和资源不存在时的可诊断处理，并增加该技能专属可执行测试。
- 确认 DefaultAzureCredential(require_envvar=True) 与 AZURE_TOKEN_CREDENTIALS 的要求是否符合目标环境，并验证中国大陆网络和企业代理条件。
它能做什么 & 适用场景
这是一个面向 Azure Fabric Management SDK for Python 的编码助手技能。它帮助开发者安装 SDK、配置 Azure 身份验证，并通过 FabricMgmtClient 创建、查询、列出、更新、暂停、恢复和删除 Microsoft Fabric 容量。技能还覆盖名称可用性检查、SKU 查询、容量状态和长时间运行操作。它适合需要以 Python 自动化管理 Fabric 容量与资源的 Azure 开发者。
指导用户安装 azure-mgmt-fabric 和 azure-identity，读取 AZURE_SUBSCRIPTION_ID、AZURE_RESOURCE_GROUP 及相关凭据配置，使用 DefaultAzureCredential 或指定的 Azure 凭据创建 FabricMgmtClient，并调用 fabric_capacities 和 operations 操作组。示例涵盖容量创建、详情读取、按资源组或订阅列出、更新 SKU 和标签、暂停、恢复、删除、名称可用性检查及 SKU 列表查询；变更操作通过轮询器和 .result() 等待完成。
- Azure Python 开发者需要以代码创建 Microsoft Fabric 容量并设置区域、SKU 和管理员。
- 平台工程师需要按资源组或订阅盘点 Fabric 容量及其状态。
- 运维团队需要暂停闲置容量以停止计费，并在需要时恢复容量。
- 应用团队需要扩展容量 SKU、添加成本追踪标签或在创建前检查名称。
- 开发者需要正确处理 Fabric 管理 API 的长时间运行操作。
优缺点一览
- 覆盖 Fabric 容量的主要生命周期操作，包括创建、更新、暂停、恢复和删除。
- 明确推荐 DefaultAzureCredential，并说明本地开发和生产环境的凭据配置。
- 强调客户端、异步凭据和 HTTP 传输的确定性资源释放。
- 包含 SKU、状态、名称检查和长时间运行操作处理示例。
- 内容聚焦于容量管理，没有展示更广泛的 Fabric 工作负载或分析操作。
- 创建容量示例使用了 FabricCapacityAdministration，但该示例未展示对应的导入语句。
- 源材料未提供该单个技能的专属测试覆盖证据。
- 引用的 references/capabilities.md 和 references/non-hero-scenarios.md 内容未包含在给定材料中。
如何安装
将该技能目录放入所用编码代理的技能目录中；整个仓库可通过 npx skills add microsoft/skills 安装并在向导中选择技能。Python 依赖安装命令为：pip install azure-mgmt-fabric 和 pip install azure-identity。源材料未说明该单个技能在各代理中的具体复制路径。
如何使用
可用类似以下提示触发：使用 azure-mgmt-fabric 在 Python 中创建并管理 Microsoft Fabric 容量，采用 DefaultAzureCredential 和上下文管理器。 使用前设置 AZURE_SUBSCRIPTION_ID 和 AZURE_RESOURCE_GROUP；生产环境使用 DefaultAzureCredential 时设置 AZURE_TOKEN_CREDENTIALS=prod 或指定凭据。根据项目选择同步或异步模式，并对所有变更操作等待 LRO 完成。