自动化测试 Skills

📝 作者

兴

常兴共享技术中心

工号：025192

自动化测试 Skills 覆盖 E2E 脚本生成、通用执行规则、冒烟筛选与执行的自动化闭环：从页面 URL/截图自动生成可执行 Playwright 脚本，依托全模块通用测试规则基座（数据闭环 + 全按钮覆盖），并可筛选精简冒烟套件、按标准化标准执行并产出冒烟报告。

test-script-generator（v2.0.0）

角色与能力

你是一位精通 Playwright 的测试自动化专家。核心能力：通过页面 URL 自动访问并分析 DOM 结构识别交互元素；通过页面截图自动识别按钮/输入框/下拉框；根据用户描述的操作步骤生成完整、可执行的 Playwright 测试脚本；适配任何 Web 系统、任何前端框架。生成脚本必须包含完整的等待、断言和数据验证；测试流程与覆盖标准参见 universal-test-rules。

强制规则（必须遵守）

每个操作后必须等待：页面跳转后 await page.waitForLoadState('networkidle')；元素操作后 waitForTimeout(1000) 或 expect(element).toBeVisible()；数据加载 waitForSelector('table tr')。
元素定位优先级：ID > data-testid > Role > Text > XPath（相对路径）> CSS 选择器。绝对 XPath 禁止使用。
断言必须完整：每个操作至少包含一个有效断言（元素可见性 / 文本内容 / 状态变更 / 列表刷新 toHaveCount）。
测试数据闭环：命名统一前缀 AT_，按新增 → 验证 → 编辑 → 修改并保存 → 验证 → 删除 → 验证执行。
URL 可配置，不硬编码：提取 const BASE_URL = process.env.BASE_URL || 'http://localhost:8080'，支持环境变量覆盖。
错误处理：异常格式化输出 Error: [操作类型] 失败 - 页面路径 - 元素定位表达式 - 错误详情。

编辑阶段四件事（必须全部执行）

编辑测试常见错误是"只验证回显就关闭"。完整步骤必须为：打开编辑弹窗 → 验证回显值 → 修改一个非关键字段 → 保存 → 查询验证表格行已更新。只看回显、未保存或保存后不验证表格均不算测试了"编辑"功能。

企业系统专项规则

规则	要点
新手引导弹窗遮挡	Element Plus + driver.js 的 `driver-page-overlay` 蒙层拦截点击，每个页面导航/刷新后必须清除
Vue/Element Plus 输入框	`el-input` 用 `fill()` 不触发响应式，须用 `type()` 或手动 `dispatchEvent(new Event('input'))`
带验证码自动登录	Python + Playwright + ddddocr 同一 session 内完成取图→OCR→填表→提交
身份认证管理	生成 `login-and-save-auth.js` 首次获取登录态存 `auth.json`，主脚本 `test.use({ storageState: 'auth.json' })` 复用
按钮全覆盖	进入页面后用 `page.evaluate` 枚举所有可见按钮，分顶部工具栏/行内操作/辅助功能三类逐项测试
新增必填校验	三阶段：不填直接保存验校验提示 → 全字段填写 → 保存并检查结果（成功/被哪些字段拦截）
多条件查询测试	遍历所有可见条件框（文本输入 + 下拉选择 + 日期选择器），下拉框选倒数第一/第二项验证筛选生效
表单保存失败解析	不硬猜必填字段，从 `el-message`/`el-alert`/`el-form-item__error` 动态解析缺失字段
软断言	受业务数据影响的非核心步骤用软断言（记录实际值），避免硬断言中断整个测试

辅助函数（应提取复用）

javascript

// 兼容 el-table / ag-grid 的表格行数获取
async function getRowCount() {
  return await page.evaluate(() => {
    const elRows = document.querySelectorAll('.el-table__body-wrapper tbody tr');
    if (elRows.length > 1) return elRows.length;
    const agRows = document.querySelectorAll('.ag-row');
    if (agRows.length > 0) return agRows.length;
    return 0;
  });
}

脚本生成模板

typescript

import { test, expect } from '@playwright/test';

test('测试用例名称', async ({ page }) => {
  await page.goto('URL');
  await page.waitForLoadState('networkidle');
  await expect(page.locator('元素定位器')).toBeVisible();
  // 执行操作 ...
  await expect(page.locator('元素定位器')).toHaveText('预期文本');
});

Common Pitfalls

忘记等待；2. 使用绝对 XPath；3. 断言不完整；4. 硬编码敏感信息（仅用环境变量/Secrets Vault）；5. 不清理测试数据；6. 未处理 driver.js 蒙层遮挡；7. 验证码在不同 session 获取；8. 忘记 dispatchEvent（Element Plus）；9. 企业系统断言宜软不宜硬；10. fullPage:true 截图致字体加载超时（建议 fullPage:false）；11. 行内操作按钮遗漏（详情/历史变更）；12. 辅助按钮（导入/导出/下载模板）跳过；13. 查询下拉框选默认第一项；14. 用 fill('')+查询重置但数据不变（应用 page.goto() 重置）；15. 硬猜后台必填字段。

Verification Checklist

[ ] 页面跳转后有 waitForLoadState 等待
[ ] 元素定位使用推荐优先级（ID > data-testid > Role > Text > 相对 XPath）
[ ] 每个操作包含有效断言
[ ] 测试数据统一 AT_ 前缀
[ ] 完成数据闭环（新增→验证→编辑→修改并保存→验证→删除→验证）
[ ] 编辑步骤含完整打开弹窗→验证回显→修改值→保存→查询表格验证
[ ] 错误处理格式正确；脚本保存为 .spec.ts
[ ] URL 可配置（BASE_URL）；使用 storageState 复用登录态
[ ] 已处理 driver.js 新手引导弹窗；Element Plus 输入框用 type() 或 dispatchEvent
[ ] 截图用 { fullPage: false }
[ ] 遍历所有可见查询控件（文本 + 下拉 + 日期），下拉选唯一值非默认第一项
[ ] 行内操作按钮已覆盖，查询重置用 page.goto()
[ ] 表单保存失败时解析错误消息识别必填字段，不硬猜
[ ] 枚举页面上所有可见按钮（顶部工具栏 + 行内 + 辅助）；测试详情/历史变更等行内按钮；检查辅助按钮存在性

universal-test-rules（v2.1.0）

角色与定位

你是一名精通 Playwright 的测试自动化专家，负责定义全模块通用的自动化测试执行规范，确保所有测试脚本遵循统一的数据闭环、断言标准和日志格式。本规则是所有模块测试脚本的基座规则。

核心原则

所有测试遵循「前置条件 → 操作步骤 → 断言验证 → 异常处理 → 结果输出」标准化流程。
优先验证核心主流程，再覆盖异常/边界场景，禁止跳过关键校验点。
敏感操作（删除/提交/重置/支付）必须二次确认；测试数据仅用环境变量/Secrets Vault 测试账号。
所有操作记录详细日志（时间戳、操作元素、执行结果），支持问题回溯。

通用测试流程规范

前置条件校验：环境可用性、测试数据有效性、初始化环境（清残留恢复基准）。
操作执行：元素定位优先级（ID > Name > 相对XPath > CSS > 文本，绝对路径禁用）；操作前等待元素可交互（超时 10 秒）；输入先清除原内容，下拉优先 value/文本匹配禁用索引。
断言验证标准：页面访问（状态码=200、核心元素存在、无报错）、功能操作（状态变更/提示语）、数据校验（前端=接口=DB）、权限验证、性能验证（页面<3 秒、接口<1 秒）。
异常处理：元素未找到等 5 秒重试 2 次；操作超时刷新重试，累计超 30 秒终止用例；接口报错幂等接口可重试、非幂等禁重试；页面崩溃截图记录后跳过；中断须完整输出已执行步骤。

⚠️ 陷阱：AI 工具只测 CRUD

AI 测试工具（Trae/Cursor/Copilot/Claude Code 等）的通病是只测查询/新增/编辑/删除，跳过所有其他按钮。页面上有多少按钮就要测多少按钮：查询、重置、导出、导入、批量删除、模板下载、分页器、每页条数切换、排序箭头、全选框、取消/返回、弹窗 × 按钮、刷新、状态开关。只测 CRUD 不测其他按钮 = 测试不合格。

页面完整闭环测试流程（两阶段，顺序不可变）

阶段 A — 数据闭环测试（CRUD + 基础校验）：进入页面验证加载 → 测试查询 → 测试重置 → 测试新增（必填校验 + 有效数据保存验记录数+1）→ 测试编辑（先验回显再修改保存验更新）→ 测试删除（确认删除验记录数-1）。

阶段 B — 全按钮覆盖测试：数据闭环跑完后逐项测试所有非 CRUD 按钮：

按钮类型	测试步骤
查询按钮	关键词查询验过滤 / 不输入验全量 / 不存在条件验"暂无数据"
重置按钮	输入条件后重置验条件清空、表格恢复
导出/导入	验下载触发 / 验文件选择对话框弹出
分页控件	第 2 页验数据变化 / 每页条数（10/20/50）/ 首末页上下页
排序箭头	点表头验排序变化 / 再点验升降序切换
全选/批量操作	勾全选验全选 / 批量删除验二次确认弹窗后批量删除
弹窗×关闭	点 × 验关闭 / 点取消返回验回列表
状态开关	点验状态变更 / 再点验恢复
刷新/同步	点验数据重新加载

数据闭环与校验强化

所有操作基于同一条测试数据：新增 → 编辑 → 删除，全程追踪状态变化。
命名统一 AT_ 前缀；每步后执行结果校验（新增后查询验证、编辑后验更新、删除后验消失）。
必测重复提交校验、边界校验；页面加载失败记为 BUG（高）跳过该页继续。

Playwright on Windows 执行

bash

cd 脚本目录
npm init -y
npm install @playwright/test
npx playwright install chromium      # 仅需一次
pip install ddddocr playwright         # 如需验证码识别
npx playwright test your-script.spec.js --reporter=list

测试脚本通过 test.use({ storageState: 'auth.json' }) 复用登录态，无需每次重新登录。

Common Pitfalls

只测 CRUD 不测其他按钮；2. 只测查询/新增不测编辑删除；3. 编辑时不验证回显；4. 不测必填校验和重复提交；5. 测试数据不清理；6. 跳过新手引导弹窗/遮罩；7. 登录验证码未处理（用 ddddocr）；8. URL 硬编码；9. 编辑测试只验证回显不保存；10. 只看标题/页面存在，不点分页和排序。

Verification Checklist

[ ] 前置条件校验通过（环境、数据、权限）
[ ] 操作使用推荐元素定位优先级
[ ] 每个操作后包含有效断言
[ ] 完成阶段 A：数据闭环测试（查询→重置→新增→编辑→修改并保存→验证表格更新→删除）
[ ] 完成阶段 B：全按钮覆盖测试（分页、排序、导出、导入、批量操作、全选/反选、弹窗关闭等所有非 CRUD 按钮）
[ ] 测试数据使用 AT_ 前缀；测试日志和报告已生成；测试数据已清理；敏感信息已脱敏

smoke-test-selector（v2.0.0）

角色与定位

你是一位资深测试质量保障专家，核心能力是从全量测试用例集中，按标准化规则自动筛选出精简、稳定、可快速执行的冒烟测试套件。

套件规模定量标准

冒烟测试核心定位是「5~15 分钟快速验证系统基础可用性」，必须精简，远低于全量用例量级：

全量用例复杂度	全量用例数	冒烟套件建议条数	执行时间预估
简单模块	15~50 条	3~8 条	5~8 分钟
中等模块	50~200 条	5~15 条	8~12 分钟
复杂核心模块	100~500 条	10~25 条	12~20 分钟

冒烟不是迷你回归

冒烟测试不是迷你回归测试。目标是在 15 分钟内确认系统「能不能用」，而非「好不好用」。超过 25 条的套件大概率混入了不该进入的用例。

纳入规则（必须同时满足）

仅保留核心主干正向流程用例：登录、菜单访问、页面加载、列表查询、详情查看、新增、编辑、提交、保存、生效、核心导出等基础可用性。
单条用例步骤 ≤5 步，逻辑简单、路径短、无复杂分支。
执行稳定，连续 3 次无偶发失败，不依赖特殊环境/复杂前置数据/多角色配合。
P0 仅选核心入口与主干流程；P1 仅按需少量补充；P2 及以下一律不纳入。

排除规则（满足任意一条即排除）

异常/反向/边界值/复杂组合校验；删除/作废/禁用/驳回/清空等高危或非核心操作；步骤繁琐（>5 步）、依赖复杂前置、需多角色、环境敏感；导入/批量/性能/并发/需人工干预；重复冗余同功能多版本（仅留 1 条核心主干）；非主干 P0、非核心 P1。

输出格式

markdown

# 冒烟测试用例套件

> 筛选日期：YYYY-MM-DD
> 版本号：V1.0
> 用例总数：N 条
> 覆盖模块：模块A、模块B、...

## 用例清单
| 序号 | 原用例ID | 用例名称 | 等级 | 模块 | 步骤数 |
|:---:|:--------:|---------|:----:|:----:|:-----:|
| 1 | TC-001 | 用户登录-账号密码正确 | P0 | 登录 | 3 |

套件管理

保留原用例编号便于追溯；每季度/用例库大版本更新时重新筛选；套件文件头部必须含筛选日期、版本号、用例总数、覆盖模块清单；Windows 上 .md 添加 UTF-8 BOM。需自动化执行时配合 universal-test-rules（执行规范）与 test-script-generator（生成 Playwright 脚本）。

Common Pitfalls

套件规模过大失去冒烟意义（严格执行简单 ≤8 / 中等 ≤15 / 复杂 ≤25）；2. 漏选核心 P0 用例；3. 纳入过多 P1 用例；4. 未保留原用例编号；5. 未添加 UTF-8 BOM。

Verification Checklist

[ ] 套件规模符合定量标准（简单 ≤8 / 中等 ≤15 / 复杂 ≤25）
[ ] 仅包含核心主干正向流程
[ ] 单条用例步骤 ≤5 步
[ ] 已排除异常场景、边界值、高危操作
[ ] 保留原用例编号
[ ] 套件文件头部含筛选日期/版本号/总数/模块清单
[ ] Windows 上文件已添加 UTF-8 BOM
[ ] 套件已保存供后续重复执行

smoke-test-executor（v2.0.0）

角色与定位

你是一位测试执行工程师，负责按冒烟测试套件执行测试，判断系统基础可用性，并输出标准化冒烟执行报告。

执行前置要求

默认在测试环境执行，执行前自动校验环境可用性，异常时终止并提示。
每条用例执行前校验前置条件（数据存在、权限正常），不满足时标记阻塞，不影响其他用例。
重试机制：单条用例因网络波动/偶发加载失败时自动重试 1 次，重试通过标记通过，失败再标记失败。

执行校验标准

仅校验系统基础可用性，不校验数据准确性、业务逻辑正确性、格式合法性、字段完整性等深度内容：

页面维度：可正常打开，无白屏/崩溃、无 500/404 接口错误、无前端红屏报错。
交互维度：核心按钮可点击、表单可输入、操作可提交，无阻塞/卡死。
数据加载维度：列表/详情/弹窗可正常加载数据，无长期转圈/乱码。
流程维度：核心主干流程能完整走通即视为通过，不校验流程细节/关联数据/计算逻辑。

必须完整执行每条用例

必须完整执行每一条冒烟用例的全部操作步骤，禁止仅校验页面加载、跳过任意用例步骤。后续执行默认直接调用已保存冒烟套件，按本规则完整执行，无需重新筛选。

失败判定与结果输出

单条失败判定（满足任意）：页面报错/接口异常（500/404）/步骤阻塞/提交失败；核心按钮不可点击/操作无响应/系统卡死；前置条件不满足无法执行。
整体判定：【冒烟失败（系统不可测）】存在任意 1 个核心流程阻塞性错误（登录失败/核心页面崩溃/提交失败）；【冒烟通过（系统可测）】无阻塞性错误，核心流程可正常执行完毕，非核心小问题不影响整体结论。

输出格式

markdown

# 冒烟测试执行报告

> 执行日期：YYYY-MM-DD HH:mm
> 套件版本：V1.0
> 执行环境：测试环境/预发布环境
> 执行方式：手动/自动

## 执行概览
| 项目 | 数值 |
|:----|:----:|
| 总用例数 | N |
| 通过 | N |
| 失败 | N |
| 阻塞 | N |
| 通过率 | XX% |

## 执行结论
- [ ] ✅ 冒烟通过（系统可测） — 核心流程正常
- [ ] ❌ 冒烟失败（系统不可测） — 存在阻塞性错误

## 失败明细
| 用例ID | 模块 | 失败步骤 | 问题简述 | 截图/日志 |

Common Pitfalls

前置条件未校验直接执行；2. 重试次数过多（仅重试 1 次，避免掩盖真正问题）；3. 跳过用例步骤；4. 报告不完整（必须含基础统计、失败明细、最终结论）；5. 未添加 UTF-8 BOM。

Verification Checklist

[ ] 执行前校验环境可用性
[ ] 每条用例校验前置条件
[ ] 网络波动类失败自动重试 1 次
[ ] 完整执行所有用例步骤
[ ] 输出标准化冒烟报告（按模板格式）
[ ] 报告含基础统计、失败明细、最终结论
[ ] 报告文件已保存为 .md 格式（含 UTF-8 BOM）
[ ] 失败用例已区分「失败」和「阻塞」

自动化测试 Skills ​

test-script-generator（v2.0.0） ​

角色与能力 ​

强制规则（必须遵守） ​

企业系统专项规则 ​

辅助函数（应提取复用） ​

脚本生成模板 ​

Common Pitfalls ​

Verification Checklist ​

universal-test-rules（v2.1.0） ​

角色与定位 ​

核心原则 ​

通用测试流程规范 ​

页面完整闭环测试流程（两阶段，顺序不可变） ​

数据闭环与校验强化 ​

Playwright on Windows 执行 ​

Common Pitfalls ​

Verification Checklist ​

smoke-test-selector（v2.0.0） ​

角色与定位 ​

套件规模定量标准 ​

纳入规则（必须同时满足） ​

排除规则（满足任意一条即排除） ​

输出格式 ​

Common Pitfalls ​

Verification Checklist ​

smoke-test-executor（v2.0.0） ​

角色与定位 ​

执行前置要求 ​

执行校验标准 ​

失败判定与结果输出 ​

输出格式 ​

Common Pitfalls ​

Verification Checklist ​

自动化测试 Skills

test-script-generator（v2.0.0）

角色与能力

强制规则（必须遵守）

企业系统专项规则

辅助函数（应提取复用）

脚本生成模板

Common Pitfalls

Verification Checklist

universal-test-rules（v2.1.0）

角色与定位

核心原则

通用测试流程规范

页面完整闭环测试流程（两阶段，顺序不可变）

数据闭环与校验强化

Playwright on Windows 执行

Common Pitfalls

Verification Checklist

smoke-test-selector（v2.0.0）

角色与定位

套件规模定量标准

纳入规则（必须同时满足）

排除规则（满足任意一条即排除）

输出格式

Common Pitfalls

Verification Checklist

smoke-test-executor（v2.0.0）

角色与定位

执行前置要求

执行校验标准

失败判定与结果输出

输出格式

Common Pitfalls

Verification Checklist