用途:当无法访问被测应用源代码(如第三方站点、仅有部署环境或他人负责的应用)时,依据用户提供的测试步骤编写新的 Playwright E2E 测试。若有源码,应改用 pw-new-test。
主要能力:通过 Playwright CLI 打开并探索实时应用,维护会话页面状态,返回带元素引用(如 e7、e15)的 YAML 快照;对元素执行 click、fill、select、check、goto 等操作;用 generate-locator 生成 Playwright 定位器(如 getByRole('button', { name: 'Submit' })),并按 getByRole > getByLabel > getByText > getByPlaceholder > getByTestId > CSS 的优先级校验。
用法要点:先检查 npx playwright-cli --version,缺失时请用户自行安装 npm install --save-dev @playwright/cli@latest。阅读 tests/ 下现有 spec 和 playwright.config.ts 的 baseURL;用 npx playwright-cli open <baseURL> 开会话,逐步执行流程并收集定位器,最后 npx playwright-cli close。测试放在正确的文件和 test.describe 块,每个测试从首页 / 开始、只验证一个逻辑流程。运行:npx playwright test -g "<exact test title>" --trace on --retries 0。失败时用 npx playwright trace open/actions/action/snapshot/requests/errors/close 分析(须用 CLI,不用 GUI show-trace)。最终精简注释、可选提交。
限制:不修改应用源码,无法添加 data-testid;若只能使用脆弱定位器需明确告知用户。不使用自定义超时,除非调试需要。必须保留 AskUserQuestion 步骤,即使被要求自主执行。