skills

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 脚本要分类'，也应使用此技能。

接口自动化测试失败用例智能诊断与自动修复专家。分析 api-test-executor 输出的执行结果，自动分类失败类型（环境问题/数据问题/脚本问题/产品缺陷），定位脚本层根因并生成修复补丁。当用户提到测试失败、用例报错、断言失败、接口变更导致脚本失败、需要修复测试脚本、分析失败原因、运行修复、修复用例、诊断测试结果时触发。也适用于用户提供了 execution_results.json 或失败日志需要排查的场景。上游承接 api-test-executor 执行结果，下游输出修复后的可执行脚本。

接口自动化全链路流水线调度器。作为统一入口编排 api-test-executor（执行测试）、api-testdata-cleaner（清理数据）、api-report-generator（生成报告）三个技能的串行执行，实现一键完成「测试→清理→报告」全流程。支持 full_flow/only_exec/only_clean/only_report 四种执行模式，单环节失败可配置是否继续。当用户提到跑完自动生成报告、全流程执行、一键测试并出报告、流水线、pipeline时触发。

接口自动化测试智能报告生成专家。将执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告，集成Allure报告跳转入口实现双报告联动。支持手动调用和上下游技能联动调用（api-test-executor、api-failure-diagnoser、api-testdata-cleaner）。当用户提到生成测试报告、生成报告、测试报告、HTML报告、报告汇总、测试总结、查看报告、report时触发。

接口自动化测试智能执行调度引擎。当用户需要触发执行 pytest 接口测试、按范围/模块/标签筛选测试用例、用自然语言描述执行意图、收集结构化测试结果时使用此技能。支持三种筛选模式（标签索引/文件路径/自然语言），输出标准化 JSON 和 Markdown 执行报告。典型触发：跑一下冒烟测试、执行登录模块的P0用例、在test环境跑回归、模拟执行看看有哪些用例。

接口自动化测试脚本智能标签化管理专家。当用户需要为API测试脚本批量打标签、检测标签冲突、补全缺失标签、生成标签统计报告时使用此技能。适用于已有pytest测试脚本但缺乏标准化标签体系的场景，支持优先级(P0-P3)、模块(module:xxx)、场景(scene:xxx)、执行策略(run:xxx)、环境(env:xxx)五维标签体系，自动基于脚本语义和接口定义推荐标签，检测冲突并生成统计报告。

接口自动化测试数据清理工具。自动清理测试执行后产生的临时数据、重复数据、脏数据，覆盖数据库、Redis缓存、本地临时文件三层清理。支持手动独立调用、上下游技能联动调用（api-test-executor、api-failure-diagnoser）、CI定时调用三种模式。生产环境强制拦截。当用户提到清理测试数据、清除脏数据、数据重置、清理缓存、重置测试环境、测试数据清理时触发。

"对已生成的 Playwright + POM + Pytest UI 测试脚本做自动化增强，补充智能等待、验证码识别、弹窗处理、iframe 切换、异常重试、失败截图录屏等能力，提升脚本运行稳定性。当用户需要以下场景时触发：增强测试脚本、脚本健壮性优化、添加智能等待、处理验证码、处理弹窗、iframe 处理、异常重试、失败截图、测试稳定性提升、脚本加固。即使用户只是说"脚本跑不稳定"、"经常失败"、"flaky test"，也应使用此技能。"

"基于 pages.yaml 页面定义和业务测试用例，生成 Playwright + POM + Pytest 的 UI 自动化测试脚本。当用户需要以下场景时触发：生成测试脚本、创建 POM 页面对象、编写 UI 自动化测试、搭建测试项目骨架、将测试用例转化为 Playwright 代码。也适用于用户提到：测试脚本生成、POM 生成、UI 自动化、Playwright 测试、pytest 测试生成、元素定位器、测试数据工厂，或用户提供了 pages.yaml 文件和业务测试用例文档（Excel/Word/TXT）希望转化为可执行测试代码。即使用户没有明确说"生成测试脚本"，只要提供了业务测试用例并希望得到自动化测试代码，就应使用此技能。"

对已增强的 Playwright + POM + Pytest UI 测试脚本添加视觉回归、跨浏览器兼容性、响应式布局测试能力。使用 pixelmatch + Pillow 实现像素级截图比对（Python 原生方案），支持动态区域遮罩、元素级截图断言、多视口自适应、Chromium/Firefox/WebKit 三引擎差异容忍。当用户需要以下场景时触发：视觉回归测试、截图比对、UI 外观验证、跨浏览器测试、多浏览器兼容性、响应式测试、多视口测试、移动端适配测试、视觉快照、像素对比、baseline 更新、视觉差异检测、页面变形检测。即使用户只是说'页面改版了看看有没有变形'、'不同浏览器下样式一致吗'、'手机端布局对不对'，也应使用此技能。

接口定义解析器技能。专门负责处理并解析来自不同来源、不同格式的接口定义数据（Swagger/OpenAPI、Postman集合、HAR抓包、YApi/Apifox导出文档、纯文本描述），统一转换成结构一致、格式标准、可被后续环节直接复用的结构化接口数据。自动识别输入源类型，提取接口核心信息、解析参数与响应、识别隐性业务规则，输出标准化 api_definitions.yaml/json。

接口自动化脚本质量检查与优化增强技能。对AI生成的原始接口自动化脚本做自动化检查、问题诊断、规范对齐、缺陷修复与代码优化、场景补齐，确保脚本语法合法、规范统一、逻辑完整、场景全覆盖。支持4类校验（语法/规范/健壮性/逻辑）+10维度场景补齐（正向/必填校验/参数合法性/边界值/异常处理/业务规则/安全风险/接口依赖/兼容性/断言完整性），输出脚本校验报告+优化后可执行脚本。

测试数据自动化构造技能。支持三种输入模式：传统模式（基于 api_definitions.json 接口定义）、规范模式（基于团队自定义字段规则）、自然语言模式（基于自然语言描述，Faker 驱动）。自动生成覆盖正向、边界、异常、安全四大维度的测试数据，支持 YAML/JSON/Excel/CSV 格式输出。

接口自动化测试脚本批量生成技能。基于标准化接口定义（api_definitions.json）与可选的全场景测试数据文件，按照团队既定工程规范（Python + Requests + Pytest + Allure2），自动生成分层架构的接口自动化测试脚本。支持数据驱动模式（脚本与数据解耦）和内联数据模式，输出可直接运行的接口自动化脚本工程。

资深测试用例设计专家技能。当用户需要基于用户故事或测试点生成完整的、可执行的测试用例时使用此技能。支持输入 docx 文档（用户故事）或 xmind 文件（测试点），输出格式化的 Excel 测试用例文件。每个用例包含编号、标题、前置条件、测试步骤、测试数据、预期结果、优先级、关联需求编号。

资深测试工程师技能。当用户提供用户故事（User Story）文本或文档，需要拆解测试点、生成测试用例、进行测试设计与评审时，使用此技能。输出为 XMind 思维导图格式的完整测试点清单，覆盖功能、边界值、异常、业务规则、非功能性五大维度，并按 P0/P1/P2 标注优先级。

AI测试用例质量评审专家技能。对AI生成的测试用例进行分类分级（可用/待修改/错误无效）、5维评审打分（逻辑完整性25分+预期结果明确性20分+前置条件完备性15分+PRD覆盖度25分+边界异常覆盖15分）、7项量化指标统计（需求覆盖率/反向用例占比/边界用例数量/重复用例率/错误用例率/高危场景覆盖率/历史缺陷覆盖率），输出逐条评分+扣分原因+改进建议，保持同原文件后缀格式新增输出。支持Excel和XMind格式输入。

资深测试专家技能，擅长挖掘人工最容易遗漏的测试场景。当用户提供已有测试用例文件或测试用例列表，要求补全遗漏场景、检查场景覆盖、补全高频BUG用例、补齐非功能用例时使用此技能。精通等价类、边界值、状态迁移、非功能、安全、兼容性、历史BUG复盘、业务隐藏规则分析。支持Excel/XMind/文本格式输入，补全标识放在独立位置（Excel独立列、XMind label、文本行末标记），输出完整用例列表。

将口语化、非结构化的原始业务需求自动拆解为标准化的结构化用户故事（User Story），用于需求分析与评审。 当用户输入原始业务需求、描述产品功能、提出需求想法、让你拆解用户故事、整理需求用例、分析需求时，自动启用本技能。 也适用于：用户粘贴了一段需求描述让你"整理一下"、"拆分一下"、"写用例"、"分析需求"、"梳理需求"等场景。 手动输入 /req-to-user-story 也可调用。

对已有的用户故事进行系统性审查，检查是否存在遗漏的场景和维度。 重点检查四个方面：边界条件（如数量上限、金额上限）、异常场景（如并发冲突、数据不一致）、业务规则（如库存扣减时机、价格变动处理）、非功能性需求（如性能、安全性）。 当用户提供用户故事列表并要求检查遗漏、审查完整性、补充场景时，自动启用本技能。 也适用于：用户说"检查一下这些用户故事"、"看看有没有遗漏"、"审查需求"、"补充边界场景"、"检查边界条件"等场景。 手动输入 /review-user-stories 也可调用。