用途:面向浏览器自动化与网页测试的通用技能,可根据用户需求临时编写 Playwright 脚本并执行,而不是只运行预置脚本。
主要能力:自动检测正在运行的本地开发服务器;测试页面并截图;填写并提交表单;验证登录跳转;检查失效链接;在多个视口下检查响应式设计;提取表格数据;处理 Cookie 横幅;可通过环境变量注入自定义 HTTP 请求头。脚本默认使用可见浏览器(headless: false)便于调试。
使用方式:先根据 SKILL.md 所在位置确定技能目录并替换 $SKILL_DIR。首次使用需在技能目录执行 npm run setup 安装 Playwright 与 Chromium。检测开发服务器命令:cd $SKILL_DIR && node -e "require('./lib/helpers').detectDevServers().then(servers => console.log(JSON.stringify(servers)))"。脚本写入 /tmp/playwright-test-.js,并以 cd $SKILL_DIR && node run.js /tmp/playwright-test-.js 执行;简单任务可用 node run.js 内联执行。URL 应通过常量或环境变量参数化。自定义请求头可用 PW_HEADER_NAME、PW_HEADER_VALUE 或 PW_EXTRA_HEADERS,配合 helpers.createContext() 或 getContextOptionsWithHeaders() 使用。
适用场景:本地站点页面的功能与视觉检查、表单与登录流程验证、响应式布局截图、链接可用性排查、简单数据抽取,以及需要复用脚本的回归测试。
限制:需已安装 Node 与 Playwright 及 Chromium;涉及真实账号、密钥或外部站点的测试可能受权限、验证码、反自动化机制或网络条件限制;不提供收费、性能指标或跨浏览器覆盖的具体承诺;更高级的 API 用法仅指向 API_REFERENCE.md,具体内容未提供。