用途：在 macOS 上安装移动开发工具链，即占用磁盘大、受许可证限制、环境变量繁琐的部分。开始前先询问要 iOS、Android 还是两者，只处理所选轨道。
不适用场景：仅需 Xcode Command Line Tools 用 macos-system-prep；Swift/Kotlin/Flutter 代码或 UI 问题属项目工作；App Store/Play 发布与 fastlane CI 属发布工程；后端容器用 docker-on-mac，服务器通用 JDK 用 language-runtimes。
安全约束：先做磁盘检查，完整 Xcode 需约 40–50 GB 空闲，Android Studio + SDK + AVD 另需约 15 GB，用 df -h / 检查并提前警告。sudo xcodebuild -license accept 与 xcode-select -s 属特权操作，需先征得同意。所选轨道之外不安装任何内容。
iOS 轨道：安装完整 Xcode（App Store 或 xcodes，如 brew install xcodesorg/made/xcodes && xcodes install --latest），装到 /Applications。安装 Xcode 不会自动指向工具链，需执行 sudo xcode-select -s /Applications/Xcode.app/Contents/Developer、sudo xcodebuild -license accept、sudo xcodebuild -runFirstLaunch、xcodebuild -downloadPlatform iOS。验证用 xcodebuild -version、xcrun simctl list devices。Apple 开发者账号需手动登录。常见故障是 macOS 升级后指针重置为 CLT，用上述 xcode-select -s 修复。
Android 轨道：brew install --cask android-studio，首次向导下载 SDK 到 ~/Library/Android/sdk。将 ANDROID_HOME 与 PATH 持久写入 ~/.zshrc（ANDROID_SDK_ROOT 已弃用）。许可证用 sdkmanager --licenses 交互式接受。JDK 通常无需安装，命令行 Gradle 需 JDK 17+。模拟器创建 arm64-v8a 系统镜像的 AVD。验证 adb --version、emulator -list-avds。
跨平台框架（按需）：React Native 默认用 Expo，手动环境需 Node ≥ 22、watchman、iOS 与 Android 轨道及 CocoaPods；Flutter 需两条轨道，用 flutter doctor 检查。
验证：运行 sh "${CLAUDE_SKILL_DIR}/scripts/check.sh"。完成标准为仅所选轨道、iOS 可构建并启动模拟器、Android 的 adb 与 ANDROID_HOME 就绪且许可证已接受、框架 doctor 通过或如实报告剩余失败。注意 Xcode 下载巨大、每次 macOS 大版本升级后需复查 xcode-select -p、模拟器会占用磁盘。