关于 argent-ios-device-setup
这是使用 Argent 操作实体 iPhone 的设置技能，涵盖设备连接、首次安装、签名和常见故障处理，面向准备自动化设备的人员；模拟器设置由另一技能负责。
主要功能
- 01准备并连接实体 iPhone
- 02启用开发者模式
- 03构建、签名并启动运行器
- 04信任并保留 Argent Runner 应用
- 05排查签名和构建故障
适用场景
- 01为 Argent 自动化设置 iPhone
- 02处理首次运行的信任和签名提示
- 03修复运行器或构建错误
MCP 相关
输入介绍了 Argent 设置流程和工具，但未说明 MCP 行为。
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/argent-ios-device-setup确认已加载。
详细介绍
iPhone 真机设置
仅在使用实体 iPhone 时阅读此内容。模拟器请使用 argent-ios-simulator-setup。
首次运行
- 连接手机、解锁手机并保持屏幕常亮，然后开启开发者模式（设置 > 隐私与安全性 > 开发者模式）。
list-devices必须显示设备状态为connected。 launch-app只会注册应用。首次调用describe、手势或screenshot时，才会构建、签名并启动设备端运行器：首次冷启动需要几分钟，使用缓存或重启工具服务器后需要几十秒。构建上限为 15 min，运行器就绪时间为 120 s。- 首次安装时，手机会要求信任开发者（设置 > 通用 > VPN 与设备管理），主屏幕上还会出现一个 Argent Runner 应用。请告知用户，这是 argent 的自动化运行器，必须保持安装状态。
签名与故障
签名无需配置。工具服务器进程首次调用时会显示提示，注明所选团队以及 ARGENT_IOS_TEAM_ID 覆盖值（工具服务器环境；更改后会强制冷构建）。连接线、锁定、信任、配置描述文件过期和缺少证书等错误都会说明如何修复：按提示处理，然后重试同一调用。此外，遇到 errSecInternalComponent 时，运行 security set-key-partition-list -S apple-tool:,apple:,codesign: -s ~/Library/Keychains/login.keychain-db（系统会要求输入用户登录密码），然后重试。遇到 team has no devices 时，保持手机连接并重试。Bundle id 注册失败表示免费团队的应用 ID 数量已达上限，请等待几天或使用付费团队签名。其他任何 xcodebuild 故障都会输出原始 error: 行：请查看 ~/.argent/ios-device-runner/logs/runner-<udid8>.log。遇到 RUNNER_WEDGED 时，对该 udid 运行 stop-simulator-server，然后重试。
然后阅读 argent-ios-device-interact。