AIKraft/Skills/agent-device

agent-device

Автоматизирует тестирование приложений iOS, tvOS, macOS, Android и Amazon Vega OS в виртуальных устройствах. Полезно для навигации, создания скриншотов, управления пультом, ввода текста, прокрутки, извлечения UI-данных и планирования команд agent-device CLI.

CACallstack official Разработка ★ 4.9k

Что делает навык

Навык автоматизирует тестирование приложений iOS, tvOS, macOS, Android и Amazon Vega OS в виртуальных устройствах. Он позволяет управлять интерфейсом, вводить данные, делать скриншоты и извлекать UI-данные через CLI-интерфейс agent-device.

Когда применять

  • Навигация по экранам и взаимодействие с элементами приложения (клики, ввод текста, прокрутка).
  • Создание скриншотов и извлечение данных из пользовательского интерфейса.
  • Управление пультом дистанционного управления для устройств TV и macOS.
  • Автоматизация рутинных сценариев тестирования на разных платформах.

Как работает

  1. Запустить приложение командой agent-device open <app> --foreground, чтобы получить начальный снимок интерфейса с @refs.
  2. Выполнять действия (press, click, fill, scroll, back) с параметром --settle, анализируя выводимую разницу (diff) между состояниями.
  3. Для поиска элементов использовать актуальные @refs или селекторы (id, label, role); координаты применять только как крайнюю меру.
  4. При отсутствии нужного элемента в diff использовать scroll down --until <selector> для прокрутки до цели, избегая циклических проверок.
  5. Если снимок интерфейса неполный (sparse/AX-unavailable), сделать скриншот, использовать координаты и повторить snapshot -i после навигации.
  6. Завершить сессию командой 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 и совместимые) подхватывает его по описанию и следует шагам.