用途:验证 WorldMonitor 的浏览器仪表盘行为。该产品的主界面是 Vite/TypeScript 单页应用,位于 /dashboard,包含地图、面板网格、设置浮层和命令面板。本技能会启动一个隔离实例,按用户操作路径驱动某个功能,并留下证据。它只验证浏览器行为;后端、桌面端、worker 或文档变更应使用代码与检查清单。所有命令需在被测 worktree 的仓库根目录运行。
主要能力与用法:选择证明目标,命名用户操作与预期结果,加载对应的功能配方。若已有严格测试覆盖结果,先运行它,例如 Country Brief 使用 npm run test:e2e:country-brief,该测试由 Playwright 管理服务器,不要再运行 launch。对于测试未覆盖的交互,使用手动步骤;需要长期回归检查时扩展已有测试。
启动:每次运行一个长期存活的开发服务器,每个 drive 使用全新浏览器上下文。脚本 .agents/skills/verify-worldmonitor/scripts/wm-verify.sh launch 会在 4480-4487 中选第一个空闲端口,启动 VITE_E2E=1 VITE_VARIANT=full npm run dev,等待 /tests/map-harness.html 返回 200,并写入 .claude/verify-evidence/instance.json。VITE_E2E=1 为必需,它负责标记就绪属性。可用 WM_VERIFY_VARIANT=tech|finance|commodity|energy|happy 选择变体,launch <port> 强制端口。
检查与驱动:doctor 为只读检查,确认实例是否值得驱动。drive <step.mjs> --name <label> 执行步骤文件,步骤默认导出异步函数,获得 page、context、base、shot、log、expectVisible 等工具。已有步骤覆盖仪表盘启动、面板设置、国家简报、全局搜索、地图图层。环境开关包括 WM_VERIFY_HEADED=1(真实窗口与 GPU,获得 deck.gl 地图的唯一方式)等。
证据与清理:每次 drive 输出到 .claude/verify-evidence/<timestamp>-<label>/,含编号截图、transcript.txt、控制台错误/警告、失败请求和 result.json。清理运行 cleanup,仅终止 launch 启动的进程,不要使用 pkill vite。
限制:一次 worktree 仅支持一个实例;不要接管非本次启动的开发服务器。成功驱动只能证明其断言成立,录制到的错误本身不会使 drive 失败。缺失信息暂未提供。