Agent Skills › aresbit/MateBot › harmonyos-test-cases

harmonyos-test-cases

GitHub

HarmonyOS UI自动化测试技能，支持用例存储、执行与保存。通过文本/ID定位元素实现屏幕适配，管理JSON格式用例并验证应用功能，适用于运行、创建及列出测试流程。

skills/harmonyos-skills/skills/harmonyos-test-cases/SKILL.md aresbit/MateBot

Trigger Scenarios

运行测试执行测试用例验证XX功能把这个测试流程保存下来

Install

npx skills add aresbit/MateBot --skill harmonyos-test-cases -g -y

More Options

Non-standard path

npx skills add https://github.com/aresbit/MateBot/tree/master/skills/harmonyos-skills/skills/harmonyos-test-cases -g -y

Use without installing

npx skills use aresbit/MateBot@harmonyos-test-cases

指定 Agent (Claude Code)

npx skills add aresbit/MateBot --skill harmonyos-test-cases -a claude-code -g -y

安装 repo 全部 skill

npx skills add aresbit/MateBot --all -g -y

预览 repo 内 skill

npx skills add aresbit/MateBot --list

SKILL.md

Frontmatter

{
    "name": "harmonyos-test-cases",
    "description": "HarmonyOS UI 自动化测试用例管理和执行技能。用于存储、管理和执行 UI 测试用例，验证应用功能是否正常。支持通过组件文本\/ID定位元素，自动适配不同屏幕尺寸。使用场景：(1) 执行已保存的测试用例 (2) 保存新的测试用例 (3) 列出所有测试用例 (4) 用户说\"运行测试\"、\"执行测试用例\"、\"验证XX功能\"、\"把这个测试流程保存下来\"。"
}

HarmonyOS 测试用例管理

功能概述

存储测试用例: JSON 格式保存测试步骤和预期结果
执行测试用例: 自动化执行 UI 操作并验证结果
屏幕适配: 通过组件文本/ID 定位，而非固定坐标
易于扩展: 添加新测试用例只需创建 JSON 文件

快速开始

列出所有测试用例

python3 $SKILL_DIR/scripts/run_test.py --list

执行测试用例

python3 $SKILL_DIR/scripts/run_test.py photos_favorite

# 多设备场景建议显式指定
python3 $SKILL_DIR/scripts/run_test.py photos_favorite --device 127.0.0.1:5555

# 失败即停，便于快速定位
python3 $SKILL_DIR/scripts/run_test.py photos_favorite --fail-fast

保存当前操作为测试用例

当用户教你一步步执行完一个测试流程后，可以说"把这个测试用例保存下来"，我会：

将操作步骤转换为 JSON 格式
使用组件文本/ID 定位（非固定坐标）
保存到 testcases/ 目录

测试用例格式

{
  "id": "test_id",
  "name": "测试名称",
  "description": "测试描述",
  "app": "com.example.app",
  "tags": ["标签1", "标签2"],
  "steps": [
    {
      "step": 1,
      "action": "click",
      "description": "点击按钮",
      "params": {
        "locator": {
          "type": "text",
          "value": "确定"
        }
      },
      "expected": "应该跳转到下一页"
    }
  ],
  "teardown_steps": []
}

支持的操作类型

action	说明	params
`launch_app`	启动应用	`locator` - 应用图标定位
`click`	点击	`locator` - 组件定位
`wait`	等待	`duration` - 秒数
`key_event`	按键	`value` - Back/Home 等
`swipe`	滑动	`coords` 或 `start_locator`/`end_locator`
`verify`	验证	`locator` - 要验证的组件
`capture_count`	记录组件数量基线	`key` + `locator`
`verify_count_delta`	验证数量变化	`key` + `locator` + `allowed_deltas`