Agent Skills
返回列表
浏览器自动化精灵

浏览器自动化精灵

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-bzwfrdvh/aipdd-playwright

技能介绍

解决的具体问题

在真实网页上重复完成响应式检查、登录流程、截图取证、交互验证时,自动化脚本很容易绑定到某个临时 URL、固定选择器和特定项目目录。不同环境中的安装位置、浏览器类型、已有会话也不一样。这个技能把“定位本机服务、编写聚焦脚本、执行并核验结果”的流程整理成可复用的浏览器自动化方案。

核心工作方式

  • 会先解析 SKILL_DIR,兼容技能可能安装在不同目录的情况,避免脚本路径假设失效。
  • 处理 localhost 任务时,先检测正在运行的开发服务器;只有一个结果时直接使用,多个结果时询问,没有结果时让用户提供或先启动服务器。
  • 默认把可复用脚本写入临时目录,除非用户明确要求保存到项目;保存后通过 PW_SCRIPT_DIR 保留脚本位置。
  • 默认使用可见浏览器;只有在用户要求或运行环境没有显示界面时,才切换到 headless: true。
  • 通过 node "$SKILL_DIR/scripts/run.js" 运行脚本,并在结束后汇报操作、失败项与产物路径。
  • 未检查目标页面结果之前,不会声称任务成功,避免只拿到 HTTP 200 就误判页面功能正常。

定位与断言策略

脚本优先按用户可见语义定位元素:getByRole() 配合可访问名称,表单控件用 getByLabel(),可见内容用 getByText(),测试契约存在时用 getByTestId()。操作本身会等待可操作性,等待结果更推荐 Web-first 断言或定位器的 waitFor(),而不是 waitForSelector()、固定休眠或等待 networkidle。

辅助能力与配置

可用辅助函数包括 detectDevServers、getExtraHeadersFromEnv、launchBrowser、createContext、handleCookieBanner 和 takeScreenshot。操作、等待、提取、认证、表格和重试直接使用 Playwright 的定位器与断言。

通过环境变量可控制浏览器与执行细节:PW_BROWSER 选择 chromium、firefox 或 webkit,PW_CHANNEL 指定 Chrome 或 Edge 等通道,PW_EXECUTABLE_PATH 指定浏览器路径,PW_HEADLESS 控制可见模式,PW_SCRIPT_DIR 保存脚本,PW_ARTIFACT_DIR 控制截图输出。额外 HTTP 头可通过 PW_HEADER_NAME / PW_HEADER_VALUE 或 PW_EXTRA_HEADERS 配置。

适用边界与注意点

适合聚焦的浏览器任务:响应式检查、登录流程、工具型网页交互、会话复用和截图产物收集。登录流程必须使用用户提供的测试凭据,不能编造或暴露真实凭据;同时应验证导航跳转与登录后的页面元素。

也可以按远程调试模式连接到已有 Chrome 会话,从而复用其中的 Cookie 与扩展。但被连接的浏览器拥有用户本人的访问权限,除非用户明确要求,不要用它处理敏感信息。

网络拦截、API Mock、认证状态保存、视频录制、视觉检查、设备模拟和 CI 模式等更完整用法,需要参考技能自带的 references/api-reference.md。一次性小任务也可以使用内联执行,但要在片段内关闭浏览器。

使用场景

  • 接手前端项目时,检测本地开发服务器,用 Playwright 打开 localhost 页面,验证响应式布局。
  • 需要验证登录流程时,使用用户提供的测试账号,通过 getByLabel 完成表单填写并检查跳转。
  • 排查页面交互问题时,调用 takeScreenshot 保存关键节点截图,作为复现证据。
  • 自动化重复浏览器任务时,将脚本写入临时目录,运行后汇报失败项与产物路径。

适合人员

  • 需要维护网页兼容性的前端工程师,想在不同浏览器中验证页面行为。
  • 负责自动化测试的工程师,需要编写稳定的 Playwright 脚本并保存截图证据。
  • 频繁手动登录测试环境验证功能的开发者,希望用脚本替代重复操作。
  • 需要验证登录后页面状态的测试人员,想确认导航和关键元素是否正确。