Agent Skills › software-mansion/argent › argent-ios-device-setup

argent-ios-device-setup

GitHub

指导配置实体 iPhone 进行自动化测试，涵盖连接、开发者模式开启、首次运行构建签名及故障排查。

packages/skills/skills/argent-ios-device-setup/SKILL.md software-mansion/argent

触发场景

用户请求设置物理 iPhone 设备 iOS 自动化测试中涉及真机环境初始化

安装

npx skills add software-mansion/argent --skill argent-ios-device-setup -g -y

更多选项

非标准路径

npx skills add https://github.com/software-mansion/argent/tree/main/packages/skills/skills/argent-ios-device-setup -g -y

不安装直接使用

npx skills use software-mansion/argent@argent-ios-device-setup

指定 Agent (Claude Code)

npx skills add software-mansion/argent --skill argent-ios-device-setup -a claude-code -g -y

安装 repo 全部 skill

npx skills add software-mansion/argent --all -g -y

预览 repo 内 skill

npx skills add software-mansion/argent --list

SKILL.md

Frontmatter

{
    "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

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.
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.
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 call on a phone names the team it picked; ARGENT_IOS_TEAM_ID in the tool-server environment overrides it. Errors name their fix (cable, lock, trust, signing, a stuck runner): apply it and retry the same call. A failed build quotes xcodebuild's own error: lines.

Then read argent-ios-device-interact.