mcpField
B
bootstrap-ios

bootstrap-ios

github.com/rayfernando1337开发129208 次安装14 周前更新
代码仓库

关于 bootstrap-ios

这项路由 skill 面向处理 Apple 平台应用的 Agent，帮助发现项目结构、选择相关参考资料与 skill 包、检查构建工具，并按审慎流程进行构建和测试。

主要功能

  1. 01识别 Apple 项目结构
  2. 02按任务加载参考资料
  3. 03选择相关 skill 包
  4. 04检查构建和测试工具
  5. 05指导构建与测试检查

适用场景

  1. 01开始处理陌生的 iOS 项目
  2. 02为 SwiftUI 任务选择参考资料
  3. 03准备 iOS 开发环境
  4. 04通过构建或测试验证更改

MCP 相关

该 skill 建议在可用时使用 XcodeBuildMCP 处理构建、测试、模拟器和调试任务。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/rayfernando1337/rayfernando-skills --skill bootstrap-ios

安装后在 Claude Code 中输入/bootstrap-ios确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
install-and-bootstrap.md
skill-map.md
sources.md
workflow.md
xcodebuildmcp.md
scripts/
bootstrap-ios-skills.sh

详细介绍

Bootstrap iOS

在接触 Apple 平台应用前，将此作为唯一入口。 这是一个路由技能：发现项目，只加载当前任务所需的参考资料，确认构建／测试工具可用，然后开始操作。

默认采取保守策略：

  • 先构建和测试，再评判代码。
  • 优先使用现代 Swift、SwiftUI、Observation、Swift Concurrency、Swift Testing、SwiftData 和当前的 Xcode API。
  • 除非部署目标要求，否则避免使用已弃用的 API。
  • 尽可能使用 XcodeBuildMCP 或适用于 Agent 的构建脚本，而不是直接输出未经筛选的 xcodebuild 结果。
  • 按需加载专门的技能包。不要把所有 Swift 规则都塞进上下文。

第一步

  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 中仅挑选与当前任务相关的外部技能包。

模式选择

用户请求加载
“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、模型、查询、迁移、CloudKitskill-map.md 中的 SwiftData 条目
Core Data 堆栈、提取、后台上下文skill-map.md 中的 Core Data 条目
构建缓慢、编译耗时、项目设置skill-map.md 中的 SwiftLee Xcode Build Optimization
架构／规则加载器／高级 Swift 规范skill-map.md 中的 Merowing 规则
App Intents、Siri、Shortcuts、小组件skill-map.md 中的 Official Build iOS Apps 插件说明
对此 iOS 应用进行 QA同时使用 running-bug-review-board 及其 iOS 模拟器操作手册

安装外部技能时

不要在未告知的情况下修改用户的机器。如果用户要求安装或进行引导，先说明将安装哪些内容，然后先使用辅助脚本进行试运行：

bash scripts/bootstrap-ios-skills.sh --dry-run --agent cursor

获得用户确认后，再不带 --dry-run 运行。该辅助脚本可安全重复运行，并会将可选／非 GitHub 来源保留为说明，而不会假装能够安装这些来源。实际安装后，脚本会验证每项预期技能是否确实已安装且完整（每个 SKILL.md 引用的 references/、scripts/ 和 assets/ 文件都必须存在于磁盘上）；如果有技能完全缺失或安装不完整，则会明确报错并提供重新安装说明。参见 references/install-and-bootstrap.md。

验证

在报告 Apple 平台任务已完成前：

  • 确认所用的 scheme／项目／工作区。
  • 运行最小但有意义的构建或测试命令。
  • 从干净的输出中获取构建错误，不要使用冗长杂乱的原始日志。
  • 如果使用 XcodeBuildMCP，说明所用工具／命令。
  • 如果因签名、模拟器缺失或 Xcode 缺失而无法构建／测试，报告阻碍，并给出解除阻碍所需的确切下一条命令。
  • 对于 UI 工作，条件允许时在 Simulator 中运行，并收集足够的证据，方便下一个 Agent 验证。

来源

此技能综合了 Paul Solt 的 X 文章《在 Codex 接触你的 Xcode 项目前，先安装这些技能》、相关社区技能仓库、OpenAI 官方插件参考资料、Merowing 规则、AppCreator 笔记以及 getsentry/XcodeBuildMCP。 请参阅 references/sources.md。

评论

支持 Markdown