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ł.
- Autor
- 3x-haust ↗
- Repozytorium
- ondra ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 14.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 14.11.2026, bez odwołań do wycofanych modeli i API.
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. Your own device, never someone else's
- 2. Drive it by meaning, not by pixels
- 3. Proof
- 4. Clean up
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ą.