AIKraft/Skills/argent-ios-device-interact

argent-ios-device-interact

Управляет физическим iPhone через argent. Используйте, когда требуется взаимодействие с реальным устройством (kind "device"), а не симулятором. При проблемах с кабелем, доверием или подписью обратитесь к argent-ios-device-setup.

software-mansion official Разработка ★ 3k

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

Навык обеспечивает взаимодействие с физическим iPhone через инструмент argent, отличаясь от работы с симулятором ограничениями и спецификой управления. Он позволяет запускать приложения, делать снимки экрана, выполнять жесты и вводить текст, но не поддерживает сложные системные операции вроде записи экрана или отладки.

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

  • Автоматизация действий в реальном приложении на iPhone, когда требуется доступ к устройству, а не эмулятору.
  • Взаимодействие с интерфейсом через жесты (тапы, свайпы, кастомные формы) и клавиатуру.
  • Контроль состояния экрана: ожидание загрузки элементов, сравнение снимков экрана или ожидание простоя.
  • Управление состоянием приложения: запуск, перезапуск, переустановка или открытие ссылок по bundleId.

Как работает

  1. Использовать только разрешенные инструменты: list-devices, launch-app, restart-app, reinstall-app, open-url, describe, screenshot, screenshot-diff, gesture-tap, gesture-swipe, gesture-custom, button, keyboard, await-ui-element, await-screen-idle, run-sequence.
  2. При работе с home-кнопкой или после жестов/ввода текста делать повторный describe, так как экран может обновляться с задержкой или возвращать старый статус.
  3. Для перехода по ссылкам использовать open-url с указанием bundleId, так как прямая ссылка ведет в Safari.
  4. При необходимости масштабирования или поворота использовать собственные UI-элементы приложения (тапы и перетаскивания), так как системные жесты не поддерживаются.
  5. Изменять разрешения или отлаживать приложение вручную или через симулятор, так как эти функции недоступны на физическом устройстве через argent.

Примеры запросов агенту

Запусти приложение с bundleId com.example.app на физическом iPhone и сделай снимок экрана.
Нажми кнопку Home, подожди, пока интерфейс успокоится, и опиши текущее состояние экрана.
Выполни кастомный жест на экране и затем введи текст с помощью клавиатуры.

Что понадобится

  • Физическое устройство iPhone, подключенное через argent.
  • Установка и настройка argent-ios-device-setup при проблемах с кабелем, доверием или подписью.

Описание составлено по SKILL.md навыка, сверено 07.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «argent-ios-device-interact» из репозитория: # https://github.com/software-mansion/argent
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r argent-ios-device-interact/ ~/.claude/skills/argent-ios-device-interact/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.