Azure Playwright 工作区管理技能
用 .NET 通过 Azure Resource Manager 配置和管理 Microsoft Playwright Testing 工作区。
技能明确使用 DefaultAzureCredential、环境变量和避免硬编码密钥,且说明管理面与测试执行面的边界;但创建、更新和删除 Azure 资源均未要求用户确认,删除缺少回滚/恢复说明,权限范围、令牌数据流和敏感输出处理也未充分披露,因此扣分。
文档覆盖安装、认证、资源层级、主要 CRUD、配额、异步操作和 RequestFailedException 处理,失败反馈基本可诊断;但本次仅静态阅读,未提供该技能路径的可执行复现或专门测试,且缺少订阅 ID 缺失、权限不足、超时、部分失败和 API 版本兼容性的处理,因此不超过静态上限并扣分。
名称、受众、管理面范围、触发短语以及与 NUnit 测试执行 SDK 的非适用边界较清楚;但输入前置条件、所需 RBAC、区域/云环境差异、非 Azure 或无法访问 Azure 服务时的行为,以及中文使用说明不完整,环境适配证据有限,因此扣分。
SKILL.md 结构清晰,按安装、认证、层级、工作流、类型、最佳实践和错误处理渐进展开;含 MIT、作者和版本元数据及相关文档链接,但版本信息存在 Stable/Preview 表述不够清晰,缺少变更日志、维护责任、更新路径、依赖版本约束和常见问题,因此扣分。
该技能为工作区创建、查询、列举、更新、名称检查、配额读取和删除提供了可直接参考的 .NET 代码,且明确区分管理面与数据面;但没有静态可验证的真实输出或目标路径测试,代码正确性、API 可用性和生产可用性仍需人工核验,缺少幂等冲突、权限和恢复场景,因此不超过静态上限并扣分。
技能包含具体包名、类型、资源提供程序、API 版本和官方文档链接,仓库还提供通用 CI/测试基础设施;但给定材料未显示该技能自身的验收测试、真实 CI 覆盖或第三方执行证据,关键声明主要依赖文档内容,因此仅给有限可审计分数。
- 删除工作区是破坏性操作;使用前应增加明确的用户确认、资源范围复核和恢复/备份策略。
- 应核验 Azure.ResourceManager.Playwright 1.0.0、2025-09-01 API 版本及示例中的类型和方法是否与目标环境实际可用。
- 应补充最小 RBAC 权限、认证失败/权限不足处理、订阅 ID 缺失校验、区域和中国区云环境适配说明。
- 仓库提供的 CI/测试材料是通用基础设施,不能证明该技能路径本身已通过执行验证。
它能做什么 & 适用场景
该技能面向使用 .NET 的 Azure 开发者,覆盖 Microsoft Playwright Testing 的管理面操作。它可以创建、查询、更新和删除工作区,检查名称可用性,并读取订阅级和工作区级配额。它不用于运行 Playwright 测试,测试执行应使用单独的 Azure.Developer.MicrosoftPlaywrightTesting.NUnit SDK。技能提供 Azure 身份验证、资源层级、异步长时操作、错误处理和数据平面 URI 配置示例。
指导代理安装 Azure.ResourceManager.Playwright 和 Azure.Identity,使用 DefaultAzureCredential 创建 ArmClient,定位 Azure 订阅和资源组,并通过 PlaywrightWorkspaceResource 执行工作区 CRUD 操作。它还指导检查工作区名称可用性、读取订阅级和工作区级配额、处理 RequestFailedException,以及在创建工作区后保存 DataplaneUri 供测试执行配置使用。
- Azure .NET 开发者需要按资源组创建 Microsoft Playwright Testing 工作区时,使用该技能生成 ARM 配置代码。
- 平台工程师需要列出订阅中的 Playwright 工作区并检查其部署状态时,使用该技能。
- 团队需要在创建工作区前验证名称可用性时,使用该技能调用 ARM 检查接口。
- 运维或开发团队需要查看订阅级、工作区级配额,或更新工作区标签时,使用该技能。
- 开发者已经创建工作区,需要把数据平面 URI 配置到 Playwright 测试执行环境时,使用该技能。
优缺点一览
- 覆盖工作区创建、读取、更新、删除、名称检查和配额查询等明确的 ARM 管理操作。
- 提供可复制的 C# 异步示例、资源层级和错误处理模式。
- 明确区分管理面 SDK 与测试执行 SDK,降低选错包的风险。
- 采用 DefaultAzureCredential,并涵盖资源组级和订阅级访问方式。
- 仅覆盖 Microsoft Playwright Testing 管理面,不负责运行 Playwright 测试。
- 示例要求 Azure 订阅、凭据和网络访问;源材料未说明所需的最小 RBAC 权限。
- 源材料未提供该单个技能的独立测试覆盖或兼容性验证结果。
- 源材料未说明 Azure 资源和测试服务的具体费用。
如何安装
运行 npx skills add microsoft/skills,在向导中选择此技能。README 说明技能会安装到所选代理的目录,例如 GitHub Copilot 使用 .github/skills/;源材料未提供该单个技能的专用安装命令。
如何使用
在已安装该技能的编码代理中输入例如“创建一个 Playwright Testing workspace”或“检查 Playwright workspace 名称是否可用”。生成的 .NET 项目通常需要运行 dotnet add package Azure.ResourceManager.Playwright 和 dotnet add package Azure.Identity,设置 AZURE_SUBSCRIPTION_ID,再使用 DefaultAzureCredential 或指定的 Azure 凭据执行 ARM 操作。不要用它运行 Playwright 测试;测试执行需使用 Azure.Developer.MicrosoftPlaywrightTesting.NUnit。
对比同类
该技能明确将 Azure.ResourceManager.Playwright 与 Azure.Developer.MicrosoftPlaywrightTesting.NUnit 区分开:前者负责工作区和配额等管理面操作,后者负责在云浏览器上运行 NUnit Playwright 测试。