UI Scenario Automation

根据需求文档、UI 文档、截图、前端文档、已有测试用例(如 cases.json)或可访问的本地页面生成并执行浏览器 UI 场景验证。适用于驱动 Codex 内置浏览器进行点击、输入、导航、检查页面状态、截图取证、验证用户流程、生成 UI 检查报告、创建 ui-scenarios.json;也可在用户明确要求时导出 Playwright 测试。

43 stars 4 forksFrontend & Design

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add xiaoce-xiaoce/testing-skills-xiaoce --skill ui-scenario-automation
Manual install
git clone --depth 1 https://github.com/xiaoce-xiaoce/testing-skills-xiaoce.git /tmp/testing-skills-xiaoce
mkdir -p ~/.claude/skills
cp -r /tmp/testing-skills-xiaoce/ui-scenario-automation ~/.claude/skills/ui-scenario-automation

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# UI 场景自动化

使用本 skill 将产品资料或已有测试用例转换成可执行的 UI 场景,并通过 Codex 内置浏览器执行。默认使用 Codex 浏览器完成交互验证;除非用户明确要求可复用脚本、CI 测试或 Playwright 导出,否则不要强制要求安装 Playwright。

## 工作流程

1. 收集输入:
   - 目标 URL 或本地应用启动命令。
   - 可选的 `cases.json`,例如由 `test-case-xmind` 生成的测试用例。
   - 需求文档、UI 稿、截图、前端文档、路由说明,或用户提供的流程描述。
   - 测试账号、预置数据、权限信息,以及需要用户确认的操作。
2. 如果存在 `cases.json`,优先从中选择 UI 场景;否则从文档和当前页面推断场景。
3. 编写 `ui-scenarios.json` 前,阅读 `references/ui_scenario_schema.md`。
4. 执行场景前,阅读 `references/browser_execution.md`。
5. 选择断言和通过/失败标准时,阅读 `references/assertion_rules.md`。
6. 生成 `ui-scenarios.json`。默认生成 3-8 条有价值的用户流程,除非用户要求更窄范围。
7. 目标应用可访问时,使用 Codex 内置浏览器执行场景。
8. 为关键状态、失败点和最终结果截图取证。
9. 输出简洁报告,包含通过项、失败项、截图、缺陷和阻塞项。
10. 只有在用户明确要求时,才阅读 `references/playwright_export_optional.md` 并导出 Playwright 测试。

## 场景选择规则

- 优先选择用户可见的业务路径,而不是孤立点击检查。
- 至少包含一条正向路径,并覆盖重要的反向或校验路径。
- 未经用户明确确认,不要自动执行破坏性操作或会产生外部副作用的操作。
- 未经用户明确提供,不要输入敏感数据。
- 保持检查确定性。避免真实支付、真实邮件、真实生产数据变更或不可逆操作。
- 如果某条用例更适合接口层验证,应交给 `api-scenario-automation`,不要强行通过 UI 执行。

## 与其他 skill 的关系

当用户希望从产品资料生成测试用例时,可以先使用 `test-case-xmind`,再消费其输出的 `cases.json` 作为 UI 场景来源。

后端状态流转、数据组合、权限矩阵或 UI 执行收益较低的流程,更适合交给 `api-scenario-automation`。

本 skill 关注用户可见路径:页面导航、输入、可见状态、校验文案、禁用/启用状态、弹窗、最终页面证据。

## 输出结构

默认输出目录:

```text
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 的后续方案。
Read the full skill on GitHub

Details

Skill name
ui-scenario-automation
Path
ui-scenario-automation/SKILL.md
Repo updated
14 June 2026

FAQ

What does the UI Scenario Automation skill do?

根据需求文档、UI 文档、截图、前端文档、已有测试用例(如 cases.json)或可访问的本地页面生成并执行浏览器 UI 场景验证。适用于驱动 Codex 内置浏览器进行点击、输入、导航、检查页面状态、截图取证、验证用户流程、生成 UI 检查报告、创建 ui-scenarios.json;也可在用户明确要求时导出 Playwright 测试。

How do I install the UI Scenario Automation skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add xiaoce-xiaoce/testing-skills-xiaoce --skill ui-scenario-automation. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is UI Scenario Automation popular?

It lives in xiaoce-xiaoce/testing-skills-xiaoce, which has 43 GitHub stars and 4 forks.

Related skills

API Scenario Automation

43

xiaoce-xiaoce/testing-skills-xiaoce

根据需求文档、测试用例、OpenAPI、Postman、Apipost、Swagger、Markdown 接口文档、后端文档或后端路由生成场景化接口自动化。适用于生成接口流程编排、scenarios.yaml/scenarios.json 场景文件、unittest/pytest 兼容的接口自动化测试,以及带数据依赖的端到端接口测试;不用于生成单元测试。

Productivity & Notes

Test Case Xmind

43

xiaoce-xiaoce/testing-skills-xiaoce

根据产品需求文档、前端技术文档、后端技术文档、交互稿、接口说明、截图和相关项目资料生成结构化软件测试用例;校验用例格式;按“用例标题/前置条件/步骤/预期结果”模板导出 .xmind 脑图文件。适用于生成 QA 测试用例、验收用例、功能用例、回归用例、边界用例,或根据一个或多个输入文档生成 XMind 测试用例脑图。

Testing & QA

UI UX Gtm

79

LeadMagic/gtm-skills

Design GTM UI/UX patterns — landing pages (hero, proof, CTA), forms (progressive disclosure, inline validation), signup flows (activation, time-to-value), dashboards (KPI hierarchy, trend indicators), and accessibility (WCAG 2.2 AA). Use when designing or auditing GTM tool interfaces, landing pages, conversion flows, or onboarding experiences. Covers conversion-first design, mobile optimization, and A/B test readiness.

Frontend & DesignIn 1 list18

Remember Design System

51

memi-design/memi

Use when an agent is about to build or refactor interface code and needs a compact, repository-specific brief covering existing tokens, components, routes, conventions, and verification commands.

Frontend & DesignIn 1 list

Appsnap

65

Yrzhe/claude-skills

Capture a Mac app window as agent context. Use when the user asks to snap, inspect, read, capture, summarize, or work from the current Mac window, a visible app, a selected window, or an app screenshot. Strongly prefer for Appshot-like requests, "what is on this window", "use this app as context", and "grab the window text". SKIP for remote websites/files that can be fetched directly, for controlling the UI, clicking, typing, automating actions, or extracting hidden Google Docs/Sheets/Slides/Gmail canvas text beyond what macOS Accessibility exposes.

Frontend & Design

Memoire Design Tooling

51

memi-design/memi

Use when an OpenCode task involves UI design, interface craft, Figma, design systems, shadcn/ui, Tailwind, Atomic Design, research synthesis, component specs, design audits, or design-to-code generation.

Frontend & DesignIn 1 list

Browse the most popular Claude skills, all frontend & design skills, or write your own with the skills generator.