القائمة
资深测试用例设计专家技能。当用户需要基于用户故事或测试点生成完整的、可执行的测试用例时使用此技能。支持输入 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