argent-ios-device-setup — скилл для Claude Code: как установить
Инструкция для агента по подготовке физического iPhone, подключённого кабелем к Mac, для автоматизации argent. Пригодится при отладке тестов на реальном устройстве.
npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-codeЧто делает argent-ios-device-setup
Скилл инструктирует агента, как развернуть тестовый раннер Argent Runner на реальном iPhone с кабельным подключением. Для симуляторов он категорически не подходит: там используется отдельное правило argent-ios-simulator-setup. Перед стартом на телефоне нужно включить режим разработчика в настройках приватности и оставить экран разблокированным, пока утилита list-devices не подтвердит подключение со статусом connected.
Команда launch-app только регистрирует целевую программу. Первое обращение к describe, screenshot или жестам запускает компиляцию и подпись нативного раннера. Холодная сборка ограничена лимитом в 15 минут, а готовность самого раннера проверяется за 120 секунд. На экране телефона появится приложение Argent Runner, чей сертификат разработчика нужно вручную подтвердить в настройках профилей iOS.
Подпись через бесплатный аккаунт Apple может быстро упереться в лимит App ID, из-за чего регистрация идентификатора падает. При системной ошибке errSecInternalComponent скилл даёт точную команду сброса прав через security set-key-partition-list. Детальные логи сборки xcodebuild агент читает напрямую из каталога ~/.argent/ios-device-runner/logs/.
Какие задачи решает
- подготовить физический iPhone к UI-автоматизации через argent
- устранить ошибку подписи
errSecInternalComponentв Keychain - развернуть тестовый Argent Runner на реальном устройстве
- разобрать сбои сборки xcodebuild по локальным логам runner
Примеры запросов агенту
- Подключи мой iPhone по кабелю и подготовь окружение argent для тестов
- Проверь статус физического iOS-устройства и собери Argent Runner
- Разбери ошибку подписи xcodebuild при запуске раннера на телефоне
Как установить argent-ios-device-setup
1Через Skills CLI (Vercel)
npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code2Вручную: положить файлы
~/.claude/skills/argent-ios-device-setup/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/argent-ios-device-setup/
1Через Skills CLI (Vercel)
npx skills add software-mansion/argent --skill argent-ios-device-setup -a codex2Вручную: положить файлы
.agents/skills/argent-ios-device-setup/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add software-mansion/argent --skill argent-ios-device-setup -a cursor2Вручную: положить файлы
.cursor/skills/argent-ios-device-setup/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install software-mansion/argent argent-ios-device-setup2Вручную: положить файлы
.github/skills/argent-ios-device-setup/SKILL.md1Через Skills CLI (Vercel)
npx skills add software-mansion/argent --skill argent-ios-device-setup -a gemini-cli2Командой платформы
gemini skills install https://github.com/software-mansion/argent --path packages/skills/skills/argent-ios-device-setupВручную: положить файлы
.devin/skills/argent-ios-device-setup/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add software-mansion/argent --skill argent-ios-device-setup -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
Из того же набора15
Весь набор →Похожие
Вопросы о argent-ios-device-setup
Как установить argent-ios-device-setup в Claude Code?
Выполните в терминале команду npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code.
Что делает скилл argent-ios-device-setup?
Он даёт модели инструкцию по подготовке кабельного iPhone, включению режима разработчика, компиляции Argent Runner и решению типичных ошибок подписи кода.
Подходит ли этот скилл для iOS Simulator?
Нет, скилл рассчитан только на физические устройства с типом device. Для симуляторов argent использует отдельный скилл argent-ios-simulator-setup.
Исходный текст
SKILL.md · Apache-2.0
--- name: argent-ios-device-setup description: Set up a cabled physical iPhone for argent. Use when a physical iPhone is involved (a list-devices iOS entry with kind "device") and ONLY then; never for a simulator. --- # Physical iPhone setup Read this only for a physical iPhone. Simulators use `argent-ios-simulator-setup`. ## First run 1. Cable the phone, unlock it, keep the screen awake, and turn on Developer Mode (Settings > Privacy & Security > Developer Mode). `list-devices` must show it `connected`. 2. `launch-app` only registers the app. The first `describe`, gesture or `screenshot` builds, signs and starts the on-device runner: minutes cold, tens of seconds from cache or after a tool-server restart. Build cap 15 min, runner ready 120 s. 3. On the first install the phone asks to trust the developer (Settings > General > VPN & Device Management), and an **Argent Runner** app appears on the home screen. Tell the user it is argent's automation runner and must stay installed. ## Signing and failures Signing needs no configuration. The first phone call of a tool-server process carries a note naming the team picked and the `ARGENT_IOS_TEAM_ID` override (tool-server environment; a change forces a cold rebuild). Cable, lock, trust, expired-profile and missing-certificate errors name their fix: apply it, retry the same call. Also: `errSecInternalComponent`: run `security set-key-partition-list -S apple-tool:,apple:,codesign: -s ~/Library/Keychains/login.keychain-db` (asks the user's login password), retry. `team has no devices`: keep the phone cabled, retry. Bundle id registration failed: free-team app-id cap, wait days or sign under a paid team. Any other xcodebuild failure prints raw `error:` lines: read `~/.argent/ios-device-runner/logs/runner-<udid8>.log`. `RUNNER_WEDGED`: `stop-simulator-server` for the udid, retry. Then read `argent-ios-device-interact`.
© software-mansion · Apache-2.0 · software-mansion/argent