用途：在一个新仓库中以最小且持久的配置，搭建基于浏览器的 UI 工作环境，覆盖交互式调试、认证流程、截图取证与快速冒烟检查。
主要能力与工具分工：playwright-interactive 作为主工具，负责迭代式 UI/UX 工作、认证流程、布局调试、截图与深入排查；agent-browser 作为次要 CLI 工具，负责快速冒烟检查、带注释截图、快速快照与轻量自动化。技能明确要求不要自建框架、包装包或共享浏览器辅助层，除非用户明确要求。
前置条件：确认 playwright-interactive 已安装并可在 Codex 中使用；确认 agent-browser CLI 已安装；确认 Codex 具备 js_repl = true；确认会话在使用 playwright-interactive 时能以 danger-full-access 运行。缺失时先修复再动仓库。
使用方式：先检查仓库，读取 package.json、锁文件与 AGENTS.md，按仓库实际使用包管理器，复用已有测试与物料约定。安装 Playwright 时仓库为 Bun 优先执行 bun add -d playwright 与 bunx playwright install chromium，pnpm/npm/yarn 按仓库标准执行，默认只装 Chromium。创建最小物料约定，默认目录为 output/playwright/screenshots/、output/playwright/traces/、output/playwright/auth/ 与 output/agent-browser/，并添加忽略规则如 output/playwright/、output/agent-browser/、playwright/.auth/。认证状态优先使用 Playwright storageState，agent-browser 的 profile 或会话名仅用于本地快速检查，认证文件不入 git。参考文件按需读取：主流程参考 references/playwright-interactive.md，CLI 与会话持久化参考 references/agent-browser.md，认证按提供方只读一个文件（auth-clerk.md、auth-supabase.md、auth-auth0.md、auth-neon.md），不默认加载全部提供方文件。
适用场景：新仓库的浏览器 UI 工作配置、认证流程搭建、截图与追踪取证、桌面与移动端检查。
限制：不为形式化测试添加 Playwright 测试脚手架，除非用户要求；默认不加辅助脚本、自定义 CLI、包装包或 CI 配置；用户级工具配置如 ~/.agent-browser/config.json 应放在仓库之外；避免在自动化浏览器运行中使用 MFA，除非提供方测试辅助明确支持。完成后需报告使用的包管理器、新增依赖、目录、忽略规则、仓库外所需用户级配置、所选认证路径及应首先运行的 playwright-interactive 命令。结构化交接使用 ui_audit.v1，target.framework 设为 browser-workbench。