agent-device は何をしますか？
このスキルはルーターとして使用し、必須のデフォルト設定に従ってください。最初にこのファイルを読んでください。通常のデバイスタスクでは、必ず references/bootstrap-install.md と references/exploration.md をロードしてから行動してください。bootstrap を使用して決定論的なセットアップを確認または確立し、アプリセッションが開いたら exploration を UI の検査、操作、および検証に使用します。
デフォルトの動作ルール
- 控えめに開始する。UI を変更する前に、読み取り専用の検査を優先する。
- 画面上に現在表示されているテキストや構造を確認するタスクでは、通常の
snapshotを使用する。 - 要求されたアクションや特定のクエリのために
@e3のようなインタラクティブな参照が必要な場合にのみsnapshot -iを使用する。 - 推測による変更は避ける。検査を進めるため、または要求されたタスクを完了するために必要な、最小限の元に戻せる UI 操作（ポップアップの消去、アラートのクローズ、意図しない画面のクリアなど）のみ実行してもよい。
- ユーザーから明示的に依頼されない限り、ウェブの閲覧や外部ソースの使用は行わない。
- 意味のある UI 変更後は、古い参照を使い回さずに再度スナップショットを取得する。
- 生の座標よりも
@refまたはセレクタによるターゲット指定を優先する。 - 操作を開始する前に、正しいターゲットがピン留めされ、アプリセッションが開いていることを確認する。
- ループを短く保つ:
open-> 検査/操作 -> 必要に応じて検証 ->close。
デフォルトフロー
- 通常のデバイスタスクを実行する前に、references/bootstrap-install.md と references/exploration.md をロードする。
- 最初に bootstrap を使用して、正しいターゲット、アプリのインストール、アプリセッションのオープンを確認または確立する。
- アプリセッションが開いて安定したら、exploration を検査、操作、検証に使用する。
- 表示内容を読み取りまたは確認する目的の場合は、最初に通常の
snapshotを使用する。 - インタラクティブな探索や要求されたアクションのために参照が必要な場合にのみ
snapshot -iにエスカレーションする。 - UI を変更する前に、読み取り専用のコマンドで質問に答えられる場合は
get、is、またはfindを使用する。 - 必要に応じて証拠をキャプチャして終了し、
closeする。
QA モード
- 報告を伴う自由形式のバグハント: ../dogfood/SKILL.md を使用する。
- 合格/不合格の QA（受け入れ基準に基づく）: このスキル内にとどまり、references/bootstrap-install.md から開始し、references/exploration.md の QA ループを使用する。
必須の参照
- すべての通常のデバイスタスクでは、このファイルを読んだ後、まず references/bootstrap-install.md をロードし、次に references/exploration.md をロードしてから行動する。
- bootstrap を使用して、特にサンドボックス環境やクラウド環境において、決定論的なセットアップを確認または確立する。
- アプリセッションが開いて安定したら exploration を使用する。
- そのスコープが必要な場合にのみ、追加の参照をロードする。
決定ルール
- テキストが表示されているかどうかを確認する必要がある場合は、通常の
snapshotを使用する。 - 主にインタラクティブな探索と参照の選択には
snapshot -iを使用する。 - UI の状態を変更せずに質問に答えられる場合は、
get、is、またはfindを使用する。 - テキストを置き換えるには
fillを使用する。 - テキストを追加するには
typeを使用する。 - タスクが「戻る」ことを要求する場合、予測可能なアプリ所有のナビゲーションには通常の
backを使用し、プラットフォームの戻るジェスチャーやボタンセマンティクスにはback --systemを予約する。 - 入力が速すぎると文字が欠落するデバウンス付き検索フィールドには、
type --delay-msまたはfill --delay-msを使用する。 - シミュレータがない、アプリがインストールされていない、またはアプリセッションがまだ開いていない場合は、セットアップ手順を即興で行う代わりに
bootstrap-install.mdに切り替える。 - 一時的な UI が検査を妨げる場合は、最初に最小限の解除アクションを使用する。ただし、ユーザーがその操作を要求した場合を除き、UI にデータを表示させるためだけにナビゲーション、検索、新しいテキストの入力を行ってはならない。
- ユーザーが要求した場合を除き、画面上のデータの欠落を補うために外部参照を使用してはならない。
- 必要な情報が画面上に表示されていない場合は、追加のナビゲーション、テキスト入力、またはウェブ検索で補う代わりに、その旨を明確に伝える。
- 生の座標よりも
@refまたはセレクタによるターゲット指定を優先する。
追加の参照
- ログ、ネットワーク、アラート、権限、障害トリアージが必要な場合: references/debugging.md
- スクリーンショット、差分、録画、リプレイメンテナンス、パフォーマンスデータが必要な場合: references/verification.md
- デスクトップサーフェス、メニューバーの動作、macOS 固有の操作ルールが必要な場合: references/macos-desktop.md
- リモート HTTP トランスポート、
--remote-configによる起動、リモート macOS ホスト上のテナントリースが必要な場合: references/remote-tenancy.md