| name | ui-scenario-automation |
| description | 根据需求文档、UI 文档、截图、前端文档、已有测试用例(如 cases.json)或可访问的本地页面生成并执行浏览器 UI 场景验证。适用于驱动 Codex 内置浏览器进行点击、输入、导航、检查页面状态、截图取证、验证用户流程、生成 UI 检查报告、创建 ui-scenarios.json;也可在用户明确要求时导出 Playwright 测试。 |
UI 场景自动化
使用本 skill 将产品资料或已有测试用例转换成可执行的 UI 场景,并通过 Codex 内置浏览器执行。默认使用 Codex 浏览器完成交互验证;除非用户明确要求可复用脚本、CI 测试或 Playwright 导出,否则不要强制要求安装 Playwright。
工作流程
- 收集输入:
- 目标 URL 或本地应用启动命令。
- 可选的
cases.json,例如由 test-case-xmind 生成的测试用例。
- 需求文档、UI 稿、截图、前端文档、路由说明,或用户提供的流程描述。
- 测试账号、预置数据、权限信息,以及需要用户确认的操作。
- 如果存在
cases.json,优先从中选择 UI 场景;否则从文档和当前页面推断场景。
- 编写
ui-scenarios.json 前,阅读 references/ui_scenario_schema.md。
- 执行场景前,阅读
references/browser_execution.md。
- 选择断言和通过/失败标准时,阅读
references/assertion_rules.md。
- 生成
ui-scenarios.json。默认生成 3-8 条有价值的用户流程,除非用户要求更窄范围。
- 目标应用可访问时,使用 Codex 内置浏览器执行场景。
- 为关键状态、失败点和最终结果截图取证。
- 输出简洁报告,包含通过项、失败项、截图、缺陷和阻塞项。
- 只有在用户明确要求时,才阅读
references/playwright_export_optional.md 并导出 Playwright 测试。
场景选择规则
- 优先选择用户可见的业务路径,而不是孤立点击检查。
- 至少包含一条正向路径,并覆盖重要的反向或校验路径。
- 未经用户明确确认,不要自动执行破坏性操作或会产生外部副作用的操作。
- 未经用户明确提供,不要输入敏感数据。
- 保持检查确定性。避免真实支付、真实邮件、真实生产数据变更或不可逆操作。
- 如果某条用例更适合接口层验证,应交给
api-scenario-automation,不要强行通过 UI 执行。
与其他 skill 的关系
当用户希望从产品资料生成测试用例时,可以先使用 test-case-xmind,再消费其输出的 cases.json 作为 UI 场景来源。
后端状态流转、数据组合、权限矩阵或 UI 执行收益较低的流程,更适合交给 api-scenario-automation。
本 skill 关注用户可见路径:页面导航、输入、可见状态、校验文案、禁用/启用状态、弹窗、最终页面证据。
输出结构
默认输出目录:
ui-check-report/
├── report.md
├── ui-scenarios.json
└── screenshots/
├── 01-home.png
└── 02-result.png
ui-scenarios.json 是场景源文件;report.md 是执行证据,不是场景定义。
浏览器要求
优先使用 Codex 内置浏览器。若当前环境无法使用浏览器执行,应说明交互式浏览器执行受阻,并仍然交付 ui-scenarios.json,同时给出手动执行或导出 Playwright 的后续方案。