用途:面向 iOS 与 Apple 平台项目的开发工作流,覆盖构建、测试、SwiftUI 预览、应用与设备日志、LLDB 调试、模拟器与设备交互以及项目管理等操作。
入口与用法:入口为 python3 <skill-dir>/scripts/xcode.py,其中 <skill-dir> 是包含该 SKILL.md 的目录。可用命令包括:list,列出所选 Xcode 安装中的全部工具名;describe TOOL [TOOL ...],输出完整描述与输入输出 schema(含前置条件),多个名称共用一次目录获取,每个契约以 JSON 行给出;call TOOL --args-file /absolute/args.json,从 JSON 对象文件读取参数执行工具并返回结果,无参数工具用 {};call --help,提供超时与图像输出选项,--output-file 可保存原始响应(含失败结果)。
使用要点:工具名只是导航提示,完整契约才说明其能力、范围与执行要求。已在上下文中的目录与契约可服务同一 Xcode 安装与连接的后续请求,但两者变化会使信息过期。依赖工作区的调用前,先在 XcodeListWorkspaces 中匹配目标项目路径并使用返回的标识符;用 XcodeOpenWorkspace 打开项目时也应使用该调用返回的标识符。会话键指向已有的执行状态。工具契约描述资源生命周期与副作用,只释放本任务创建的资源。结果可能包含应用状态、错误以及日志或图像路径,范围超出调用的退出状态。CLI 与部分工具各有独立超时;CLI 超时会使工具是否完成、变更结果是否生效变得不确定。运行时设置涵盖首次配置、替换预注册的 MCP,以及运行时或授权问题。设备交互需遵循 Device interaction,获取所选 Xcode 的上游技能并委派验证。具体平台支持、价格与限制:暂未提供。