Back to Details

bootstrap-ios

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Bootstrap iOS

Bootstrap iOS

Use this as the single entry point before touching an Apple-platform app. It is a router skill: discover the project, load only the references needed for the current job, verify that build/test tools exist, then act.
The default posture is conservative:
  • Build and test before judging code.
  • Prefer modern Swift, SwiftUI, Observation, Swift Concurrency, Swift Testing, SwiftData, and current Xcode APIs.
  • Avoid deprecated APIs unless the deployment target requires them.
  • Use XcodeBuildMCP or an agent-friendly build script instead of raw, unfiltered 
    xcodebuild
    output when possible.
  • Load focused skill packs on demand. Do not dump every Swift rule into context.
将此作为接触苹果平台应用前的唯一入口。 它是一个路由型技能：识别项目，仅加载当前任务所需的参考资料，验证构建/测试工具是否存在，然后执行操作。
默认原则如下：
  • 在评估代码前先完成构建和测试。
  • 优先使用现代Swift、SwiftUI、Observation、Swift Concurrency、Swift Testing、SwiftData以及当前Xcode API。
  • 除非部署目标要求，否则避免使用已弃用的API。
  • 尽可能使用XcodeBuildMCP或对Agent友好的构建脚本，而非原始、未过滤的
    xcodebuild
    输出。
  • 根据需求加载针对性技能包，不要将所有Swift规则都导入上下文。

First move

第一步操作

  1. Detect surfaces: iOS, iPadOS, macOS, mixed web/native, SwiftPM, Xcode project/workspace, Tuist, XcodeGen, CocoaPods, or buildable folders.
  2. Read references/workflow.md.
  3. If the task involves setup or machine bootstrap, read references/install-and-bootstrap.md.
  4. If the task involves building, running, simulator, tests, or debugging, read references/xcodebuildmcp.md.
  5. Pick only the external skill packs relevant to the current task from references/skill-map.md.
  1. 检测项目类型：iOS、iPadOS、macOS、混合Web/原生、SwiftPM、Xcode项目/工作区、Tuist、XcodeGen、CocoaPods或可构建文件夹。
  2. 阅读references/workflow.md。
  3. 如果任务涉及环境搭建或机器初始化，请阅读references/install-and-bootstrap.md。
  4. 如果任务涉及构建、运行、模拟器、测试或调试，请阅读references/xcodebuildmcp.md。
  5. 从references/skill-map.md中仅选择与当前任务相关的外部技能包。

Mode picker

模式选择器

User asks for...Load
"Bootstrap iOS", "install my iOS skills", "one command"
install-and-bootstrap.md
Build, test, simulator, logs, debug, device install
xcodebuildmcp.md
SwiftUI screen, navigation, sheets, app wiring
skill-map.md
SwiftUI entries
Animation, motion, "make it feel alive", loaders, delightAlso use 
swiftui-animation-match
(interaction-to-animation matcher)
Async/await, actors, Sendable, Swift 6 migration
skill-map.md
concurrency entries
Unit tests, Swift Testing, XCTest migration
skill-map.md
testing entries
SwiftData, models, queries, migrations, CloudKit
skill-map.md
SwiftData entries
Core Data stack, fetches, background contexts
skill-map.md
Core Data entries
Slow builds, compiler time, project settingsSwiftLee Xcode Build Optimization in 
skill-map.md
Architecture/rules loader/advanced Swift disciplineMerowing rules in 
skill-map.md
App Intents, Siri, Shortcuts, widgetsOfficial Build iOS Apps plugin notes in 
skill-map.md
QA this iOS appAlso use 
running-bug-review-board
and its iOS simulator playbook
用户需求...加载内容
"Bootstrap iOS"、"安装我的iOS技能"、"一键操作"
install-and-bootstrap.md
构建、测试、模拟器、日志、调试、设备安装
xcodebuildmcp.md
SwiftUI界面、导航、弹窗、应用架构
skill-map.md
中的SwiftUI条目
动画、动效、"让界面更生动"、加载器、交互优化同时使用
swiftui-animation-match
（交互-动画匹配工具）
Async/await、actors、Sendable、Swift 6迁移
skill-map.md
中的并发相关条目
单元测试、Swift Testing、XCTest迁移
skill-map.md
中的测试相关条目
SwiftData、数据模型、查询、迁移、CloudKit
skill-map.md
中的SwiftData条目
Core Data栈、数据查询、后台上下文
skill-map.md
中的Core Data条目
构建缓慢、编译耗时、项目设置
skill-map.md
中的SwiftLee Xcode构建优化内容
架构/规则加载/高级Swift规范
skill-map.md
中的Merowing规则
App Intents、Siri、快捷指令、小组件
skill-map.md
中的官方Build iOS Apps插件说明
对iOS应用进行QA测试同时使用
running-bug-review-board
及其iOS模拟器操作手册

When installing external skills

安装外部技能时的注意事项

Do not silently modify the user's machine. If the user asks to install or bootstrap, explain what will be installed, then use the helper script in dry-run first:
bash
bash scripts/bootstrap-ios-skills.sh --dry-run --agent cursor
After the user confirms, run without 
--dry-run
. The helper is idempotent and keeps optional/non-GitHub sources as instructions instead of pretending it can install them. After a real install it verifies every expected skill actually landed and is complete (every 
references/
, 
scripts/
, and 
assets/
file cited by each 
SKILL.md
exists on disk) and fails loudly with reinstall instructions if any skill is missing entirely or installed shallow. See references/install-and-bootstrap.md.
请勿静默修改用户的机器。如果用户要求安装或初始化，请先说明将要安装的内容，然后先以试运行模式运行辅助脚本：
bash
bash scripts/bootstrap-ios-skills.sh --dry-run --agent cursor
用户确认后，去掉
--dry-run
参数运行正式脚本。该辅助脚本具有幂等性，对于可选/非GitHub来源的内容仅提供安装说明，而非直接安装。正式安装完成后，会验证每个预期技能是否已完整部署（每个
SKILL.md
中引用的
references/
、
scripts/
和
assets/
文件是否都已存在于磁盘上），如果任何技能完全缺失或安装不完整，会明确报错并提供重新安装说明。详情请见references/install-and-bootstrap.md。

Verification

验证环节

Before reporting an Apple-platform task done:
  • Confirm the scheme/project/workspace you used.
  • Run the smallest meaningful build or test command.
  • Capture build errors from clean output, not raw wall-of-text logs.
  • If using XcodeBuildMCP, name the tool/command used.
  • If build/test is blocked by signing, missing simulator, or missing Xcode, report the blocker with the exact next command to fix it.
  • For UI work, run in Simulator when feasible and capture enough evidence for the next agent to verify.
在报告苹果平台任务完成前：
  • 确认所使用的scheme/项目/工作区。
  • 运行最小规模的有效构建或测试命令。
  • 从清晰的输出中捕获构建错误，而非冗长的原始日志。
  • 如果使用XcodeBuildMCP，请注明所使用的工具/命令。
  • 如果构建/测试被签名问题、缺失模拟器或缺失Xcode所阻碍，请报告具体障碍并提供修复所需的准确下一步命令。
  • 对于UI相关工作，尽可能在Simulator中运行，并收集足够的证据以便后续Agent进行验证。

Sources

资料来源

This skill synthesizes Paul Solt's X article "Install These Skills Before Codex Touches Your Xcode Project", the linked community skill repos, official OpenAI plugin references, Merowing rules, AppCreator notes, and getsentry/XcodeBuildMCP. See references/sources.md.
本技能整合了Paul Solt在X平台发布的文章《让Codex接触你的Xcode项目前先安装这些技能》、相关社区技能仓库、官方OpenAI插件参考资料、Merowing规则、AppCreator笔记以及getsentry/XcodeBuildMCP。详情请见references/sources.md。