bootstrap-ios 是处理 Apple 平台应用前的单一入口技能,定位为路由器:先探查项目,只加载当前任务需要的参考资料,确认构建与测试工具存在,然后再执行操作。默认原则偏保守:先构建和测试再评判代码;优先使用现代 Swift、SwiftUI、Observation、Swift Concurrency、Swift Testing、SwiftData 及当前 Xcode API;除非部署目标要求,避免已弃用 API;尽量用 XcodeBuildMCP 或对智能体友好的构建脚本,而不是原始、未过滤的 xcodebuild 输出;按需加载聚焦的技能包,不把所有 Swift 规则一次性灌入上下文。
首要步骤:检测平台(iOS、iPadOS、macOS、混合 Web/原生、SwiftPM、Xcode 工程/工作区、Tuist、XcodeGen、CocoaPods 或可构建文件夹);读取 references/workflow.md;若涉及安装或机器初始化,读取 references/install-and-bootstrap.md;若涉及构建、运行、模拟器、测试或调试,读取 references/xcodebuildmcp.md;再从 references/skill-map.md 中挑选与当前任务相关的外部技能包。
模式选择:用户说“Bootstrap iOS”“安装我的 iOS 技能”“一条命令”时加载 install-and-bootstrap.md;涉及构建、测试、模拟器、日志、调试、设备安装时用 xcodebuildmcp.md;SwiftUI 界面、导航、sheet、应用接线查 skill-map.md 的 SwiftUI 条目;动画、动效可用 swiftui-animation-match;异步、actor、Sendable、Swift 6 迁移查并发条目;单元测试、Swift Testing、XCTest 迁移查测试条目;SwiftData 建模、查询、迁移、CloudKit 与 Core Data 查对应条目;构建慢、编译时间、工程设置查 SwiftLee Xcode Build Optimization;架构与规则加载查 Merowing rules;App Intents、Siri、Shortcuts、小组件查官方 Build iOS Apps 插件说明;QA 可配合 running-bug-review-board 及其 iOS 模拟器剧本。
安装外部技能时不得静默修改用户机器。用户要求安装或初始化时,先说明将安装什么,再用辅助脚本做 dry-run:bash scripts/bootstrap-ios-skills.sh --dry-run --agent cursor,确认后再去掉 --dry-run 执行。该脚本幂等,可选或非 GitHub 来源会以说明形式保留而不会假装可安装;真实安装后会校验每个预期技能确实落地且完整(每个 SKILL.md 引用的 references/、scripts/、assets/ 文件都存在),若有技能完全缺失或安装不全则报错并给出重装说明。
验证:报告 Apple 平台任务完成前,确认所用的 scheme/工程/工作区,运行最小且有意义的构建或测试命令,从干净输出中捕获构建错误而非原文日志墙;若使用 XcodeBuildMCP,说明所用工具或命令;若构建或测试因签名、缺少模拟器或缺少 Xcode 受阻,报告阻碍并给出修复的下一步命令;UI 工作尽量在模拟器中运行并留下可供下一个智能体验证的证据。该技能综合了 Paul Solt 的 X 文章、相关社区技能仓库、官方 OpenAI 插件参考、Merowing 规则、AppCreator 笔记以及 getsentry/XcodeBuildMCP。