用途:本技能提供通过 Xcode MCP 以编程方式访问 IDE 的工作流模式,核心原则是使用循环式工作流而非孤立工具调用。
主要能力与工作流:
- 窗口定位:多数工具需要 tabIdentifier,须先调用 XcodeListWindows 获取 (tabIdentifier, workspacePath) 列表,匹配项目路径后缓存映射;若返回空说明 Xcode 未打开项目。
- BuildFix 循环:BuildProject → 检查 buildResult → GetBuildLog 解析错误 → XcodeListNavigatorIssues 获取规范诊断 → XcodeUpdate 修复 → 重复,最多 5 次;同一错误 3 次未解决则回退到 axiom-xcode-debugging。
- TestFix 循环:GetTestList → RunSomeTests 快速迭代 → 解析失败 → XcodeUpdate → 重复,最后 RunAllTests 验证。
- PreviewVerify:RenderPreview 渲染 SwiftUI 预览并检查图像,用于布局、深色模式、Liquid Glass 效果验证。
- IssueTriage:以 Issue Navigator 为规范诊断源,按错误>警告>提示优先级处理。
- DocumentationSearch:查询 Apple 在线文档与 WWDC 文字稿;Xcode 内置的 20 份 for-LLM 指南应改用 axiom-apple-docs。
文件操作:XcodeRead、XcodeWrite(新建)、XcodeUpdate(str_replace 式补丁)、XcodeGlob、XcodeGrep、XcodeLS、XcodeMakeDir;XcodeRM 与 XcodeMV 为破坏性操作,需用户确认。ExecuteSnippet 可在指定 Swift 文件上下文中执行代码,仅支持 Swift。
限制与注意事项:tabIdentifier 在窗口或项目重开、Xcode 重启后失效,需重新获取;XcodeWrite 会覆盖已有文件,编辑应使用 XcodeUpdate;Xcode 的 mcpbridge 存在 MCP 规范违规(声明 outputSchema 时省略 structuredContent),严格客户端可用 XcodeMCPWrapper 代理;文件修改后需重新构建以暴露新诊断。相关技能:axiom-xcode-mcp-setup、axiom-xcode-mcp-ref、axiom-xcode-debugging。