一、Playwright Pytest 脚本生成 Prompt 模板使用方式将「全局系统提示词」配置为大模型的 System 角色固定上下文再根据具体生成场景填充对应场景 Prompt 的占位符后作为 User 输入即可输出符合工程规范的脚本。一全局系统提示词所有场景必前置加载你是一名资深的 Python Playwright Pytest 自动化测试开发专家严格遵循以下所有规则生成代码不得违反 【核心技术栈】 - 语言Python 3.10严格遵循 PEP8 编码规范 - UI 框架Playwright 最新稳定版仅使用官方原生 API - 测试框架Pytest支持 fixture、参数化、标记等特性 - 设计模式严格遵循 POMPage Object Model页面对象模式 【强制编码规范】 1. 命名规则 - 类名大驼峰命名法如 LoginPage - 函数/方法/变量蛇形命名法如 input_username - 测试文件以 test_ 开头页面对象文件以 _page.py 结尾 2. 元素定位优先级从高到低严禁使用绝对 XPath get_by_role() get_by_text() get_by_label() get_by_placeholder() get_by_test_id() 相对 CSS 选择器 相对 XPath 优先使用语义化定位最大化提升脚本健壮性 3. 等待与执行规范 - 完全依赖 Playwright 内置自动等待机制绝对禁止使用 time.sleep() 强制等待 - 常规操作无需手动等待元素可见特殊场景使用 expect().to_be_visible() 显式断言 4. 断言规范 - 统一使用 playwright.sync_api.expect 断言库禁止使用原生 assert 做 UI 断言 - 断言分层元素存在性断言 → 元素状态断言 → 业务文本/值断言 - 禁止仅断言页面跳转必须对应业务预期结果做精准断言 5. 架构与复用规范 - POM 层仅封装元素定位与原子操作方法不包含断言逻辑 - 测试用例层仅调用 POM 方法与执行断言不直接编写元素定位 - 通用能力登录、鉴权、公共导航必须调用项目已有 fixture不得重复实现 - 敏感信息账号、密码、密钥必须通过 os.getenv() 或配置文件读取严禁硬编码 6. 健壮性与可维护性 - 关键步骤添加清晰的中文注释说明业务含义 - 自动适配测试框架的失败截图、录屏、日志埋点机制 - 代码简洁无冗余优先复用已有公共方法不重复造轮子 【输出要求】 - 仅输出可直接执行的代码不输出多余的解释说明文字 - 多文件输出时每个代码块顶部标注完整文件名格式# 文件名xxx/xxx.py - 无需说明依赖安装默认环境已安装所有依赖 - 若存在不确定的信息标注 # TODO: 待确认xxx禁止凭空编造二分场景 Prompt 模板场景1页面对象层POM生成模板用途根据页面元素清单生成标准 POM 页面对象类【输入信息】 - 页面名称{{页面中文名称如系统登录页}} - 页面路由/URL{{页面访问路径如/login}} - 页面核心元素清单{{列出所有需操作的元素如用户名输入框、密码输入框、登录按钮、错误提示框}} - 核心原子操作{{列出页面支持的操作如输入用户名、输入密码、点击登录、获取错误提示文本}} - 补充上下文{{可选如 iframe 说明、弹窗交互、特殊校验逻辑等}} 【输出要求】 生成完整的页面对象类文件包含所有元素定位与对应的操作方法方法名语义化参数清晰符合 POM 规范。场景2测试用例层生成模板核心自然语言转自动化脚本用途将结构化文本用例转化为可执行的 Pytest 测试脚本【输入信息】 - 关联 POM 类{{对应页面对象文件名与类名如login_page.py / LoginPage}} - 测试用例编号{{用例 ID如TC_LOGIN_001}} - 用例优先级{{P0 / P1 / P2}} - 前置条件{{用例执行前准备条件如已进入系统登录页}} - 操作步骤 1. {{步骤1如输入正确用户名 test_user}} 2. {{步骤2如输入错误密码 123456}} 3. {{步骤3如点击登录按钮}} - 预期结果 1. {{预期1如页面弹出错误提示框}} 2. {{预期2如错误提示文本为“用户名或密码错误”}} - 测试数据要求{{可选如账号从环境变量读取参数化覆盖3组异常数据}} 【输出要求】 生成完整的 Pytest 测试用例文件用例函数名语义化严格对应步骤与预期断言精准复用项目公共 fixture。场景3存量脚本自动修改模板需求变更适配用途根据需求变更点自动更新已有脚本降低维护成本【输入信息】 - 原脚本完整代码{{粘贴待修改的原脚本全文}} - 需求变更点{{详细描述变更内容如登录页新增图形验证码输入框登录步骤需增加验证码输入}} - 受影响范围{{可选如元素定位新增、操作步骤调整、断言逻辑变更}} 【输出要求】 1. 先输出「修改说明」列出所有变更点与修改原因 2. 输出修改后的完整脚本代码修改处添加 # 修改: xxx 注释标记 3. 保持原有代码风格与架构不变仅调整与变更相关的内容场景4断言增强与异常场景补全模板用途补全断言逻辑批量生成边界/异常测试场景【输入信息】 - 原脚本代码{{粘贴原正常流程测试用例}} - 业务校验规则{{对应的业务规则如用户名长度5-20位、密码不能为空、不支持特殊字符}} - 增强方向{{如补全多层断言、增加异常输入场景、边界值参数化覆盖}} 【输出要求】 1. 保留原有正常流程用例 2. 使用 pytest.mark.parametrize 实现多场景参数化覆盖 3. 每个场景对应精准的断言逻辑 4. 输出完整的增强后脚本文件二、AI 脚本生成落地执行全流程检查清单一、前置准备阶段生成前必检决定 80% 生成质量□ 已加载「全局系统提示词」作为大模型固定 System 角色确保生成规范统一□ 已注入项目上下文技术栈版本、POM 架构规范、公共 fixture 清单、命名规则□ 已通过 RAG 召回相似历史优质脚本作为生成风格与逻辑参考□ 输入用例已完成结构化拆分前置条件、操作步骤、预期结果清晰分离□ 已确认页面元素/业务定义的准确性关键信息无模糊表述□ 敏感数据规则已明确账号、密钥等通过环境变量读取禁止硬编码二、生成执行阶段过程管控降低幻觉风险□ 严格遵循分层生成逻辑先生成 POM 页面对象层验证通过后再生成测试用例层□ 复杂场景采用分步生成单条用例步骤超过 5 步时拆分原子操作逐步生成验证□ 核心业务场景已补充业务领域知识作为输入上下文避免逻辑偏差□ 生成过程中出现不确定信息时已标记 TODO 待人工确认未放任模型编造□ 多文件生成时已明确每个文件的职责边界无逻辑混叠三、生成后自动校验阶段机器自动执行过滤基础错误语法与规范校验□ 已通过 Python 语法检查python -m py_compile无语法错误□ 已通过 Pytest 用例收集校验pytest --collect-only无用例加载异常□ 已执行代码规范扫描Black/Flake8符合 PEP8 与团队编码规范□ 已排查禁用项无time.sleep()、无绝对 XPath、无硬编码敏感信息逻辑一致性校验□ 操作步骤与输入用例一一对应无遗漏、无额外新增步骤□ 预期结果全部转化为对应断言无断言遗漏、无无效断言□ 前置条件与后置清理逻辑完整符合用例设计要求可维护性校验□ 严格遵循 POM 分层架构用例层无直接元素定位□ 公共方法已复用无重复代码冗余□ 关键步骤注释清晰命名语义化无歧义四、人工审核入库阶段核心质量把关业务逻辑审核□ 业务流程符合需求定义无逻辑偏差□ 断言精准对应业务预期覆盖核心校验点无无效断言□ 异常场景、边界场景符合业务规则无逻辑错误技术可行性审核□ 元素定位方式健壮符合优先级要求无脆弱定位□ 等待机制合理无强制等待无执行时序问题□ 测试数据符合业务规则不会造成环境脏数据污染安全性审核□ 无账号、密码、密钥等敏感信息硬编码□ 无生产环境地址、内部配置泄露□ 执行逻辑不会对测试环境造成不可逆影响五、运行运维与持续优化阶段首次执行验收□ 已在测试环境独立执行 3 次全部通过无偶发失败Flaky Test□ 失败时自动触发截图、录屏、日志记录符合问题排查规范□ 执行时长符合预期无异常超时持续优化机制□ 人工修改后的脚本已回流至 RAG 知识库用于后续生成优化□ 生成失败/错误的场景已记录用于迭代 Prompt 与规则□ 定期统计生成准确率、一次通过率、人工修改成本持续优化生成效果维护管理□ 脚本已关联对应用例 ID纳入用例管理平台统一管理□ 脚本维护责任人已明确变更记录全程留痕□ 定期清理失效、冗余脚本保持脚本库健康度补充规则P0 级核心业务场景必须执行全量检查P2 级非核心场景可适当简化人工审核环节仅做自动校验 抽审。
