axiom-ios-build by charleswiltgen/axiom
npx skills add https://github.com/charleswiltgen/axiom --skill axiom-ios-build在调试应用程序代码之前,遇到任何构建、环境或 Xcode 相关问题,您必须使用此技能。
遇到以下情况时使用此路由器:
BUILD FAILED、编译错误、链接器错误)此路由器根据具体问题调用专门的技能:
触发条件:
BUILD FAILED 但没有明显的代码原因xcodebuild 进程为何首先使用 xcode-debugging:90% 的神秘问题源于环境,而非代码。在调试代码之前先检查此项。
调用:/skill axiom-xcode-debugging
广告位招租
在这里展示您的产品或服务
触达数万 AI 开发者,精准高效
触发条件:
调用:/skill axiom-build-performance
触发条件:
为何使用 spm-conflict-resolver:专门用于分析 Package.swift 和 Package.resolved 以诊断和解决 Swift Package Manager 冲突的代理。
调用:启动 spm-conflict-resolver 代理
触发条件:
为何使用 security-privacy-scanner:专门用于扫描安全漏洞和隐私合规性问题的代理。
调用:启动 security-privacy-scanner 代理或 /axiom:audit security
触发条件:
为何使用 modernization-helper:专门用于扫描遗留模式并提供带有代码示例的迁移路径的代理。
调用:启动 modernization-helper 代理或 /axiom:audit modernization
触发条件:
为何使用 build-fixer:在调查代码之前检查僵尸进程、Derived Data、SPM 缓存和模拟器状态的自主代理。在环境问题上可节省 30 分钟以上。
调用:启动 build-fixer 代理或 /axiom:fix-build
触发条件:
为何使用 build-optimizer:扫描 Xcode 项目以寻找构建性能优化点——缓慢的类型检查、昂贵的脚本、次优的设置——可将构建时间减少 30-50%。
调用:启动 build-optimizer 代理或 /axiom:optimize-build
触发条件:
调用:/skill axiom-build-debugging
触发条件:
为何使用 testflight-triage:用于调查 TestFlight 崩溃和审查 Beta 反馈的系统化工作流程。涵盖符号化、崩溃解释、常见模式以及 Claude 辅助分析。
调用:/skill axiom-testflight-triage
触发条件:
为何使用 app-store-connect-ref:用于导航 ASC 崩溃分析、指标仪表板和数据导出工作流程的参考。
调用:/skill axiom-app-store-connect-ref
触发条件:
为何使用 crash-analyzer:解析崩溃报告、识别模式(空指针、Swift 运行时、看门狗、jetsam)并生成可操作分析的自主代理。
调用:启动 crash-analyzer 代理或 /axiom:analyze-crash
触发条件:
为何使用 metrickit-ref:完整的 MetricKit API 参考,包含设置模式、有效负载解析以及与崩溃报告系统的集成。
调用:/skill axiom-metrickit-ref
触发条件:
为何使用 hang-diagnostics:使用决策树对挂起进行系统化诊断,区分繁忙与阻塞的主线程,选择工具(Time Profiler、System Trace),并提供 8 种常见挂起模式及其修复方法。
调用:/skill axiom-hang-diagnostics
触发条件:
为何使用 axiom-lldb:崩溃报告告诉您崩溃了什么。LLDB 告诉您为什么崩溃。
调用:/skill axiom-lldb
| 想法 | 现实 |
|---|---|
| "我知道如何修复这个链接器错误" | 链接器错误有 4 种以上的根本原因。xcode-debugging 可在 2 分钟内诊断所有原因。 |
| "让我清理构建文件夹" | 干净构建掩盖了真正的问题。xcode-debugging 能找到根本原因。 |
| "这只是个 SPM 问题,我会修复 Package.swift" | SPM 冲突会级联。spm-conflict-resolver 会分析完整的依赖关系图。 |
| "模拟器今天就是慢" | 模拟器问题表明环境损坏。xcode-debugging 会进行系统检查。 |
| "我会跳过环境检查,它在本地能编译" | 环境优先每次都能节省 30 分钟以上。 |
| "我会更仔细地阅读崩溃报告,而不是复现它" | 崩溃报告显示崩溃了什么,而不是为什么崩溃。在 LLDB 中使用断点复现能揭示实际状态。axiom-lldb 提供了相应的工作流程。 |
对于以下情况,请勿使用 ios-build——请使用正确的路由器:
| 错误类型 | 正确的路由器 | 为何不使用 ios-build |
|---|---|---|
| Swift 6 并发错误 | ios-concurrency | 代码错误,非环境问题 |
| SwiftData 迁移错误 | ios-data | 架构问题,非构建环境 |
| "Sending 'self' risks data race" | ios-concurrency | 语言错误,非 Xcode 问题 |
| 类型不匹配 / 编译错误 | 修复代码 | 这些是代码错误 |
ios-build 用于环境谜团,而非代码错误:
用户:"我的构建因链接器错误而失败" → 调用:/skill axiom-xcode-debugging(环境优先诊断)
用户:"构建需要 10 分钟" → 调用:/skill axiom-build-performance
用户:"SPM 无法解析依赖项" → 调用:spm-conflict-resolver 代理
用户:"两个包需要同一个依赖项的不同版本" → 调用:spm-conflict-resolver 代理
用户:"重复符号链接器错误" → 调用:spm-conflict-resolver 代理
用户:"我需要为 App Store 安全审核做准备" → 调用:security-privacy-scanner 代理
用户:"我需要隐私清单吗?" → 调用:security-privacy-scanner 代理
用户:"我的代码中有硬编码的凭据吗?" → 调用:security-privacy-scanner 代理
用户:"如何从 ObservableObject 迁移到 @Observable?" → 调用:modernization-helper 代理
用户:"更新我的代码以使用现代 SwiftUI 模式" → 调用:modernization-helper 代理
用户:"我还应该使用 @StateObject 吗?" → 调用:modernization-helper 代理
用户:"一个 Beta 测试人员说我的应用崩溃了" → 调用:/skill axiom-testflight-triage
用户:"我在 App Store Connect 中看到崩溃,但不知道如何调查" → 调用:/skill axiom-testflight-triage
用户:"我的崩溃日志没有符号化" → 调用:/skill axiom-testflight-triage
用户:"我需要审查 TestFlight 反馈" → 调用:/skill axiom-testflight-triage
用户:"如何在 App Store Connect 中查找崩溃?" → 调用:/skill axiom-app-store-connect-ref
用户:"ASC 中的无崩溃用户指标在哪里?" → 调用:/skill axiom-app-store-connect-ref
用户:"如何从 App Store Connect 导出崩溃数据?" → 调用:/skill axiom-app-store-connect-ref
用户:"分析这个崩溃日志" [粘贴 .ips 内容] → 调用:crash-analyzer 代理或 /axiom:analyze-crash
用户:"解析这个 .ips 文件:~/Library/Logs/DiagnosticReports/MyApp.ips" → 调用:crash-analyzer 代理或 /axiom:analyze-crash
用户:"我的应用为什么崩溃?这是报告..." → 调用:crash-analyzer 代理或 /axiom:analyze-crash
用户:"如何设置 MetricKit 来收集崩溃数据?" → 调用:/skill axiom-metrickit-ref
用户:"如何解析 MXDiagnosticPayload?" → 调用:/skill axiom-metrickit-ref
用户:"MXCallStackTree 里有什么,如何解码它?" → 调用:/skill axiom-metrickit-ref
用户:"我的应用有时会挂起" → 调用:/skill axiom-hang-diagnostics
用户:"主线程被阻塞,UI 无响应" → 调用:/skill axiom-hang-diagnostics
用户:"Xcode Organizer 显示我的应用有挂起诊断" → 调用:/skill axiom-hang-diagnostics
用户:"我的应用在启动时被看门狗终止了" → 调用:/skill axiom-hang-diagnostics
用户:"我有一个崩溃报告,需要在调试器中复现它" → 调用:/skill axiom-lldb
用户:"如何设置断点来捕获这个崩溃?" → 调用:/skill axiom-lldb
用户:"我的构建失败,显示 BUILD FAILED 但没有错误详情" → 调用:build-fixer 代理或 /axiom:fix-build
用户:"构建有时成功,有时失败" → 调用:build-fixer 代理或 /axiom:fix-build
用户:"如何加快我的 Xcode 构建时间?" → 调用:build-optimizer 代理或 /axiom:optimize-build
每周安装次数
114
仓库
GitHub 星标
606
首次出现
2026年1月21日
安全审计
安装于
opencode97
codex92
gemini-cli89
claude-code88
github-copilot85
cursor85
You MUST use this skill for ANY build, environment, or Xcode-related issue before debugging application code.
Use this router when you encounter:
BUILD FAILED, compilation errors, linker errors)This router invokes specialized skills based on the specific issue:
Triggers :
BUILD FAILED without obvious code causexcodebuild processesWhy xcode-debugging first : 90% of mysterious issues are environment, not code. Check this BEFORE debugging code.
Invoke : /skill axiom-xcode-debugging
Triggers :
Invoke : /skill axiom-build-performance
Triggers :
Why spm-conflict-resolver : Specialized agent that analyzes Package.swift and Package.resolved to diagnose and resolve Swift Package Manager conflicts.
Invoke : Launch spm-conflict-resolver agent
Triggers :
Why security-privacy-scanner : Specialized agent that scans for security vulnerabilities and privacy compliance issues.
Invoke : Launch security-privacy-scanner agent or /axiom:audit security
Triggers :
Why modernization-helper : Specialized agent that scans for legacy patterns and provides migration paths with code examples.
Invoke : Launch modernization-helper agent or /axiom:audit modernization
Triggers :
Why build-fixer : Autonomous agent that checks zombie processes, Derived Data, SPM cache, and simulator state before investigating code. Saves 30+ minutes on environment issues.
Invoke : Launch build-fixer agent or /axiom:fix-build
Triggers :
Why build-optimizer : Scans Xcode projects for build performance optimizations — slow type checking, expensive scripts, suboptimal settings — to reduce build times by 30-50%.
Invoke : Launch build-optimizer agent or /axiom:optimize-build
Triggers :
Invoke : /skill axiom-build-debugging
Triggers :
Why testflight-triage : Systematic workflow for investigating TestFlight crashes and reviewing beta feedback. Covers symbolication, crash interpretation, common patterns, and Claude-assisted analysis.
Invoke : /skill axiom-testflight-triage
Triggers :
Why app-store-connect-ref : Reference for navigating ASC crash analysis, metrics dashboards, and data export workflows.
Invoke : /skill axiom-app-store-connect-ref
Triggers :
Why crash-analyzer : Autonomous agent that parses crash reports, identifies patterns (null pointer, Swift runtime, watchdog, jetsam), and generates actionable analysis.
Invoke : Launch crash-analyzer agent or /axiom:analyze-crash
Triggers :
Why metrickit-ref : Complete MetricKit API reference with setup patterns, payload parsing, and integration with crash reporting systems.
Invoke : /skill axiom-metrickit-ref
Triggers :
Why hang-diagnostics : Systematic diagnosis of hangs with decision tree for busy vs blocked main thread, tool selection (Time Profiler, System Trace), and 8 common hang patterns with fixes.
Invoke : /skill axiom-hang-diagnostics
Triggers :
Why axiom-lldb : Crash reports tell you WHAT crashed. LLDB tells you WHY.
Invoke : /skill axiom-lldb
| Thought | Reality |
|---|---|
| "I know how to fix this linker error" | Linker errors have 4+ root causes. xcode-debugging diagnoses all in 2 min. |
| "Let me just clean the build folder" | Clean builds mask the real issue. xcode-debugging finds the root cause. |
| "It's just an SPM issue, I'll fix Package.swift" | SPM conflicts cascade. spm-conflict-resolver analyzes the full dependency graph. |
| "The simulator is just slow today" | Simulator issues indicate environment corruption. xcode-debugging checks systematically. |
| "I'll skip environment checks, it compiles locally" | Environment-first saves 30+ min. Every time. |
| "I'll read the crash report more carefully instead of reproducing" | Crash reports show WHAT crashed, not WHY. Reproducing in LLDB with breakpoints reveals the actual state. axiom-lldb has the workflow. |
Do NOT use ios-build for these — use the correct router instead:
| Error Type | Correct Router | Why NOT ios-build |
|---|---|---|
| Swift 6 concurrency errors | ios-concurrency | Code error, not environment |
| SwiftData migration errors | ios-data | Schema issue, not build environment |
| "Sending 'self' risks data race" | ios-concurrency | Language error, not Xcode issue |
| Type mismatch / compilation errors | Fix the code | These are code bugs |
ios-build is for environment mysteries , not code errors:
User: "My build failed with a linker error" → Invoke: /skill axiom-xcode-debugging (environment-first diagnostic)
User: "Builds are taking 10 minutes" → Invoke: /skill axiom-build-performance
User: "SPM won't resolve dependencies" → Invoke: spm-conflict-resolver agent
User: "Two packages require different versions of the same dependency" → Invoke: spm-conflict-resolver agent
User: "Duplicate symbol linker error" → Invoke: spm-conflict-resolver agent
User: "I need to prepare for App Store security review" → Invoke: security-privacy-scanner agent
User: "Do I need a Privacy Manifest?" → Invoke: security-privacy-scanner agent
User: "Are there hardcoded credentials in my code?" → Invoke: security-privacy-scanner agent
User: "How do I migrate from ObservableObject to @Observable?" → Invoke: modernization-helper agent
User: "Update my code to use modern SwiftUI patterns" → Invoke: modernization-helper agent
User: "Should I still use @StateObject?" → Invoke: modernization-helper agent
User: "A beta tester said my app crashed" → Invoke: /skill axiom-testflight-triage
User: "I see crashes in App Store Connect but don't know how to investigate" → Invoke: /skill axiom-testflight-triage
User: "My crash logs aren't symbolicated" → Invoke: /skill axiom-testflight-triage
User: "I need to review TestFlight feedback" → Invoke: /skill axiom-testflight-triage
User: "How do I find crashes in App Store Connect?" → Invoke: /skill axiom-app-store-connect-ref
User: "Where's the crash-free users metric in ASC?" → Invoke: /skill axiom-app-store-connect-ref
User: "How do I export crash data from App Store Connect?" → Invoke: /skill axiom-app-store-connect-ref
User: "Analyze this crash log" [pastes .ips content] → Invoke: crash-analyzer agent or /axiom:analyze-crash
User: "Parse this .ips file: ~/Library/Logs/DiagnosticReports/MyApp.ips" → Invoke: crash-analyzer agent or /axiom:analyze-crash
User: "Why did my app crash? Here's the report..." → Invoke: crash-analyzer agent or /axiom:analyze-crash
User: "How do I set up MetricKit to collect crash data?" → Invoke: /skill axiom-metrickit-ref
User: "How do I parse MXDiagnosticPayload?" → Invoke: /skill axiom-metrickit-ref
User: "What's in MXCallStackTree and how do I decode it?" → Invoke: /skill axiom-metrickit-ref
User: "My app hangs sometimes" → Invoke: /skill axiom-hang-diagnostics
User: "The main thread is blocked and UI is unresponsive" → Invoke: /skill axiom-hang-diagnostics
User: "Xcode Organizer shows hang diagnostics for my app" → Invoke: /skill axiom-hang-diagnostics
User: "My app was killed by watchdog during launch" → Invoke: /skill axiom-hang-diagnostics
User: "I have a crash report and need to reproduce it in the debugger" → Invoke: /skill axiom-lldb
User: "How do I set breakpoints to catch this crash?" → Invoke: /skill axiom-lldb
User: "My build is failing with BUILD FAILED but no error details" → Invoke: build-fixer agent or /axiom:fix-build
User: "Build sometimes succeeds, sometimes fails" → Invoke: build-fixer agent or /axiom:fix-build
User: "How can I speed up my Xcode build times?" → Invoke: build-optimizer agent or /axiom:optimize-build
Weekly Installs
114
Repository
GitHub Stars
606
First Seen
Jan 21, 2026
Security Audits
Gen Agent Trust HubPassSocketPassSnykPass
Installed on
opencode97
codex92
gemini-cli89
claude-code88
github-copilot85
cursor85
Spring Boot Saga模式:微服务分布式事务解决方案与实现指南
406 周安装
Cosmos dbt Fusion 实施指南:在 Airflow 中集成 dbt Fusion 的完整步骤
404 周安装
3D网页体验开发指南:Three.js、React Three Fiber与WebGL优化实战
404 周安装
简历定制优化工具 - 智能匹配ATS关键词,提升面试率 | 专业简历修改服务
414 周安装
SwiftUI API 更新助手:自动扫描苹果文档,识别弃用API并提供现代替代方案
418 周安装
RSS Agent Viewer:内置发现、缓存与搜索的CLI RSS/Atom订阅管理器
409 周安装