用途:用于处理 iOS/macOS 的构建、环境与 Xcode 相关问题。要求在任何构建、环境或 Xcode 问题出现时,先使用本技能排查,再调试应用代码。
主要能力:按问题类型路由到专项技能或代理——环境优先问题(BUILD FAILED、模拟器无法启动、zombie xcodebuild、陈旧构建等)走 xcode-debugging;构建慢走 build-performance;SPM 依赖冲突走 spm-conflict-resolver;CocoaPods 等依赖问题走 build-debugging;安全与隐私审计走 security-privacy-scanner;iOS 17→18 现代化走 modernization-helper;构建自动修复走 build-fixer;构建优化走 build-optimizer;TestFlight 崩溃与反馈走 testflight-triage;App Store Connect 导航走 app-store-connect-ref;崩溃日志分析走 crash-analyzer;MetricKit 参考走 metrickit-ref;卡顿诊断走 hang-diagnostics;实时调试走 lldb;代码签名走 code-signing / code-signing-diag;运行期控制台输出走 xclog-ref 或 /axiom:console。
使用方式:在 Claude Code 或 Codex 中先解析实际加载包下的 bin/axbuild,或在 Pi 中从 PATH 发现可执行文件,检查执行权限并以绝对路径运行 --help,将观测到的路径赋给 AXBUILD。示例命令保留原样: "$AXBUILD" xcodebuild -scheme "$SCHEME" -destination "$DESTINATION" build "$AXBUILD" swift test --package-path "$PACKAGE" 每次调用 Xcode 前运行 pgrep -lx xcodebuild; echo "pgrep exit=$?" 检查现有构建。需 Bash 的代理(构建、测试、模拟器、崩溃符号化)仅限 Claude Code。Cursor 与 MCP 分发不捆绑 axbuild,无 axbuild MCP 包装,可用保存日志回退方案。
适用场景:构建失败、测试崩溃或挂起、模拟器问题、Xcode 异常、依赖冲突、构建性能、环境问题、崩溃日志、签名错误等。
限制与注意:本技能针对环境谜题而非代码错误;Swift 并发错误、SwiftData 迁移、类型不匹配等应走对应路由或直接修代码。默认 JSON 限制为 8,000 UTF-8 字节,需查看 artifacts.report 获取完整记录。失败测试计数为 null 表示不确定而非零。不要在未确认归属前终止进程。具体支持平台、安装与更多细节暂未提供。