SuperAPI AI 工具集

agent-e2e

智能体与模型

查看项目

更新于 10-15 23:59

技能介绍

用途:发现 E2E 测试场景、将场景记录为 YAML、执行已有测试用例。核心原则是使用基于无障碍属性的语义选择器(如 role、name),替代易碎的 dataTestId、CSS 类,使测试更贴近用户所见。

主要能力与流程:一、以风险驱动方式发现场景,优先关注多字段表单、多步流程、认证边界、外部集成和数据变更等高危区域,并从代码、文档、浏览器多来源验证,凭把握停止而非穷尽来源。二、录制用例采用快照引用模式:先用 agent-browser open 打开页面、snapshot --json 发现元素,再用 @ref 交互,DOM 变化后必须重新快照,因为 ref 会重新分配;YAML 中保存语义选择器而非 ref。三、组织用例按复杂度梯度分为 foundations(原子操作)、flows(用户旅程)、compositions(多会话/多用户场景),以便快速定位根因。判断类别时看能否拆分为更小独立测试:能则为 flow 或 composition,不能则为 foundation。四、执行时 YAML 描述意图与约束,由代理补充执行细节:每步快照、匹配选择器、执行、验证 expect;可选步骤找不到元素则跳过并记录决策;失败时报告哪个选择器未匹配及实际发现;结束时关闭浏览器。

用法要点:YAML 最小结构含 id、title、category、description、parameters、steps(commands、expect、optional)、exploration(status 为 draft/explored/validated)。支持条件步骤(optional: true)、数据提取(extract 指定 from、pattern、save_as)、多会话(sessions 指定生命周期,steps 指定 session)。选择器可带 index 处理多重匹配。常用命令包括 agent-browser open、snapshot、fill、click、wait。

限制与注意事项:快照为空可能是页面未加载或缺少无障碍信息;ref 变化属预期,交互前须重新快照;静态路由可能需加 .html;公共站点可能触发 429 限流,可加延迟(agent-browser wait 2000)、使用认证会话或在本地开发实例录制。完整规范见 FORMATS.md。其他细节暂未提供。