Fabric 容量管理助手（.NET）
用 .NET 通过 Azure Resource Manager 管理 Microsoft Fabric 容量。
文档明确要求避免硬编码凭据，并说明管理平面范围、认证变量和所需管理员身份；但创建、扩缩容、暂停及删除均涉及外部资源和费用，未要求逐步用户确认、最小 RBAC 权限、敏感数据流说明或可验证回滚，因此扣分。
安装、认证、资源层级、CRUD、长操作、异常状态和常见错误均有说明，且示例整体一致；但未提供该技能专属测试、编译验证、API 兼容性证明或异常恢复流程，静态审查下仅给中低分。
触发词、.NET 管理平面用途及与 Fabric 数据平面的边界较清晰，覆盖容量创建、查询、更新、暂停、恢复、删除、列举和 SKU；但未明确非目标场景、权限前置条件、输入输出约定，也未提供中文或中国大陆网络可达性说明。
结构包含安装、环境变量、认证、工作流、类型参考、状态、最佳实践、错误处理、陷阱、相关 SDK、版本和 MIT 许可证；但没有变更日志、维护责任和更新路径，外部参考链接的版本稳定性也未在文档内说明。
文档覆盖主要 Fabric capacity 管理任务，并提供可直接改造的 C# 示例、SKU 表和错误处理；但示例未经执行验证，成本、权限审批、幂等边界和删除前确认不足，用户仍需较多审查和适配，因此不超过静态上限。
技能包含版本、API 版本、包名和若干源码/文档引用，仓库还提供通用 CI 与测试线索；但未见该技能专属测试、提交结果或第三方执行证据，关键 API 真实性和示例可运行性无法由所给文件独立复现。
- 执行创建、扩缩容、暂停、恢复或删除前，应确认订阅、资源组、区域、SKU、RBAC 权限及预期费用；删除操作尤其需要显式确认和恢复/重建方案。
- 不要将 AZURE_CLIENT_SECRET 或其他凭据提交到代码、日志或提示词中；文档未说明密钥轮换、日志脱敏或权限最小化。
- 当前版本、API 版本、类型名称和示例调用均未通过该技能专属编译或集成测试证明，使用前应在目标 .NET/SDK 环境中验证。
- 技能未说明中国大陆网络访问 Azure、NuGet、Microsoft 文档和相关服务的可达性。
它能做什么 & 适用场景
该技能面向使用 .NET Azure SDK 管理 Microsoft Fabric 容量的开发者。它覆盖管理平面操作，包括创建、读取、更新、删除、扩缩容、暂停和恢复容量，以及检查名称可用性和查询 SKU。它不负责 Fabric 工作区、湖屋、仓库或数据项等数据平面操作。技能提供 Azure 身份认证、资源层级、状态处理、错误处理和常见陷阱的示例。
指导安装 Azure.ResourceManager.Fabric 和 Azure.Identity，使用 DefaultAzureCredential 或具体凭据创建 ArmClient，并通过订阅、资源组和 FabricCapacityResource 操作容量。它展示如何创建带管理员、区域、SKU 和标签的容量，读取状态与 SKU，更新 SKU 或管理员，暂停和恢复容量，删除容量，列出订阅或资源组中的容量，检查名称可用性，以及查询可用 SKU。
- Azure .NET 开发者需要在资源组中以代码创建 Microsoft Fabric 容量时使用。
- 平台工程师需要根据环境或负载调整 Fabric SKU、管理员或容量状态时使用。
- 运维人员需要在非工作时间暂停容量、恢复容量或检查资源状态时使用。
- 需要在部署前验证容量名称、区域和可用 SKU 的 Azure 团队使用。
优缺点一览
- 覆盖 Fabric 容量完整的管理平面生命周期。
- 提供可直接参考的 C# 异步 Azure SDK 示例。
- 包含身份认证、SKU、资源状态、错误处理和常见陷阱说明。
- MIT 许可，并可通过 Agent Skills 集合安装。
- 仅支持管理 Fabric 容量，不覆盖工作区、湖屋、仓库或数据项。
- 创建和扩缩容是长时间运行操作，容量创建可能需要 5–15 分钟。
- 实际权限、配额、区域 SKU 可用性和 Azure 资源计费取决于环境。
- 源材料未提供该单项技能独立的测试覆盖或兼容性矩阵。
如何安装
运行 npx skills add microsoft/skills，在安装向导中选择该技能。技能应安装到所选 Agent 的技能目录，例如 GitHub Copilot 使用的 .github/skills/。在 .NET 项目中安装依赖：dotnet add package Azure.ResourceManager.Fabric 和 dotnet add package Azure.Identity。
如何使用
向编码 Agent 提出诸如“使用 Azure.ResourceManager.Fabric 在资源组中创建一个 F64 Microsoft Fabric 容量”或“暂停并恢复现有 Fabric 容量”的请求。按照技能中的 C# 示例配置 AZURE_SUBSCRIPTION_ID 及所需身份变量，使用 ArmClient 获取订阅和资源组，再调用对应的异步 ARM 方法。容量创建、更新、暂停、恢复和删除示例使用 WaitUntil.Completed。
对比同类
如果需求是 Fabric 工作区、湖屋、仓库或数据项的数据平面操作，应改用 Microsoft Fabric REST API 或数据平面 SDK。Azure.ResourceManager 是核心 ARM SDK，而 Azure.Identity 负责身份认证；本技能聚焦 Azure.ResourceManager.Fabric。