frontend-explorer

frontend-explorer — 探索型前端测试

脚本化测试回答「我已经想到的那件事还好使吗」。这里回答另一个问题：一个从没见过这个产品的人 打开它——在哪停住，在哪盯着屏幕不明白？ 这两种失败形态就是全部产出；其余一切只为让这份产出诚实。

本 skill 对你的项目一无所知：应用在哪跑、怎么拿登录态、屏幕上的词什么意思，全部来自一份配置 （references/config.example.yaml）。想改本 skill 的文件去适配项目 = 那个事实该进配置。

前置条件

1. 一份配置：复制 references/config.example.yaml 填好；含本机路径就别进版本库。做任何事之前先读它。
2. 应用在跑且可达：base_url 可访问、其 host 在 allowed_origins 里。没在跑就按配置 auth.setup 起， 不要自己发明启动方式。
3. 浏览器驱动 = playwright-cli（@playwright/cli，0.x 命令面会漂，项目钉版本）：探索者经 Bash 调它， 每个 persona 一个命名会话 -s=<persona.session>，与项目自己的会话及彼此隔离。-s= 只隔离浏览器，不隔离账号： 本版一份 session_file = 一个账号 = 两 persona 串行（第一轮打通的账号第二轮无路可走）；并行不在承诺面。不用 Playwright MCP、 不用别的驱动、不调外部 LLM API。工具选型与登录态原则与 cto-orchestration references/frontend-verify.md 同向（可选阅读，非依赖）。

流程（五步）

1 — 准备会话。 配置有 auth.setup.command 就跑它：它负责把应用带起来、签一个新用户、写出 auth.session_file（含入口 URL 与 storageState 路径），并停在前台。脚本里起它要让它独占一个进程组（setsid 起、记下 那个 pgid），结束时给该组发 INT（kill -INT -- -<pgid>）；只给 wrapper PID 发不起作用——bash 等前台子进程结束才跑 trap。

2 — 派发前先冒烟。 对每个 persona 的会话起浏览器、载入登录态、亲眼确认：

playwright-cli -s=<会话> open <entry_url>
playwright-cli -s=<会话> state-load <storageState 文件>
playwright-cli -s=<会话> goto <entry_url>
playwright-cli -s=<会话> find "<signed_in_marker.visible_text>"

看到标记文本才算登录态生效。没亲眼看到会话有效就派探索者 = 它报的每条 finding 都是「没登录」的伪影。 派第二个 persona 前再证一件事：它要走的失败 / 返工路径在这个栈上能触发（例：一次故意不合格的提交会被打回）—— fake 判定永不打回的栈，rework 步结构上探不到，steps_not_reached 那一行就是整轮的结论，别浪费一轮。 登录态只经文件路径进浏览器（state-load）。禁止 cookie-set / cookie-get / cookie-list / localstorage-* / sessionstorage-*，禁止在 eval 正文里碰 cookie / token / localStorage——值上了命令行 或 stdout 就进了 transcript——一次性 session token 正是这样泄漏的。state-save 只许落 gitignored 的输出目录。

3 — 派发探索者。 配置里每个 persona 派一个独立子代理，brief 按 references/dispatch.md 组装， 自包含——子代理看不到本对话。席位形态：宿主的带 Bash 的子代理（如 Claude Code 的 Agent 工具，通用类型）， 显式指定经济型模型（如 model: sonnet——这是耐心观察不是重推理，别让它默认继承你的高级模型）；cwd 设为输出目录、 或独立 worktree 兜只读。探索者只读：驱动浏览器、只往 output.dir 写文件；不读不改不跑项目代码，不离开 allowed_origins。