minium-test-generator

Minium 录制脚本转测试用例工具。自动解析录制脚本，生成符合规范的测试用例和页面对象，确保步骤完整、逻辑一致。

Install

openclaw skills install minium-test-generator

Minium 测试用例生成器

📖 描述

本技能用于将 Minium 录制脚本自动转换为符合项目规范的测试用例，确保步骤一个不漏，逻辑完全一致。

核心能力:

✅ 解析录制脚本，提取所有步骤
✅ 生成符合规范的页面对象和测试用例
✅ 自动验证步骤完整性
✅ 避免漏掉步骤和简化逻辑

⚡ 核心规则（必须遵守！）

🚨 第一条：必须先确认目录，再生成！

当用户提供录制文件时，禁止直接生成！

正确流程：

第 1 步：询问目录
→ "好的，我来帮你生成测试用例。请问测试用例目录在哪里？（完整路径）"
→ 等待用户回复

第 2 步：检查目录是否存在
→ 如果目录不存在 → 走【新建项目】流程
→ 如果目录已存在 → 走【添加到现有目录】流程

第 3 步：确认创建方式
→ 向用户展示将要创建/添加的文件列表
→ 等待用户确认

第 4 步：生成内容
→ 新建：创建完整项目结构
→ 添加：仅新增文件，不覆盖已有文件

错误示范（禁止！）：

❌ 用户给录制脚本 → 直接生成（未询问目录）
❌ 假设目录结构
❌ 覆盖用户原有文件

🚨 第二条：已存在目录 → 先阅读现有代码结构！

当目录已存在时，禁止直接生成！

正确流程：

第 1 步：读取现有文件结构
→ 列出目录内容（pages/、test_cases/、*.py 等）

第 2 步：阅读已有代码
→ 阅读 pages/ 中的现有 Page Object
→ 分析命名规范、类命名、元素定位风格
→ 阅读 test_*.py 中的现有测试用例
→ 分析测试结构、断言风格、等待方式

第 3 步：总结现有规则
→ Page Object 命名规则（如：驼峰/下划线）
→ 元素定位规则（如：优先 selector 还是 xpath）
→ 测试用例结构（如：是否使用 mark_step_start）
→ 截图点命名规则（如：step_1、tap_1 等）

第 4 步：按现有规则生成新用例
→ 新 Page Object 遵循已有命名和结构
→ 新测试用例遵循已有风格和格式
→ 不引入与现有代码冲突的规范

示例：

我：检测到目录已存在，我先阅读一下现有代码结构...

[阅读 pages/ 和 test_*.py 后]

我：现有代码规则如下：
- Page Object 命名：大驼峰（如 GroupHomepage）
- 元素定位：优先 selector，xpath 备用
- 测试结构：使用 mark_step_start 和 capture
- 截图点命名：动作 + 序号（如 tap_1、scroll_2）

我将按此规则生成新用例，确认吗？

🚨 第三条：同一个页面 → 只需追加方法，不要新建文件！

当 Page Object 文件已存在时：

❌ 错误做法：
- 创建新文件：pages/xxx_new.py
- 或创建重复文件：pages/xxx/xxx_v2.py
- 或创建分散的多个小方法

✅ 正确做法：
- 在原有文件末尾追加新方法
- 保持原有代码不变
- 同一个页面的操作整合到一个方法里
- 使用 basedef.py 中封装的方法（tap()、send_key()）

示例：

原文件：publish_start_group.py (已有 1000 行)

❌ 错误：创建多个分散小方法
    def input_theme(self): ...
    def click_help_entry(self): ...
    def click_reward_switch(self): ...

✅ 正确：整合到一个完整方法
    def pub_group_supply(self, theme_text="xxx"):
        """跟团供货模式发布完整流程"""
        self.send_key(self.theme_input, theme_text)
        self.tap(self.promise_btn)
        self.scroll_to(400)
        self.tap(self.help_entry)
        ...

🚨 第四条：根据页面路径选择 testcase 目录！

用例存放目录规则：

分析录制脚本中的页面路径
- 查看 URL 中的路径结构，如：
  - /pro/pages/homepage/group-homepage/... → 包含 homepage
  - /pro/pages/home/leaders-management/... → 包含 home
  - /pro/pages/seq-publish/... → 包含 seq-publish
检查现有 testcase 目录结构
- 列出 testcase/ 下的子目录
- 对比页面路径中的关键词，选择最匹配的目录
- 例如：页面路径包含 home → 找 testcase/home_page/ 或 testcase/home/
没有合适的目录时
- 根据页面路径中的关键词创建新目录
- 例如：页面路径是 /pro/pages/seq-publish/... → 创建 testcase/seq_publish/

核心原则：看项目的实际目录结构，不要硬编码映射关系！

🚨 第五条：先阅读用户代码，再决定使用什么方法！

Page Object 核心规则：

先阅读用户的基类代码（如 basedef.py）
- 检查用户是否封装了点击、输入等方法
- 如果有封装 → 使用用户的封装方法
- 如果没有封装 → 生成封装方法并使用
检查用户的封装方式
- 点击方法：可能是 tap(), click(), click_element() 等
- 输入方法：可能是 send_key(), input_text(), type() 等
- 滚动方法：可能是 scroll_to(), scroll() 等
元素定位策略
- 第一选择：CSS selector（如 view.btn-know.button）
- 用户反馈找不到元素时 → 补充 xpath
- 还找不到时 → 补充 text 匹配
- 不要一开始就生成一堆备用方案！
元素定位与操作分离
- 元素常量：使用中文注释说明用途
- 每个元素都必须有对应的操作方法
- 禁止只有元素定义没有方法
方法命名规范
- 动词开头：click_xxx, input_xxx, select_xxx
- 语义清晰：方法名能清楚表达操作意图
不要返回 self（除非需要链式调用）
- 大部分方法不需要返回 self
- 只有需要连续调用时才返回
不要照搬录制脚本的等待时间！
- 录制脚本中的 self.page.wait_for(x) 是录制工具自动生成的
- 用户的基类方法（如 tap(), send_key()）内部已有等待逻辑
- 禁止生成多余的 sleep() 或 wait_for()
- 除非用户明确要求添加等待
不需要生成 .bat 运行脚本
- 用户有自己的运行方式（如 run.py）
- 除非用户明确要求，否则不生成 .bat 文件

示例：

# 情况 1：用户已有封装方法（如 basedef.py 中有 tap() 和 send_key()）
class SelectFollowReward(BaseDef):
    reward_value_input = "..."
    confirm_btn = "..."
    
    def input_reward_value(self, value):
        self.send_key(self.reward_value_input, str(value))  # 使用用户的封装
    
    def click_confirm(self):
        self.tap(self.confirm_btn)  # 使用用户的封装

# 情况 2：用户没有封装方法
class SelectFollowReward(BaseDef):
    reward_value_input = "..."
    confirm_btn = "..."
    
    def input_reward_value(self, value):
        self.page.get_element(self.reward_value_input).input(str(value))
    
    def click_confirm(self):
        self.page.get_element(self.confirm_btn).tap()

新建项目结构：

tests/
├── pages/                  # Page Object 层
│   ├── __init__.py         # 导出所有页面对象
│   ├── [页面].py           # 每个页面一个类
│   └── README.md           # PO 模型说明
├── test_cases/             # 测试用例文档
│   └── [用例名].md         # Markdown 格式用例
├── conftest.py             # Pytest 配置
├── run_test.py             # 测试启动脚本
└── test_[用例名].py        # 可执行测试脚本

⚡ 工作流程

场景 A：新建项目（目录不存在）

当用户提供的目录不存在时：

我：好的，我来帮你生成测试用例。

检测到目录不存在，我将为你创建完整的测试项目结构：

📁 [用户提供的路径]/
├── pages/                  # Page Object 层
│   ├── __init__.py
│   ├── [页面 1].py
│   └── [页面 2].py
├── test_cases/             # 测试用例文档
│   └── [用例名].md
├── conftest.py             # Pytest 配置
├── run_test.py             # 测试启动脚本
└── test_[用例名].py        # 可执行测试脚本

确认开始创建吗？

用户确认后：

创建所有目录和文件
生成 Page Object 框架
生成第一个测试用例

当用户提供的目录已存在时：

我：好的，我来帮你生成测试用例。

检测到目录已存在，我将在现有目录下添加新用例：

📁 [用户提供的路径]/
├── pages/                  # 新增 Page Object
│   └── [新页面].py
├── test_cases/             # 新增测试用例文档
│   └── [新用例名].md
└── test_[新用例名].py      # 新增测试脚本

⚠️ 不会覆盖已有文件

确认开始创建吗？

用户确认后：

仅创建新文件
不修改已有文件
如需更新已有 Page Object，先询问用户

📋 目录检查方法

使用 exec 检查目录是否存在：

# Windows PowerShell
Test-Path "<用户提供的路径>"

# 返回 True → 目录存在 → 走添加流程
# 返回 False → 目录不存在 → 走新建流程

检查子目录结构：

# 检查是否有 pages 目录
Test-Path "<路径>/pages"

# 检查是否有 test_cases 目录
Test-Path "<路径>/test_cases"

# 检查是否有 conftest.py
Test-Path "<路径>/conftest.py"

根据检查结果判断：

如果 pages/ 存在 → 追加新 Page Object
如果 pages/ 不存在 → 创建 pages/ 目录
如果 test_cases/ 存在 → 追加新用例文档
如果 test_cases/ 不存在 → 创建 test_cases/ 目录

📝 完整对话示例

示例 1：新建项目

你：帮我生成测试用例
[粘贴录制脚本]

我：好的，我来帮你生成测试用例。

首先，请告诉我：
1. 测试用例目录在哪里？（完整路径）

你：D:\projects\minium-tests\scenario-a

我：好的，我来检查目录...

检测到目录不存在，我将为你创建完整的测试项目结构：

📁 D:\projects\minium-tests\scenario-a\
├── pages/
│   ├── __init__.py
│   ├── homepage.py
│   └── detail_page.py
├── test_cases/
│   └── scenario_a.md
├── conftest.py
├── run_test.py
└── test_scenario_a.py

确认开始创建吗？

你：确认

我：✅ 项目结构已创建完成！

[输出所有文件内容]

示例 2：添加到现有目录

你：帮我生成测试用例
[粘贴录制脚本]

我：好的，我来帮你生成测试用例。

首先，请告诉我：
1. 测试用例目录在哪里？（完整路径）

你：C:\workspace\expression-trainer-miniprogram\tests

我：好的，我来检查目录...

检测到目录已存在，我将在现有目录下添加新用例：

📁 C:\workspace\expression-trainer-miniprogram\tests\
├── pages/                  # 新增 Page Object
│   └── [新页面].py
├── test_cases/             # 新增测试用例文档
│   └── [新用例名].md
└── test_[新用例名].py      # 新增测试脚本

⚠️ 不会覆盖已有文件

确认开始创建吗？

你：确认

我：✅ 测试用例已添加完成！

[输出新增文件内容]

⚡ 快速触发

当你有以下需求时，直接说即可:

"我给你一个录制文件，帮我生成测试用例" → 触发流程
"帮我生成测试用例" + 录制脚本内容 → 触发流程
"验证一下测试用例是否完整" → 直接验证
"解析这个录制脚本" → 直接解析

示例:

你：我给你一个录制文件，帮我生成测试用例
[从你的录制脚本目录找到 Python 文件，复制内容粘贴]

我：好的，我来帮你生成测试用例。

首先，请告诉我：
1. 测试用例目录在哪里？（完整路径）
2. 是否有现有的测试项目结构？

📁 录制脚本获取方式

🎯 触发条件

核心触发场景: 用户提供 Minium 录制脚本，要求生成或验证测试用例

1. 用户提供录制文件时 ⭐ 主要触发场景

触发词:

"我给你一个录制文件"
"我有一份录制脚本"
"这是我录制的测试脚本"
"录制文件如下"
用户直接粘贴录制脚本代码

文件路径示例:

<你的录制脚本目录>\[场景名称]\[时间戳]\xxx.py

响应流程:

你：我给你一个录制文件，帮我生成测试用例
[粘贴录制脚本内容]

我：好的，我来帮你生成测试用例。

首先，请告诉我：
1. 测试用例目录在哪里？（完整路径）
2. 是否有现有的测试项目结构？

2. 要求生成测试用例时 ⭐ 主要触发场景

触发词:

"帮我生成测试用例"
"把这个录制脚本转成测试用例"
"根据录制脚本生成代码"
"生成 Minium 测试代码"
"生成页面对象和测试用例"

响应流程:

你：帮我生成测试用例
[粘贴录制脚本内容]

我：好的，我来帮你生成测试用例。

首先，请告诉我：
1. 测试用例目录在哪里？（完整路径）
2. 是否有现有的测试项目结构？

3. 要求验证测试用例时

触发词:

"验证一下测试用例是否完整"
"检查有没有漏掉步骤"
"验证步骤是否一致"
"看看有没有漏掉什么步骤"

示例:

你：帮我验证一下这个测试用例有没有漏掉步骤
录制脚本：<你的录制脚本目录>\xxx.py
测试用例：<你的项目目录>\testcase\xxx\test_xxx.py

我：好的，我来对比验证...

4. 要求解析录制脚本时

触发词:

"解析这个录制脚本"
"提取录制脚本的步骤"
"生成步骤清单"
"看看有多少步"

示例:

你：帮我解析这个录制脚本，看看有多少步
[从你的录制脚本目录找到 Python 文件，复制内容粘贴]

我：好的，我来运行 parse_steps.py 解析...

🛠️ 技能工具

parse_steps.py

功能: 解析录制脚本，生成步骤清单

用法:

python <技能包路径>/scripts/parse_steps.py \
    --input <录制脚本路径> \
    --output <输出路径>

示例:

python scripts/parse_steps.py \
    --input recorded_script.py \
    --output steps_checklist.md

generate_pages.py

功能: 生成页面对象和测试用例

用法:

python <技能包路径>/scripts/generate_pages.py \
    --input <录制脚本路径> \
    --output <测试用例输出目录> \
    --pages <页面类目录>

示例:

python scripts/generate_pages.py \
    --input recorded_script.py \
    --output testcase/xxx/ \
    --pages pages/pages/

validate_steps.py

功能: 验证测试用例是否漏掉步骤

用法:

python <技能包路径>/scripts/validate_steps.py \
    --input <录制脚本路径> \
    --test <测试用例路径> \
    --report <验证报告路径>

检查项:

步骤数量是否一致
相邻步骤是否使用了相同的元素
特殊逻辑是否保留
页面跳转是否都有等待

📋 工作流程

阶段 1: 解析录制脚本

# 1. 运行解析脚本
python scripts/parse_steps.py \
    --input recorded_script.py \
    --output steps_checklist.md

# 2. 查看生成的步骤清单
cat steps_checklist.md

输出:

普通步骤列表
特殊逻辑步骤列表（带⚠️标记）
循环步骤列表（带🔄标记）
步骤对照表模板

阶段 2: 生成测试用例

# 运行生成脚本
python scripts/generate_pages.py \
    --input recorded_script.py \
    --output testcase/xxx/ \
    --pages pages/pages/

输出:

页面对象类（追加到已有文件）
测试用例（新建文件）
步骤对照表

阶段 3: 验证

# 运行验证工具
python scripts/validate_steps.py \
    --input recorded_script.py \
    --test testcase/xxx/test_xxx.py \
    --report validation_report.md

输出:

步骤数量验证
相邻步骤检查
特殊逻辑检查
页面跳转等待检查

⚠️ 质量控制

核心原则

不漏掉任何步骤 - 录制脚本的每一步都要在测试用例中有对应
不简化特殊逻辑 - 三层判断、else 判断必须完整保留
不混淆相邻步骤 - 相邻步骤的元素 XPath 必须不同
页面跳转必须等待 - 每个页面跳转后都要添加 wait_for_page_success()

检查清单

在生成测试用例后，必须检查：

步骤数量是否与录制脚本一致？
特殊逻辑步骤是否保留完整？
相邻步骤的元素是否不同？
页面跳转后是否都添加了等待？
是否运行了 validate_steps.py 验证？

📖 参考文档

文档	说明
core-skills/避免漏掉步骤.md	核心技能：如何避免漏掉步骤
docs/代码生成质量控制流程.md	完整的质量控制流程
docs/代码审查清单.md	提交前必须逐项检查
docs/代码规范.md	代码规范详细说明

🧪 使用示例

示例 1: 用户提供录制文件

你:

我给你一个录制文件，帮我生成测试用例

[从你的录制脚本目录找到 Python 文件，复制内容粘贴]

我:

好的，我来使用 minium-test-generator 技能为你生成测试用例。

第 1 步：解析录制脚本...
python scripts/parse_steps.py --input recorded_script.py --output steps_checklist.md

第 2 步：生成测试用例...
python scripts/generate_pages.py --input recorded_script.py --output testcase/xxx/ --pages pages/pages/

第 3 步：验证步骤完整性...
python scripts/validate_steps.py --input recorded_script.py --test testcase/xxx/test_xxx.py --report validation_report.md

✅ 生成完成！测试用例已保存到 testcase/xxx/test_xxx.py
验证报告：validation_report.md

示例 2: 验证测试用例

你:

帮我验证一下这个测试用例有没有漏掉步骤
录制脚本：<你的录制脚本目录>\recorded_script.py
测试用例：<你的项目目录>\testcase\xxx\test_xxx.py

我:

好的，我来运行 validate_steps.py 验证...

python scripts/validate_steps.py \
    --input <你的录制脚本目录>\recorded_script.py \
    --test <你的项目目录>\testcase\xxx\test_xxx.py \
    --report validation_report.md

验证结果:
✅ 所有步骤都已转换（X 步，一个不漏）
✅ 相邻步骤元素检查通过
✅ 特殊逻辑检查通过
✅ 页面跳转等待检查通过

📊 技能统计

指标	数值
支持的文件格式	Minium 录制脚本 (.py)
生成的文件格式	Python 测试用例 (.py)
验证检查项	4 项
支持的特殊逻辑	三层判断、else 判断、循环、页面跳转
典型录制脚本路径	`<你的录制脚本目录>\[场景名称]\[时间戳]\`

🚀 快速开始

# 1. 查看技能文档
cat <技能包路径>/README.md

# 2. 学习核心技能
cat <技能包路径>/core-skills/避免漏掉步骤.md

# 3. 使用工具
python <技能包路径>/scripts/parse_steps.py --help

最后更新：2026-03-23

minium-test-generator

Install

Minium 测试用例生成器

📖 描述

⚡ 核心规则（必须遵守！）

🚨 第一条：必须先确认目录，再生成！

🚨 第二条：已存在目录 → 先阅读现有代码结构！

🚨 第三条：同一个页面 → 只需追加方法，不要新建文件！

🚨 第四条：根据页面路径选择 testcase 目录！

🚨 第五条：先阅读用户代码，再决定使用什么方法！

⚡ 工作流程

场景 A：新建项目（目录不存在）

场景 B：添加到现有目录（目录已存在）

📋 目录检查方法

📝 完整对话示例

示例 1：新建项目

示例 2：添加到现有目录

⚡ 快速触发

📁 录制脚本获取方式

🎯 触发条件

1. 用户提供录制文件时 ⭐ 主要触发场景

2. 要求生成测试用例时 ⭐ 主要触发场景

3. 要求验证测试用例时

4. 要求解析录制脚本时

🛠️ 技能工具

parse_steps.py

generate_pages.py

validate_steps.py

📋 工作流程

阶段 1: 解析录制脚本

阶段 2: 生成测试用例

阶段 3: 验证

⚠️ 质量控制

核心原则

检查清单

📖 参考文档

🧪 使用示例

示例 1: 用户提供录制文件

示例 2: 验证测试用例

📊 技能统计

🚀 快速开始

Related skills