Przejdź do treści
Biblioteka skilli
Programowanie · Testowanie

device-use

/device-use

Obsługuje symulatory iOS i emulatory Androida: tworzy urządzenie, instaluje aplikację, steruje dotykiem według ekranu i po zadaniu usuwa to, co sam utworzył.

Repozytorium
ondra ↗
Licencja
MIT
Ostatnia zmiana repozytorium
14.11.2026

Ocena i bezpieczeństwo

95/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść30 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 14.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Obsługuje symulatory iOS i emulatory Androida: tworzy urządzenie, instaluje aplikację, steruje dotykiem według ekranu i po zadaniu usuwa to, co sam utworzył.

Oryginalny opis (EN)

Drive iOS simulators and Android emulators for a job: make your own device, install and open the app, tap / type / swipe by what's on screen, capture proof, then shut down and delete what you made. Use when a task says simulator, emulator, iPhone, Android, 앱 화면, 시뮬레이터, 에뮬레이터, or needs the mobile app checked. The user watches and can drive the same device in the app's 디바이스 hub.

Jak działa

  1. 1. Your own device, never someone else's
  2. 2. Drive it by meaning, not by pixels
  3. 3. Proof
  4. 4. Clean up
Sekcje z nagłówków SKILL.md, w oryginale · 77 linii, 499 słów
Podgląd SKILL.md
---
name: device-use
description: >
  Drive iOS simulators and Android emulators for a job: make your own device,
  install and open the app, tap / type / swipe by what's on screen, capture proof,
  then shut down and delete what you made. Use when a task says simulator,
  emulator, iPhone, Android, 앱 화면, 시뮬레이터, 에뮬레이터, or needs the mobile app
  checked. The user watches and can drive the same device in the app's 디바이스 hub.
metadata:
  ondra-tools: 'device'
  ondra-commands: '\b(xcrun simctl|adb|idb|maestro)\b'
---

# Device use

Prefer the `device` tool (start → do → look → stop): it does all of this for you
and keeps the job on its own device (an Android one is a fresh copy of an AVD,
with no app data or logins from anywhere else). **Call `stop` before your final answer**,
every time, unless the user asked to keep the device: a device left running
holds memory and CPU on the user's Mac. Use the commands below only if that tool is missing.

Tools: `xcrun simctl` (iOS), `adb` and `emulator` from `~/Library/Android/sdk`
(Android), and `agent-device` (taps, typing, accessibility snapshots on both).
If `agent-device` is missing: `npm i -g agent-device`.

## 1. Your own device, never someone else's

Each of the user's spaces is a separate workspace with its own
devices. Booted devices may belong to another space, to other jobs or to the
user. Don't control, shut down or delete a device you didn't make. The devices
this job's space has are in `$ONDRA_DEVICES_ALLOWED` (ids, names, serials); the
app refuses commands that name any other device, `booted`, `all`, or `adb`
without `-s`.

```bash
# iOS: a fresh simulator named after this job
UDID=$(xcrun simctl create "ondra-$APP_WORKER_ID" "iPhone 17")
xcrun simctl boot "$UDID" && xcrun simctl bootstatus "$UDID" -b
# Android: boot an AVD of this space ($ONDRA_DEVICES_ALLOWED) that nobody runs
"$ANDROID_HOME/emulator/emulator" -avd <name> -no-snapshot-save -no-window -gpu auto-no-window -no-audio -no-boot-anim &   # no window: the user sees it in Ondra's device hub; auto-no-window draws on the GPU, not the CPU
~/Library/Android/sdk/platform-tools/adb wait-for-device
```

If `$APP_WORKER_ID` is empty, use a short name for the task (`ondra-login-check`).

## 2. Drive it by meaning, not by pixels

Use one agent-device session per job, named like the device:

```bash
S=ondra-$APP_WORKER_ID
agent-device open com.example.app --platform ios --udid "$UDID" --session $S   # or --platform android --serial emulator-5554
agent-device snapshot -i --session $S          # what's on screen, with @refs
agent-device press @e12 --settle --session $S  # tap by ref
agent-device fill @e7 "test@example.com" --settle --session $S
agent-device scroll down --settle --session $S
agent-device back --settle --session $S
```

Coordinates (`press <x> <y>`, in points) only when the snapshot has no target.
After each action read the diff it returns; snapshot again only when needed.
Install builds with `xcrun simctl install "$UDID" <App.app>` or `adb -s <serial> install -r <apk>`.

## 3. Proof

Save screenshots in `$APP_ARTIFACTS_DIR` and point to them:

```bash
xcrun simctl io "$UDID" screenshot --type=png "$APP_ARTIFACTS_DIR/login-ok.png"
adb -s emulator-5554 exec-out screencap -p > "$APP_ARTIFACTS_DIR/login-ok.png"
```

Then `{"type":"shot","path":"…","caption":"로그인 뒤 홈 화면"}` and the same path as
`{"kind":"shot","ref":"…"}` in the done evidence. The app checks the file exists
and isn't empty.

## 4. Clean up

When the job is done (or handed off with nothing left to check on the device):

```bash
agent-device close --session $S
xcrun simctl shutdown "$UDID" && xcrun simctl delete "$UDID"
adb -s emulator-5554 emu kill            # Android emulator you started
```

Leave a device running only if the user asked to keep it, and say so in the
summary.

Wersje

W bazie nie ma innych skilli o nazwie device-use.

Migawka bazy z 13.11.2026 · wersja paczki c9c957f6cd2e (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100phonedock
    Steruje emulatorami Androida, symulatorami iOS i telefonami przez narzędzia MCP, by budować, testować i robić zrzuty ekranu aplikacji mobilnych.
  • 95dorker
    Obsługuje bezgłowe emulatory Androida: uruchamia aplikację, robi zrzuty, prowadzi testy UI i konfiguruje CI.
  • 100test-mobile
    Prowadzi aplikację mobilną na symulatorze iOS lub emulatorze Android i zbiera dowody działania przez agent-device.
  • 90ios-simulator
    Steruje symulatorem iOS bez interfejsu: instaluje i uruchamia aplikację, klika przez warstwę dostępności AXe i robi zrzuty.
  • 100mobile-test
    Testuje aplikacje Android i iOS na prawdziwym urządzeniu lub emulatorze przez adb: instaluje buildy, zbiera zrzuty i logi oraz przygotowuje listy kontrolne.
  • 100tizen-device-manager
    Wyświetla podłączone urządzenia Tizen przez sdb i wyłącza uruchomione emulatory, nie analizując problemów z aplikacją.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.