用途:以“验证→诊断→修正→重新验证”的循环修复网页行为问题,适合 UI bug 修复与 E2E 行为对齐。与操作型的 playwright-human-in-the-loop、证据型的 verify-evidence-loop、规划型的 /design 区分使用。
主要能力:每轮 Phase A 用 browser_navigate、browser_wait_for、browser_snapshot、browser_console_messages、browser_network_requests、browser_evaluate 采集证据,并按 PASS 条件 DSL 逐项机械判定(url、element、not-element、text、console、network、eval 七类);Phase B 从失败证据萃取根因并列出疑似文件;Phase C 仅在 allowed_paths 内做最小变更;Phase D 处理 HMR/build/SSR 重载。
使用方式:Step 0 确认 Playwright MCP 以 headed 启动,否则在 ~/.claude.json 或项目 .mcp.json 加入 {"mcpServers":{"playwright":{"command":"npx","args":["-y","@playwright/mcp@latest","--headed"]}}} 并重启 Claude Code;MCP 不可用时停止流程,不用 Bash 替代。Step 0b 用 AskUserQuestion 收集目标 URL、PASS 条件、可修改文件范围、dev server 状态,缺一不可。Step 0c 默认不自动启动 dev server。Step 0d 自动建立 .claude/verify-fix-loop/<timestamp>-<slug>.md 追加每轮记录。
限制:hard cap 5 轮,第 3 轮起每轮 HITL,可选继续、停止回报、换策略或转交 /design;达到上限即使选择继续也强制停止。禁止修改测试或 PASS 条件、吞掉 catch 错误、跨范围改架构、写死值绕过。