用途：在用户报告 Xcode 构建失败、构建错误或环境问题时，按“环境优先”的思路诊断与修复，核心假设是多数看似神秘的问题来自陈旧 Derived Data、卡住的模拟器或残留构建进程，而非代码缺陷。
主要能力：先执行强制检查——确认当前目录存在 .xcodeproj 或 .xcworkspace、用 pgrep -lx xcodebuild 盘点同名进程、查看 Derived Data 体积、用 xcrun simctl list devices -j 检查是否有 Booting/Shutting Down 状态的模拟器；再按决策树归类问题，如 SPM 的“No such module”、本地模块缺失、包解析失败、间歇性失败、旧代码执行、测试无改动却失败、模拟器无法启动等，并给出对应处理流程。还包含 CI/CD 环境识别（检查 CI、GITHUB_ACTIONS、JENKINS_URL、GITLAB_CI 等变量）及相应调整，例如跳过模拟器检查、关注 SPM 缓存与版本不匹配。
使用方式：诊断和重建命令需按原文执行，例如 xcodebuild clean -scheme <ACTUAL_SCHEME_NAME>、xcodebuild -resolvePackageDependencies、xcrun simctl shutdown/erase <AFFECTED_UDID>，重建与测试通过 axbuild 包裹并以 resultBundlePath 保存证据，配合 pgrep 在每次调用前盘点进程。
限制：资料强调删除与终止须限定在受影响项目或设备并获得授权，不得使用 rm -rf ~/Library/Developer/Xcode/DerivedData/* 或 killall xcodebuild；缓存体积大本身不证明损坏；axbuild 在 Cursor 与 MCP 分发中不提供，需回退到保存日志；部分细节（如具体安装路径、完整平台支持范围）暂未提供。