neonwatty/apple-agent-kit/ios-physical-device

iOS Physical Device

Use this skill for physical iPhone automation.

Hard Boundary

Do not install apps, start WDA, launch host apps, or take screenshots without explicit user approval for the target device and adapter.

Preflight

Check:

• Xcode version
• xcrun devicectl availability
• device visibility
• device lock/readiness state
• signing keychain and identity availability
• Automation Mode readiness
• privacy policy in the adapter

Pattern

1. Resolve the device by adapter-provided name.
2. Fail fast if the device is locked or not launch-ready.
3. Start with readiness mode: verify Xcode, devicectl, approved-device resolution, lock state, and Automation Mode without install, launch, WDA/Appium, screenshots, or UI tests.
4. Build with explicit destination and derived data path only after readiness receipts are repeatable.
5. Verify the built bundle identifier before installing.
6. Install or test only the expected app when the private approval covers that action.
7. Capture artifacts according to the privacy policy.
8. Emit and validate an ios-physical-device/v1 receipt.

Use prepare-ios-physical-device and validate-ios-physical-device-receipt when the repo uses Apple Agent Kit. The public output should name only a sanitized device alias, command classes, pass/fail status, hashes, counts, and withheld evidence reasons.

Automation Mode

If Xcode times out while enabling Automation Mode, retry only within the adapter-configured limit and surface a clear operator action. Do not loop indefinitely.