uiai Android Test

自然言語でテストシナリオを記述し、ADBコマンドでAndroidアプリのUIテストを自動実行するスキル。

特徴

•自然言語シナリオ - リソースID不要、日本語でアクションを記述
•自動要素特定 - UIツリーから自動的にタップ位置を判定
•Vision検証 - Claude Visionで期待結果を自然言語で検証
•厳格モード - UIツリーのテキスト完全一致で厳密に検証可能

シナリオ形式

yaml

name: "拠点切り替えテスト"
app:
  android: "com.example.app"
  ios: "com.example.App"

steps:
  - id: "起動"
    actions:
      - do: "アプリを起動"
      - then: "ホーム画面が表示されていること"

  - id: "拠点切り替え"
    actions:
      - do: "メニューをタップ"
      - do: "「拠点切り替え」を選択"
      - then: "「拠点一覧から選択」画面が開いていること"

  - id: "拠点選択"
    actions:
      - do: "「東京本社」をタップ"
      - then: "拠点が「東京本社」に変更されていること"
        strict: true   # この検証のみ完全一致

使用方法

bash

# テスト実行
/uiai-android-test scenarios=test/scenarios/login.yaml

# 複数シナリオ
/uiai-android-test scenarios=test/scenarios/*.yaml

# デバイス指定
/uiai-android-test scenarios=test/scenarios/login.yaml device=emulator-5554

# 厳格モード（全ステップで完全一致検証）
/uiai-android-test scenarios=test/scenarios/login.yaml strict=true

Execution Requirement (MUST)

各シナリオは必ずTaskツールでサブエージェントとして実行すること。

code

for each scenario_file:
  1. Task tool → adb-test-runner (実行)
  2. Task tool → adb-test-evaluator (評価)

Agent	Purpose
`adb-test-runner`	シナリオ実行、エビデンス収集
`adb-test-evaluator`	結果評価、レポート生成

複数シナリオがある場合、各シナリオを独立したTaskとして実行する。これにより：

•コンテキスト分離（シナリオ間の状態汚染を防止）
•エラー隔離（1シナリオの失敗が他に影響しない）
•並列実行可能（独立したシナリオは同時実行可）

詳細は execution-flow.md を参照。

ステップの書き方

アクション（do）

種類	例
タップ	`「ログイン」ボタンをタップ`、`メニューを選択`
入力	`メールアドレス欄に「test@example.com」を入力`
スクロール	`下にスクロール`、`「Item 50」が見えるまでスクロール`
戻る	`戻るボタンを押す`、`ホームに戻る`
待機	`3秒待つ`
アプリ	`アプリを起動`、`アプリを再起動`

検証（then）

種類	例
画面	`ホーム画面が表示されていること`
要素	`「東京本社」と表示されていること`
状態	`チェックボックスがONになっていること`
否定	`エラーメッセージが表示されていないこと`

厳格モード（strict）

通常はVision APIで「意味的に」検証するが、strict: true を指定するとUIツリーのテキスト完全一致で検証する。

yaml

# シナリオ全体に適用
config:
  strict: true

# または do/then 個別に適用
steps:
  - id: "拠点確認"
    actions:
      - do: "メニューを開く"
        strict: true  # このdoのみ厳格に要素特定
      - then: "「東京本社」と表示されていること"
        strict: true  # このthenのみ完全一致検証

モード	検証方法	用途
通常（デフォルト）	Vision API	画面全体の雰囲気、複雑なUI
厳格	UIツリー完全一致	正確な文字列表示の確認

strictの優先順位: 個別指定 > config.strict > false（デフォルト）

セクションID（id）

テストをグループ化するための識別子。各セクションは actions リストを持つ：

yaml

steps:
  - id: "ログイン"
    actions:
      - do: "..."
      - then: "..."

  - id: "データ確認"
    actions:
      - do: "..."
      - then: "..."

リプレイ（replay）

過去のセクションの do アクションを再実行する。then はスキップされる。

yaml

steps:
  - id: "ログイン"
    actions:
      - do: "アプリを起動"
      - do: "ログインボタンをタップ"
      - then: "ホーム画面が表示されていること"

  - id: "リプレイ確認"
    replay:
      from: "ログイン"
      to: "ログイン"    # 単一セクションの場合は同じID
    actions:
      - then: "再実行後も正常に動作すること"

フィールド	説明
`from`	開始セクションのID
`to`	終了セクションのID（`from`と同じなら単一セクション）

注意: リプレイ先に replay がある場合は再帰的に実行される。

内部処理

•UIツリー取得 - adb shell uiautomator dump で画面要素を取得
•
要素特定 - 自然言語の説明からUI要素を自動特定
- •テキスト一致: 「ログイン」→ text="ログイン" の要素
- •content-desc一致: 「メニュー」→ 説明に "menu" を含む要素
•座標計算 - 要素の bounds から中心座標を算出
•コマンド実行 - adb shell input tap x y 等を実行
•検証 - スクリーンショット + Vision APIで期待結果を確認

出力

code

.adb-test/
└── results/
    └── <timestamp>/
        ├── summary.md           # 全体サマリー
        └── <scenario-name>/
            ├── report.md        # テストレポート
            ├── result.json      # 結果JSON
            ├── step_01.png      # スクリーンショット
            └── step_01_ui.xml   # UIツリー

前提条件

•ADBがインストールされていること
•Androidデバイス/エミュレータが接続されていること
•USBデバッグが有効であること

uiai-android-test

uiai Android Test

特徴

シナリオ形式

使用方法

Execution Requirement (MUST)

ステップの書き方

アクション（do）

検証（then）

厳格モード（strict）

セクションID（id）

リプレイ（replay）

内部処理

出力

前提条件

関連エージェント

リファレンス