ios-simulator-skill

为什么要用

核心特性

xcodebuild 封装，单行构建摘要——节省大量 context
无障碍优先的模拟器导航——通过标签而非像素位置找到元素
为构建/测试/运行/模拟工作流设计的 22 个脚本
自动压缩截图，使图像 Token 易于管理
支持严重级别过滤的实时日志尾部跟踪

实时演示

实际使用效果

ios-simulator-skill.replay ▶ 就绪

0/0

安装

作者仓库 · Claude Skills 官方文档

使用场景

实战用法： ios-simulator-skill

构建、运行并截图当前流程

👤 使用 Claude Code 迭代的 iOS 开发者 ⏱ ~5 min beginner

何时使用： 修改了视图，想在不离开聊天的情况下看到实时效果。

前置条件

Xcode + 模拟器已安装 — 标准 macOS iOS 开发设置

步骤

要求 Claude 构建并运行

使用 ios-simulator-skill。为 iPhone 16 构建 MyApp 方案，启动，导航到设置，截图。✓ 已复制

→ 简洁的构建摘要，然后是截图
迭代

我调整了填充——重新构建并重新截图。✓ 已复制

→ 快速响应，最小的 Token 开销

结果： Claude Code 中紧凑的构建-迭代-查看循环。

注意事项

方案名称拼写错误导致错误信息不清晰 — 方案不匹配时，技能返回可用方案的简洁列表

搭配使用： filesystem

驱动脚本化 UI 流程进行冒烟测试

👤 iOS 开发者和 QA ⏱ ~15 min intermediate

何时使用： 想验证关键流程，而不需要编写完整的 XCUITest 框架代码。

步骤

描述流程

启动应用，点击'登录'，输入凭证，点击列表中的第一行，截图。✓ 已复制

→ Claude 使用无障碍标签驱动每一步
检查 WCAG 合规性

现在对当前屏幕运行无障碍审计。✓ 已复制

→ WCAG 发现及修复建议

结果： 一个有效的冒烟流程加上无障碍检查通过。

注意事项

当标签更改时流程中断 — 标签比坐标更稳定，但大型 UI 重构后仍需审查

重现 bug 时尾部跟踪日志

👤 追踪不稳定问题的 iOS 开发者 ⏱ ~10 min intermediate

何时使用： bug 仅在模拟器中可复现，且你想要相关日志。

步骤

使用过滤日志复现

启动应用，点击导致崩溃的流程，尾部跟踪过滤为错误+警告的日志。✓ 已复制

→ Claude 返回修剪后的日志包并突出显示可能的原因

结果： 目标日志摘录和 bug 的假设。

注意事项

如果未设置严重性过滤器，日志过于嘈杂 — 默认为错误+警告；仅在调试时升级到信息级别

组合

与其他 MCP 搭配，撬动十倍杠杆

ios-simulator-skill + filesystem

技能运行构建；文件系统读/写源代码

编辑 SettingsView.swift，然后构建并截图。✓ 已复制

ios-simulator-skill + github

从 GitHub bug 报告在模拟器中复现问题

阅读问题 #42，在模拟器中复现步骤，将截图附加到评论。✓ 已复制

工具

此 MCP 暴露的能力

工具	输入参数	何时调用
xcodebuild wrapper	scheme, destination	任何构建请求
Simulator driver (accessibility APIs)	element label/role + action	模拟器中的 UI 自动化
Screenshot capture	none (current screen)	视觉验证
Log tailing	severity filter, duration	调试运行时问题
Device lifecycle	boot/shutdown/create/reset	需要新的模拟器状态
Accessibility audit	current screen	无障碍审查

成本与限制

运行它的成本

API 配额: 无
每次调用 Token 数: 非常低——简洁构建摘要 + 压缩截图是主要设计目标
费用: 免费——技能是本地的
提示: 保持截图默认压缩；全分辨率截图会快速消耗 context。

安全

权限、密钥、影响范围

凭据存储： 技能中没有凭证。应用端密钥保留在你的构建配置中。

数据出站： 无——一切都在本地模拟器上运行

如果配置了，模拟器可以访问你的钥匙链——在自动化过程中小心处理凭证。

故障排查

常见错误与修复

'No such scheme'

方案不匹配时，技能列出可用方案；选择确切的名称。

验证： xcodebuild -list -project MyApp.xcodeproj

Accessibility label not found

向 SwiftUI 视图添加 accessibilityIdentifier——它比可见标签更稳定。

Simulator stuck booting

使用设备生命周期重置命令；然后重新启动。

验证： xcrun simctl list

替代方案