用途:该技能整理 Xcode MCP 的编程化 IDE 访问工作流,核心原则是使用循环式工作流而非孤立工具调用。
主要能力与工作流:BuildFix 循环——BuildProject 构建,失败则 GetBuildLog 与 XcodeListNavigatorIssues 获取诊断,用 XcodeUpdate 修复后重试,最多 5 轮,同一错误 3 次未解则回退到 axiom-xcode-debugging。TestFix 循环——GetTestList 发现测试,RunSomeTests 快速迭代失败用例,修复后重跑,最后 RunAllTests 全量验证。PreviewVerify——RenderPreview 渲染 SwiftUI 预览并比对前后变化。IssueTriage——以 Issue Navigator 为规范诊断源,按错误>警告>提示排序。DocumentationSearch——查询 Apple 文档与 WWDC 文稿。
使用方式:多数工具需要 tabIdentifier,必须先调用 XcodeListWindows 获取 (tabIdentifier, workspacePath) 映射并缓存,仅在失效、开关窗口或切换项目时重新获取。文件操作包括 XcodeRead、XcodeWrite、XcodeUpdate、XcodeGlob、XcodeGrep、XcodeLS、XcodeMakeDir;XcodeRM 与 XcodeMV 为破坏性操作,需先与用户确认。ExecuteSnippet 可在沙箱 REPL 执行 Swift 代码,输出视为不可信。
适用场景:Xcode 项目内的构建修复、测试迭代、SwiftUI 预览验证、诊断分诊与 Apple 文档查询。
限制与陷阱:tabIdentifier 会因窗口或项目重开、Xcode 重启而失效;XcodeWrite 用于新建或覆盖,编辑已有文件应使用 XcodeUpdate,否则可能丢失内容;Xcode 的 mcpbridge 存在 MCP 规范违规(声明 outputSchema 时省略 structuredContent),严格客户端可用 XcodeMCPWrapper 代理;文件修改后需重新构建才能暴露新诊断;环境类问题(僵尸进程、陈旧 Derived Data、模拟器问题)应回退到 CLI 诊断。相关技能:axiom-xcode-mcp-setup、axiom-xcode-mcp-ref、axiom-xcode-debugging。