用途：以智能体身份驱动一次真实的 PostHog wizard 运行——在应用上启动向导，逐屏阅读、决策、行动并留档。通过仓库内已绑定（注册在 .mcp.json）的 wizard-ci MCP 工具完成；底层原理见 e2e-harness/ARCHITECTURE.md。
准备：若看不到 wizard-ci 工具（open_app、read_state 等），说明服务器尚未获批，先请用户批准 wizard-ci 再重试。向用户索取 PostHog 密钥文件的绝对路径（如“你的 phx key 文件路径是什么？”），以及 project id 与 region（若尚不清楚）。把目标应用克隆或复制到 /tmp 的一次性副本（绝不用真实 fixture）。绝不打印或提交密钥。
驱动：open_app({ appDir, keyFile, projectId, region }) 在应用上启动实时向导并返回首个屏幕，appDir 为一次性副本。每次动作后调用 read_state，读取当前屏幕、运行阶段、不含密钥的会话、任务以及当前合法动作。perform_action({ action, params? }) 提交决策，动作包括 confirm_setup、dismiss_outage、choose（设置问题，如 { key, value }）、set_mcp_outcome、dismiss_slack、keep_skills。render_screen 将当前 TUI 渲染为 ANSI 以便查看。run_agent 在后台启动真实集成并立即返回，它会引导凭证，因而推进 auth 与 run；随后轮询 read_state，runPhase 由 running → completed，屏幕进入 outro。典型流程：open_app → intro → perform_action confirm_setup；read_state → health-check → perform_action dismiss_outage；read_state → auth → run_agent；read_state（轮询）→ runPhase running → completed，屏幕 → outro；outro → perform_action dismiss_outro → … → keep_skills。
快照：在每个关键节点用 render_screen 渲染，并按访问顺序将每帧保存为编号文件 /tmp/wz-explore-snaps/NN-<screen>.txt，NN 递增，形成可读的有序记录。需在运行屏幕推进过程中持续捕获，而不只在屏幕变化时。
关键事实：状态决定屏幕——你从不导航，只提交决策（动作），由路由器重新推导当前屏幕；使用动作名而非按键。auth 与 run 只能通过 run_agent 推进，它们不暴露动作也不会自行推进；run_agent 立即返回并在后台运行集成，轮询 read_state 获取 runPhase。其余均为即时提交。run_agent 会在项目中创建真实 PostHog 资源（一个仪表板与若干 insight），每次运行都会重复创建。绿色运行不等于有效集成：runPhase=completed 仅表示流程结束，不代表向导正确理解了框架（例如会把 Wasp 应用当作 react-router）。以上内容均不随产品发布，试验框架位于 e2e-harness/，不在 src/ 内。