AgentSkillsCN

uiai-scenario-check

具备对Scenario YAML文件进行模式校验、修正建议与自动修正的能力。

SKILL.md
--- frontmatter
name: uiai-scenario-check
description: シナリオYAMLファイルのスキーマ検証・修正提案・自動修正を行うスキル。
argument-hint: "scenarios=<path> [fix=true] [dry-run=true] [strict=true]"
arguments:
  - name: scenarios
    description: 検証対象YAMLファイル（glob対応）
    required: true
    placeholder: "sample/*.yaml"
  - name: fix
    description: 自動修正を実行
    required: false
    default: "false"
  - name: dry-run
    description: 修正内容表示のみ（fix=true時に有効）
    required: false
    default: "false"
  - name: strict
    description: 警告もエラー扱い
    required: false
    default: "false"
references:
  - path: ./references/validation-rules.md
  - path: ./references/auto-fix-rules.md
  - path: ./references/output-format.md
  - path: ../uiai-android-test/references/scenario-schema.md

uiai Scenario Check

シナリオYAMLファイルをスキーマに基づいて検証し、エラーや警告を検出、自動修正を提案するスキル。

特徴

  • •スキーマ検証 - 必須フィールド、型、形式の検証
  • •参照整合性 - replay.from/to の存在・順序・循環参照チェック
  • •自動修正 - 修正可能なエラーの自動修正
  • •ドライラン - 修正内容の事前確認

使用方法

bash
# 基本検証
/uiai-scenario-check scenarios=test/scenarios/login.yaml

# 複数ファイル（glob対応）
/uiai-scenario-check scenarios=test/scenarios/*.yaml

# 自動修正
/uiai-scenario-check scenarios=test/scenarios/*.yaml fix=true

# ドライラン（修正内容表示のみ）
/uiai-scenario-check scenarios=test/scenarios/*.yaml fix=true dry-run=true

# 厳格モード（警告もエラー扱い）
/uiai-scenario-check scenarios=test/scenarios/*.yaml strict=true

パラメータ

パラメータ必須デフォルト説明
scenariosYes-検証対象YAMLファイル（glob対応）
fixNofalse自動修正を実行
dry-runNofalse修正内容表示のみ（fix=true時）
strictNofalse警告もエラー扱い

検証ルール概要

エラー（修正必須）

ID項目自動修正
E001name 必須不可
E002app 必須不可
E003steps 必須不可
E004steps 非空不可
E005id 必須可
E006actions 必須不可
E010app 形式不正不可
E011id 重複可
E012do/then 混在可
E013wait 型不正可
E014strict 型不正可
E020replay.from 不存在不可
E021replay.to 不存在不可
E022replay 順序不正不可
E023replay 循環参照不可

警告（推奨）

ID項目自動修正
W001空 actions不可
W002then なし不可
W003連続 then不可
W004config 未知キー可

実行フロー

  1. •ファイル読み込み - glob パターンでファイルを展開
  2. •YAML パース - 構文エラーをチェック
  3. •スキーマ検証 - 各ルールで検証
  4. •結果出力 - エラー/警告をレポート
  5. •自動修正（fix=true時）- 修正可能項目を修正

出力

検証結果は以下の形式で出力される：

code
## シナリオ検証結果

### login.yaml

| ID | レベル | 行 | 内容 |
|----|--------|-----|------|
| E005 | ERROR | 8 | `id` が指定されていません |
| W002 | WARN | 8-12 | セクションに `then` がありません |

**エラー: 1, 警告: 1**

関連スキル

  • •uiai-android-test - 検証済みシナリオでテストを実行

リファレンス