CA
agent-device
Автоматизирует тестирование приложений iOS, tvOS, macOS, Android и Amazon Vega OS в виртуальных устройствах. Полезно для навигации, создания скриншотов, управления пультом, ввода текста, прокрутки, извлечения UI-данных и планирования команд agent-device CLI.
Что делает навык
Навык автоматизирует тестирование приложений iOS, tvOS, macOS, Android и Amazon Vega OS в виртуальных устройствах. Он позволяет управлять интерфейсом, вводить данные, делать скриншоты и извлекать UI-данные через CLI-интерфейс agent-device.
Когда применять
- Навигация по экранам и взаимодействие с элементами приложения (клики, ввод текста, прокрутка).
- Создание скриншотов и извлечение данных из пользовательского интерфейса.
- Управление пультом дистанционного управления для устройств TV и macOS.
- Автоматизация рутинных сценариев тестирования на разных платформах.
Как работает
- Запустить приложение командой agent-device open <app> --foreground, чтобы получить начальный снимок интерфейса с @refs.
- Выполнять действия (press, click, fill, scroll, back) с параметром --settle, анализируя выводимую разницу (diff) между состояниями.
- Для поиска элементов использовать актуальные @refs или селекторы (id, label, role); координаты применять только как крайнюю меру.
- При отсутствии нужного элемента в diff использовать scroll down --until <selector> для прокрутки до цели, избегая циклических проверок.
- Если снимок интерфейса неполный (sparse/AX-unavailable), сделать скриншот, использовать координаты и повторить snapshot -i после навигации.
- Завершить сессию командой agent-device close; использовать help только при неясности команд или специфичных задачах.
Примеры запросов агенту
Открой приложение Calculator в переднем плане и сделай скриншот.
Введи текст 'Hello' в поле поиска и нажми Enter, используя refs из снимка.
Прокрути список вниз до элемента с текстом 'Settings' и сделай клик по нему.
Что понадобится
- Установленный CLI инструмент agent-device.
- Доступ к виртуальным устройствам iOS, tvOS, macOS, Android или Amazon Vega OS.
- Понимание структуры @refs и селекторов UI-элементов.
Описание составлено по SKILL.md навыка, сверено 07.10.2026.
Как подключить
1Скачать навык
# возьмите папку навыка «agent-device» из репозитория:
# https://github.com/callstack/agent-device
2Положить папку с
SKILL.md к навыкам ассистента# положите папку навыка туда, где ассистент ищет skills:
cp -r agent-device/ ~/.claude/skills/agent-device/
Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.