rhdh-playwright

rhdh-playwright 是一个技能，用于通过 playwright-cli 自动化导航、测试和验证 RHDH（Red Hat Developer Hub）实例的 Web 界面。该技能明确要求使用 playwright-cli，而不是 Playwright MCP。

用途

该技能帮助用户对 RHDH 实例进行 UI 层面的自动化验证，包括检查页面是否可访问、实体是否存在、标签页是否齐全、登录流程是否正常等。它提供了标准化的命令模式与验证步骤，适合在开发或测试流程中执行回归检查。

主要能力

• 访客登录：打开 RHDH 实例后检测登录页面，通过快照识别访客登录选项（如 “Guest” 卡片上的 “Enter” 按钮）并完成登录。
• 侧边栏导航：使用 navigation "sidebar nav" 定位链接，支持 Home、Catalog、APIs、Docs、Create、Explore、Settings、Notifications、Search 等目标。
• 目录浏览与搜索：在 Catalog 页面使用 Kind、Type、Owner、Lifecycle、Tags 等过滤器，支持按实体名称搜索，并展示表格列（Name、System、Owner、Type、Lifecycle、Description、Tags、Actions）。
• 实体页面验证：通过 URL 模式 /catalog/{namespace}/{kind}/{name} 直接打开实体页，或在目录中搜索；验证标题、元数据（Owner、Lifecycle、System）、标签页（tablist “Tabs”）是否存在，并可点击切换标签页。
• About 卡片读取：从 Overview 标签页的 “About” 卡片中读取描述、Owner、System、Tags、Kind、Type、Lifecycle 以及 “View Source”、“View TechDocs” 链接。
• 截图证据：使用 playwright-cli screenshot --filename 保存截图到 .playwright-cli/ 目录。

使用方式

1. 首先运行 command -v playwright-cli 确认工具可用；若缺失则停止并报告前置条件不可用。
2. 使用 playwright-cli open <RHDH_URL> --browser chromium 打开目标 URL（URL 由用户提供或来自上下文，不得硬编码）。
3. 通过 playwright-cli snapshot 获取页面状态和元素引用，使用引用 ID 进行点击、填写等操作。
4. 根据验证目标执行相应命令，如导航到目录、搜索实体、检查标签页、截图等。
5. 完成后关闭浏览器会话，并汇总可见的告警、警告、错误或缺失的标签页。

适用场景

• 验证 RHDH 实例中特定目录实体是否存在。
• 检查实体页面是否包含预期的标签页。
• 测试侧边栏导航是否正常工作。
• 收集 UI 验证的截图证据。

限制

• 必须使用 playwright-cli，不能使用 Playwright MCP。
• 打开浏览器时必须指定 --browser chromium。
• URL 不能硬编码，需由用户提供或从上下文中获取。
• 需要本地已安装 playwright-cli，否则无法执行。
• 日志和截图自动保存在 .playwright-cli/ 目录。
• 技能未提供关于 RHDH 版本兼容性、权限要求或性能方面的更多细节。