메뉴
资深测试用例设计专家技能。当用户需要基于用户故事或测试点生成完整的、可执行的测试用例时使用此技能。支持输入 docx 文档（用户故事）或 xmind 文件（测试点），输出格式化的 Excel 测试用例文件。每个用例包含编号、标题、前置条件、测试步骤、测试数据、预期结果、优先级、关联需求编号。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
WEB UI 自动化测试（Playwright + Pytest + POM）失败用例智能诊断与全栈自动修复专家。分析 ui-test-executor 输出的执行结果（JUnit XML + sidecar JSON + page-source HTML + console-logs + trace.zip），对失败用例做 6 类分类（ENV/LOCATOR/TIMEOUT/DATA/SCRIPT/BUG）+ 14 种根因定位，自动修复 pages 层 locator 问题、注入 conftest marker、清理测试脏数据、调起 playwright install，并通过 pages.yaml 对比修复定位漂移。**核心约束：永不修改 tests/**/*.py 断言与语义**。
UI自动化测试数据预处理技能。负责将页面URL或自然语言用例描述转换为标准化pages.yaml页面对象定义。支持全站自动爬取（单入口URL发现全站页面）、Playwright动态抓取、CDP连接模式、推断兜底模式。是ui-testcase-generator、ui-testscript-generator等后续技能的标准输入来源。当用户提供页面URL或自然语言描述的测试用例需要生成结构化页面定义文件时触发。
WEB UI 自动化测试全链路统一编排入口。负责把 ui-test-executor（执行）→ ui-failure-diagnoser（诊断修复）→ ui-test-executor（重试）→ ui-report-generator（报告）四个阶段自动串联成闭环，含失败诊断+智能重试+熔断兜底。当用户需要"一键全跑 UI 自动化"、"自动修复失败用例并重试"、"端到端 UI 测试流水线"、"全流程闭环"、"UI 自动化 pipeline"时触发本技能。本技能不替代任何子技能，仅做流程编排与参数透传，三个子技能仍可独立调用。
WEB UI 自动化测试（Playwright + Pytest + POM）测试报告生成专家。将 ui-test-executor 的 JUnit XML + artifacts、ui-failure-diagnoser 的诊断报告、以及历史趋势数据融合为单文件 HTML 可视化报告，含状态分布图、模块通过率、浏览器矩阵、风险分级、失败详情（含内联截图/录屏/Trace 打开按钮）、根因聚类与优化建议。**核心约束：只读测试结果与诊断输出，永不修改 tests/** 与 pages/**。
WEB UI 自动化测试的智能执行调度引擎。负责触发执行 Playwright + Pytest UI 测试，按标签/模块/优先级智能调度，自动检测本地浏览器环境，全程监控执行状态，自动采集截图/录屏/Trace/网络日志，输出标准化报告。当用户需要"跑一下 UI 测试"、"执行 P0 用例"、"跑登录模块测试"、"跨浏览器跑 UI 测试"、"按标签筛选执行"、"用 CI 跑 UI 测试"、"浏览器跑不了"、"需要选浏览器"、"测试失败要截图和 Trace"、"生成测试报告"等场景时应使用本技能。不要使用本技能处理接口测试（用 api-test-executor）或测试脚本编写（用 ui-testscript-generator）。
WEB UI 自动化测试脚本（Playwright + POM + Pytest）的智能标签化管理专家。当用户需要为 UI 测试脚本批量打标签、检测标签冲突、补全缺失标签、生成标签统计报告时使用此技能。支持六维标签体系：优先级(P0-P3)、模块(module:xxx)、场景(scene:xxx)、页面类型(page:xxx)、执行策略(run:xxx)、浏览器/平台(browser:xxx, platform:xxx)。自动解析测试方法名、docstring、page.goto() 路径、Playwright 操作步骤、断言内容，并参照 pages.yaml 推断模块和优先级。即使用户只是说'给 UI 用例打标签'、'按模块跑用例'、'筛选冒烟用例'、'这些 Playwright 脚本要分类'，也应使用此技能。
| name | generator-testcase-excel |
| description | 资深测试用例设计专家技能。当用户需要基于用户故事或测试点生成完整的、可执行的测试用例时使用此技能。支持输入 docx 文档（用户故事）或 xmind 文件（测试点），输出格式化的 Excel 测试用例文件。每个用例包含编号、标题、前置条件、测试步骤、测试数据、预期结果、优先级、关联需求编号。 |
本技能以资深测试用例设计专家的视角，基于用户故事或测试点，生成完整的、可执行的测试用例，并以 Excel (.xlsx) 格式输出。每个测试用例包含8个标准字段，测试数据具体可执行，预期结果明确可验证。
当用户出现以下场景时使用本技能：
支持两种输入方式，根据输入类型选择对应解析流程：
content.jsontitle → 测试点描述markers → 优先级（priority-1=P0, priority-2=P1, priority-3=P2）labels → 关联需求编号notes → 详细说明children → 子测试点列表按照以下规则将用户故事/测试点转化为完整测试用例。参照 references/testcase_design_guide.md 中的详细规范。
对涉及输入的测试点，必须应用等价类划分和边界值分析：
等价类规则：
边界值规则（必须包含5类）：
测试数据要求：
13812345678，密码填写 Abc12345每个测试用例必须包含以下8个字段：
| 字段 | 要求 |
|---|---|
| 用例编号 | 全局连续编号 TC-001, TC-002, ... |
| 用例标题 | 格式：功能点-操作-预期结果/异常描述，简洁明确 |
| 前置条件 | 执行前需满足的条件，包括账号状态、数据准备等 |
| 测试步骤 | 按 1. 2. 3. 编号，每步包含操作对象、操作方式、输入内容 |
| 测试数据 | 具体的输入数据值，不使用模糊描述 |
| 预期结果 | 包含页面行为验证、提示信息验证、数据状态验证 |
| 优先级 | P0/P1/P2 |
| 关联需求 | 对应的用户故事编号（如 US-001） |
测试步骤编写规则：
预期结果编写规则：
根据用户故事的复杂度拆分测试用例：
根据测试点分类选择转化策略：
| 测试点分类 | 转化策略 |
|---|---|
| 功能测试 | 每个测试点 → 1条正向用例，步骤和数据完整展开 |
| 边界值测试 | 每个子测试点 → 1条独立用例，包含具体边界值和预期 |
| 异常测试 | 每个异常场景 → 1条用例，必须验证提示信息内容和页面状态 |
| 业务规则测试 | 每条规则 → 1-2条用例（正向+反向） |
| 非功能性测试 | 按安全/性能/兼容性拆分，每项1条用例 |
将所有测试用例整理为结构化 JSON 数据，格式遵循 references/json_template.md 规范：
{
"title": "项目名称 - 测试用例",
"test_cases": [
{
"id": "TC-001",
"title": "用例标题",
"precondition": "前置条件",
"steps": "1. 步骤一\n2. 步骤二",
"test_data": "具体数据",
"expected_result": "1. 预期一\n2. 预期二",
"priority": "P0",
"requirement_id": "US-001"
}
]
}
执行 scripts/generate_excel.py 脚本生成格式化的 Excel 文件：
python3 <skill_path>/scripts/generate_excel.py <input.json> <output.xlsx>
Excel 文件包含两个 Sheet：
将生成的 Excel 文件交付给用户。
1. 2. 3. 格式，换行用 \n