minium-test-generator

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

Security Scan

The skill is internally consistent with its stated purpose (parsing Minium recorded scripts and generating page objects/tests); it requests no credentials and has no install step, but it will read and write the user's project files and includes runnable Python scripts — review before executing and confirm file paths before generation.

Purpose & Capability

Name/description match the included artifacts: Python scripts for parsing (parse_steps.py), validation (validate_steps.py) and generation (generate_pages.py), documentation and examples. The required capabilities (reading a recording file, inspecting a project directory, generating page/test files) align with the declared purpose. Minor inconsistencies: SKILL.md header version (11.0.0) differs from registry version (1.0.0) and some docs disagree on selector priority (most files prefer CSS→XPath, docs/项目基础规范.md lists XPath→CSS). These are quality issues, not indicators of malicious intent.

Instruction Scope

The SKILL.md explicitly instructs the agent to ask the user for a full path, check whether the directory exists, read existing project files, and (with user confirmation) create new files or append to existing ones. It also includes shell/PowerShell examples for checking paths (Test-Path) and suggests the user paste recording script content into the conversation. These behaviors are expected for a generator that integrates with a user's local project but are sensitive operations (reading arbitrary project files and writing to disk). The skill's guidance includes explicit confirmation steps before creating or modifying files, which mitigates risk. Also note some code in generate_pages.py is stubbed (pass) — the generator may be incomplete and may require running the provided scripts locally.

Install Mechanism

No install specification is present (instruction-only with bundled scripts). That is low-risk: nothing is pulled from the network or installed automatically. The package contains Python scripts which the user or agent can run; review those scripts before execution. No remote download URLs or archive extraction were found.

Credentials

The skill declares no environment variables, no credentials, and no config paths. All required operations (file parsing, generation, local checks) can be performed without secrets. The scripts expect certain project files to exist (base/basedef.py, base/basepage.py) which is justified by the stated purpose.

Persistence & Privilege

always: false; the skill is user-invocable and does not request permanent inclusion or modify other skills. It reads and writes files in a user-specified project path only after explicit confirmation per its own workflow. Autonomous invocation is allowed by default on the platform but does not combine with other red flags here.

Assessment

This skill appears to do what it says: parse Minium recording scripts and generate page objects and test files. Before installing or running it, consider the following: - Review the bundled Python scripts locally (scripts/generate_pages.py, scripts/parse_steps.py, scripts/validate_steps.py) to ensure you understand what will be read and written. The code is local and there is no automatic network install, but you should still inspect it. Some generator functions are stubs/partial and the tool may need manual completion. - The skill will ask for a full filesystem path and (per its instructions) will read your project directory structure and existing page/test files; be cautious about granting an automated agent filesystem access. Prefer to run the provided scripts yourself in a controlled environment (local machine or sandbox) rather than letting an autonomous agent execute shell commands on your system. - Do not paste sensitive secrets or private configuration into the chat when sharing recording scripts; recording scripts can include business-specific selectors or flows. If the recording contains sensitive data, redact it before sharing. - The SKILL.md mandates that the agent must ask for confirmation before creating or modifying files — keep that behavior and do not allow silent overwrites. Back up your project before running generation. - There are minor documentation inconsistencies (selector priority differs between documents, SKILL.md version mismatch). Verify generated code follows your project's real conventions (basedef/basepage names and selector priority) and run validate_steps.py and your test suite on a branch/VM before merging. If you want to proceed: run the scripts locally with your own Python interpreter and inspect the outputs, or let the agent operate only after you explicitly confirm the exact target directory and review the file list it will create/modify.

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 目录！

用例存放目录规则：

1. 分析录制脚本中的页面路径

   • 查看 URL 中的路径结构，如：
     • /pro/pages/homepage/group-homepage/... → 包含 homepage
     • /pro/pages/home/leaders-management/... → 包含 home
     • /pro/pages/seq-publish/... → 包含 seq-publish

2. 检查现有 testcase 目录结构

   • 列出 testcase/ 下的子目录
   • 对比页面路径中的关键词，选择最匹配的目录
   • 例如：页面路径包含 home → 找 testcase/home_page/ 或 testcase/home/

3. 没有合适的目录时

   • 根据页面路径中的关键词创建新目录
   • 例如：页面路径是 /pro/pages/seq-publish/... → 创建 testcase/seq_publish/

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

---

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

Page Object 核心规则：

1. 先阅读用户的基类代码（如 basedef.py）

   • 检查用户是否封装了点击、输入等方法
   • 如果有封装 → 使用用户的封装方法
   • 如果没有封装 → 生成封装方法并使用

2. 检查用户的封装方式

   • 点击方法：可能是 tap(), click(), click_element() 等
   • 输入方法：可能是 send_key(), input_text(), type() 等
   • 滚动方法：可能是 scroll_to(), scroll() 等

3. 元素定位策略

   • 第一选择：CSS selector（如 view.btn-know.button）
   • 用户反馈找不到元素时 → 补充 xpath
   • 还找不到时 → 补充 text 匹配
   • 不要一开始就生成一堆备用方案！

4. 元素定位与操作分离

   • 元素常量：使用中文注释说明用途
   • 每个元素都必须有对应的操作方法
   • 禁止只有元素定义没有方法

5. 方法命名规范

   • 动词开头：click_xxx, input_xxx, select_xxx
   • 语义清晰：方法名能清楚表达操作意图

6. 不要返回 self（除非需要链式调用）

   • 大部分方法不需要返回 self
   • 只有需要连续调用时才返回

7. 不要照搬录制脚本的等待时间！

   • 录制脚本中的 self.page.wait_for(x) 是录制工具自动生成的
   • 用户的基类方法（如 tap(), send_key()）内部已有等待逻辑
   • 禁止生成多余的 sleep() 或 wait_for()
   • 除非用户明确要求添加等待

8. 不需要生成 .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 框架
• 生成第一个测试用例

---

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

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

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

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

📁 [用户提供的路径]/
├── 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      # 新增测试脚本

⚠️ 不会覆盖已有文件

确认开始创建吗？

你：确认

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

[输出新增文件内容]

---

⚡ 快速触发

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

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

示例:

你：我给你一个录制文件，帮我生成测试用例
[从你的录制脚本目录找到 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. 步骤数量是否一致
2. 相邻步骤是否使用了相同的元素
3. 特殊逻辑是否保留
4. 页面跳转是否都有等待

---

📋 工作流程

阶段 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

输出:

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

---

⚠️ 质量控制

核心原则

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