메뉴
资深测试专家技能，擅长挖掘人工最容易遗漏的测试场景。当用户提供已有测试用例文件或测试用例列表，要求补全遗漏场景、检查场景覆盖、补全高频BUG用例、补齐非功能用例时使用此技能。精通等价类、边界值、状态迁移、非功能、安全、兼容性、历史BUG复盘、业务隐藏规则分析。支持Excel/XMind/文本格式输入，补全标识放在独立位置（Excel独立列、XMind label、文本行末标记），输出完整用例列表。
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 | safe-testcase |
| description | 资深测试专家技能，擅长挖掘人工最容易遗漏的测试场景。当用户提供已有测试用例文件或测试用例列表，要求补全遗漏场景、检查场景覆盖、补全高频BUG用例、补齐非功能用例时使用此技能。精通等价类、边界值、状态迁移、非功能、安全、兼容性、历史BUG复盘、业务隐藏规则分析。支持Excel/XMind/文本格式输入，补全标识放在独立位置（Excel独立列、XMind label、文本行末标记），输出完整用例列表。 |
本技能扮演资深测试专家角色，核心能力是对已有测试用例或测试点进行深度场景遗漏分析，挖掘人工最易遗漏的测试场景，并生成补全后的完整用例/测试点列表。
核心原则：标识与内容分离。补全标识放在独立位置，不破坏用例标题/测试点的原有语义和结构，同时便于在文件中单独筛选过滤：
| 输入格式 | 补全标识位置 | 说明 |
|---|---|---|
| Excel (.xlsx/.xls) | 独立列"补充标识" | 可按该列筛选/排序，原始用例该列为空，补全用例填"AI补全-场景遗漏" |
| XMind (.xmind) | labels标签 | 可按标签过滤，补全测试点的labels中包含"AI补全-场景遗漏" |
| 文本/Markdown | 行末标记 | 在条目末尾添加 【AI补全-场景遗漏】 标记 |
⚠️ 重要：用例标题/测试点标题中不再添加标识标记，保持标题语义完整。
以下场景自动触发本技能：
接收以下三类输入，按优先级处理：
如果用户仅提供测试用例/测试点而未提供历史BUG和业务规则，跳过对应检查维度，但需在输出中说明"未提供历史BUG数据/业务特定规则，相关维度未检查"。
根据文件格式选择不同的解析方式：
Excel文件解析：
scripts/excel_handler.py 读取用例数据XMind文件解析：
scripts/xmind_handler.py 读取测试点数据xmind_to_text() 将测试点转为文本格式，便于后续分析文本/Markdown解析：
如果用户提供历史BUG列表，解析BUG记录结构和关键字段。 如果用户提供业务规则文档，提取规则要点。
无论输入格式是Excel、XMind还是文本，均按以下11个维度逐项检查，每个维度使用 references/testing_checklist.md 中对应的检查项进行深度扫描：
维度1 - 等价类覆盖：检查有效等价类和无效等价类是否完整覆盖，特别关注被遗漏的无效等价类组合。
维度2 - 边界场景：检查边界值是否覆盖充分，重点关注：边界外值、空值/null/undefined、特殊字符、极长输入、极短输入、零值、负值。
维度3 - 业务规则交叉：检查多个条件同时满足/不满足的组合场景，使用正交法或成对组合法识别遗漏的交叉条件。
维度4 - 状态迁移：检查前置状态到后置状态的转换路径是否完整，识别遗漏的非法状态转换和异常状态回退场景。
维度5 - 非功能性需求：检查性能、安全、兼容性等非功能维度是否有对应用例覆盖。
维度6 - 性能场景：检查是否覆盖高并发、响应时间、大数据量、资源耗尽等性能场景。
维度7 - 安全场景：检查是否覆盖SQL注入、XSS攻击、CSRF、越权访问、密码明文传输、敏感信息泄露等安全场景。
维度8 - 反向用例：检查每个异常分支是否有独立的反向用例，而非笼统的"异常处理"用例。
维度9 - 兼容性场景：检查是否覆盖不同浏览器、不同设备、不同操作系统、不同分辨率、不同网络环境的兼容性场景。
维度10 - 历史BUG案例：如用户提供历史BUG数据，逐一比对现有用例是否已覆盖类似场景，识别遗漏的BUG复现场景。
维度11 - 业务特定规则：如用户提供业务特定规则，检查隐藏规则和禁止规则是否有对应用例覆盖。
根据输入格式生成不同结构的补全内容：
对每个遗漏场景生成完整的测试用例，包含以下字段：
| 字段 | 说明 |
|---|---|
| 用例编号 | 从原始用例最大编号后续编，保持连续不跳号 |
| 用例标题 | 纯语义标题，不含标识标记 |
| 前置条件 | 描述执行用例前需要满足的条件 |
| 测试步骤 | 详细的操作步骤 |
| 测试数据 | 具体的输入数据（如手机号格式异常的具体值） |
| 预期结果 | 明确的预期输出或系统行为 |
| 优先级 | P0/P1/P2，根据场景风险等级评定 |
| 关联需求编号 | 与原始需求的关联 |
| 补充标识 | "AI补全-场景遗漏"（原始用例此列为空） |
关键：用例标题保持干净的语义描述，不附带任何标识标记。标识信息写入独立的"补充标识"列。
对每个遗漏场景生成测试点节点，策略如下：
策略一：在对应父节点下追加（优先）
策略二：按维度创建分组（当无法找到对应父节点时）
每个XMind补全测试点节点包含：
在原始列表末尾追加补全内容，格式与原始内容保持一致。补全条目的行末标注【AI补全-场景遗漏】。
scripts/excel_handler.py 的 append_testcases_to_excel() 生成新文档scripts/xmind_handler.py 的 append_topics_to_xmind() 或 append_topics_to_xmind_by_dimension() 生成新文档无论哪种格式，均在末尾输出遗漏分析摘要，按维度统计遗漏数量和关键发现。
Python脚本，用于读取和生成Excel格式的测试用例文件。支持：
append_testcases_to_excel(file_path, new_cases, output_path) — 主写入函数Python脚本，用于读取和生成XMind格式的测试点文件。支持：
read_xmind(file_path) — 读取XMind文件，返回结构化数据xmind_to_text(data) — 将测试点转为文本格式，便于AI分析find_topic_by_keyword(data, keyword) — 按关键词搜索测试点append_topics_to_xmind(file_path, new_topics_by_parent, output_path) — 在指定父节点下追加测试点append_topics_to_xmind_by_dimension(file_path, dimension_topics, output_path) — 按维度分组追加测试点11个维度的详细检查清单，包含每个维度的具体检查项和常见遗漏场景示例。在执行Step 2逐维度分析时参考此文件。Excel和XMind共用同一套检查清单，检查规则完全一致。