메뉴
接口自动化测试智能报告生成专家。将执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告，集成Allure报告跳转入口实现双报告联动。支持手动调用和上下游技能联动调用（api-test-executor、api-failure-diagnoser、api-testdata-cleaner）。当用户提到生成测试报告、生成报告、测试报告、HTML报告、报告汇总、测试总结、查看报告、report时触发。
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 | api-report-generator |
| description | 接口自动化测试智能报告生成专家。将执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告，集成Allure报告跳转入口实现双报告联动。支持手动调用和上下游技能联动调用（api-test-executor、api-failure-diagnoser、api-testdata-cleaner）。当用户提到生成测试报告、生成报告、测试报告、HTML报告、报告汇总、测试总结、查看报告、report时触发。 |
| agent_created | true |
将接口测试执行结果、诊断结论和历史数据转化为多维度、可视化、可驱动决策的专业HTML测试报告。集成Allure报告跳转入口，实现双报告联动。
核心能力：
明确不做： 测试执行、脚本修复、数据清理、环境部署。
当用户表述包含以下意图时触发：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| exec_data_path | string | 是 | 测试执行结果文件路径（如 execution_results.json） |
| allure_report_path | string | 否 | Allure报告目录路径，为空则自动检索 |
| report_save_path | string | 否 | HTML报告输出目录，默认 ./reports/custom_report |
| report_title | string | 否 | 报告标题，默认「接口自动化测试报告」 |
| show_chart | bool | 否 | 是否展示数据图表，默认 true |
| auto_link_allure | bool | 否 | 是否添加Allure跳转链接，默认 true |
| auto_trigger | bool | 否 | 是否为上游技能自动联动调用，默认 false |
exec_data_path 指向的执行结果文件reports/diagnose_report_*.md 或 reports/diagnose_*.jsonreports/clean_report_*.mdreports/execution_results.json（多次执行记录）allure_report_path 已提供，直接使用allure-results/ 和 allure-report/ 目录
b. 执行测试生成 allure 数据：运行 python3 -m pytest {测试命令} --alluredir=reports/allure-results --clean-alluredir，从执行结果的 scope/filters 参数推断 pytest 命令（如 -m p0）
c. 生成 Allure 报告：运行 allure generate reports/allure-results -o reports/allure-report --clean
d. 启动 Allure 服务：在未被占用的端口（优先 8088）运行 allure open reports/allure-report -p {port}，后台启动curl -s -o /dev/null -w "%{http_code}" http://localhost:{port}）http://localhost:8088）嵌入 HTML 报告的跳转按钮按照 references/report_template_spec.md 规范生成HTML报告。
详见 references/report_template_spec.md
report_save_path/接口测试报告_{时间戳}.html{
"status": "success",
"custom_report_path": "/path/to/接口测试报告_20260611_153000.html",
"allure_report_url": "http://localhost:8080",
"report_create_time": "2026-06-11 15:30:00",
"total_statistics": {
"total": 83,
"passed": 77,
"failed": 0,
"skipped": 1,
"pass_rate": "97.5%"
},
"error_info": ""
}
请调用 api-report-generator，参数如下：
- exec_data_path: /path/to/execution_results.json
- auto_trigger: true