axiom-performance

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Performance

性能

You MUST use this skill for ANY performance issue including memory leaks, slow execution, battery drain, or profiling.

任何性能问题（包括内存泄漏、执行缓慢、电池耗电、性能分析）都必须使用此技能。

When to Use

适用场景

Use this router when:

App feels slow or laggy
Memory usage grows over time
Battery drains quickly
Device gets hot during use
High energy usage in Battery Settings
Diagnosing performance with Instruments
Memory leaks or retain cycles
App crashes with memory warnings

当出现以下情况时使用此路由：

应用运行缓慢或卡顿
内存占用随时间增长
电池耗电过快
使用过程中设备发热
电池设置中显示高能耗
使用Instruments诊断性能问题
内存泄漏或保留循环
应用因内存警告崩溃

Routing Logic

路由逻辑

Memory Issues

内存问题

Memory leaks (Swift) → See skills/memory-debugging.md

Systematic leak diagnosis
5 common leak patterns
Instruments workflows
deinit not called

Memory leak scan → Launch

memory-auditor

agent or

/axiom:audit memory

(5-phase semantic audit: maps resource ownership, detects 6 leak patterns, reasons about missing cleanup, correlates compound risks, scores lifecycle health)

Memory leaks (Objective-C blocks) → See skills/objc-block-retain-cycles.md

Block retain cycles
Weak-strong pattern
Network callback leaks

内存泄漏（Swift） → 查看 skills/memory-debugging.md

系统化泄漏诊断
5种常见泄漏模式
Instruments工作流程
deinit方法未调用

内存泄漏扫描 → 启动

memory-auditor

Agent或执行

/axiom:audit memory

（5阶段语义审计：映射资源所有权、检测6种泄漏模式、分析未清理原因、关联复合风险、评估生命周期健康度）

内存泄漏（Objective-C blocks） → 查看 skills/objc-block-retain-cycles.md

Block保留循环
Weak-Strong模式
网络回调泄漏

Performance Profiling

性能分析

Performance profiling (GUI) → See skills/performance-profiling.md

Time Profiler (CPU)
Allocations (memory growth)
Core Data profiling (N+1 queries)
Decision trees for tool selection

Automated profiling (CLI) → See skills/xctrace-ref.md

Headless xctrace profiling
CI/CD integration patterns
Command-line trace recording
Programmatic trace analysis

Run automated profile → Use

performance-profiler

agent or

/axiom:profile

Records trace via xctrace
Exports and analyzes data
Reports findings with severity

性能分析（GUI） → 查看 skills/performance-profiling.md

Time Profiler（CPU分析）
Allocations（内存增长分析）
Core Data性能分析（N+1查询问题）
工具选择决策树

自动化性能分析（CLI） → 查看 skills/xctrace-ref.md

无界面xctrace性能分析
CI/CD集成模式
命令行跟踪记录
程序化跟踪分析

运行自动化性能分析 → 使用

performance-profiler

Agent或执行

/axiom:profile

通过xctrace记录跟踪数据
导出并分析数据
生成带严重级别的检测报告

Hang/Freeze Issues

卡顿/冻结问题

App hangs or freezes → See skills/hang-diagnostics.md

UI unresponsive for >1 second
Main thread blocked (busy or waiting)
Decision tree: busy vs blocked diagnosis
Time Profiler vs System Trace selection
8 common hang patterns with fixes
Watchdog terminations

应用卡顿或冻结 → 查看 skills/hang-diagnostics.md

UI无响应超过1秒
主线程阻塞（繁忙或等待）
决策树：繁忙vs阻塞诊断
Time Profiler与System Trace工具选择
8种常见卡顿模式及修复方案
Watchdog终止问题

Energy Issues

能耗问题

Battery drain, high energy → See skills/energy.md

Power Profiler workflow
Subsystem diagnosis (CPU/GPU/Network/Location/Display)
Anti-pattern fixes
Background execution optimization

Symptom-based diagnosis → See skills/energy-diag.md

"App at top of Battery Settings"
"Device gets hot"
"Background battery drain"
Time-cost analysis for each path

API reference with code → See skills/energy-ref.md

Complete WWDC code examples
Timer, network, location efficiency
BGContinuedProcessingTask (iOS 26)
MetricKit setup

Energy scan → Launch

energy-auditor

agent or

/axiom:audit energy

(8 anti-patterns: timer abuse, polling, continuous location, animation leaks, background mode misuse, network inefficiency, GPU waste, disk I/O)

电池耗电、高能耗 → 查看 skills/energy.md

Power Profiler工作流程
子系统诊断（CPU/GPU/网络/定位/显示）
反模式修复
后台执行优化

基于症状的诊断 → 查看 skills/energy-diag.md

"应用在电池设置中排名靠前"
"设备发热"
"后台电池耗电"
各诊断路径的时间成本分析

带代码示例的API参考 → 查看 skills/energy-ref.md

完整WWDC代码示例
计时器、网络、定位效率优化
BGContinuedProcessingTask（iOS 26）
MetricKit配置

能耗扫描 → 启动

energy-auditor

Agent或执行

/axiom:audit energy

（检测8种反模式：计时器滥用、轮询、持续定位、动画泄漏、后台模式误用、网络低效、GPU浪费、磁盘I/O）

Timer Safety

计时器安全

Timer crash patterns (DispatchSourceTimer) → See

axiom-integration

(skills/timer-patterns.md)

4 crash scenarios causing EXC_BAD_INSTRUCTION
RunLoop mode gotcha (Timer stops during scroll)
SafeDispatchTimer wrapper
Timer vs DispatchSourceTimer decision

Timer API reference → See

axiom-integration

(skills/timer-patterns-ref.md)

Timer, DispatchSourceTimer, Combine, AsyncTimerSequence APIs
Lifecycle diagrams
Platform availability

计时器崩溃模式（DispatchSourceTimer） → 查看

axiom-integration

（skills/timer-patterns.md）

导致EXC_BAD_INSTRUCTION的4种崩溃场景
RunLoop模式陷阱（滚动时计时器停止）
SafeDispatchTimer封装
Timer与DispatchSourceTimer选型决策

计时器API参考 → 查看

axiom-integration

（skills/timer-patterns-ref.md）

Timer、DispatchSourceTimer、Combine、AsyncTimerSequence API
生命周期图
平台兼容性

Swift Performance

Swift性能

Swift performance optimization → See skills/swift-performance.md

Value vs reference types, copy-on-write
ARC overhead, generic specialization
Collection performance

Swift performance scan → Launch

swift-performance-analyzer

agent or

/axiom:audit swift-performance

(unnecessary copies, ARC overhead, unspecialized generics, collection inefficiencies, actor isolation costs, memory layout)

Modern Swift idioms → See axiom-swift (skills/swift-modern.md)

Outdated API patterns (Date(), CGFloat, DateFormatter)
Foundation modernization (URL.documentsDirectory, FormatStyle)
Claude-specific hallucination corrections

Swift性能优化 → 查看 skills/swift-performance.md

值类型vs引用类型、写时复制
ARC开销、泛型特化
集合性能优化

Swift性能扫描 → 启动

swift-performance-analyzer

Agent或执行

/axiom:audit swift-performance

（检测不必要的复制、ARC开销、未特化泛型、集合低效、Actor隔离成本、内存布局问题）

现代Swift语法 → 查看axiom-swift（skills/swift-modern.md）

过时API模式（Date()、CGFloat、DateFormatter）
Foundation现代化（URL.documentsDirectory、FormatStyle）
Claude特定幻觉修正

MetricKit Integration

MetricKit集成

MetricKit API reference → See skills/metrickit-ref.md

MXMetricPayload parsing
MXDiagnosticPayload (crashes, hangs)
Field performance data collection
Integration with crash reporting

MetricKit API参考 → 查看 skills/metrickit-ref.md

MXMetricPayload解析
MXDiagnosticPayload（崩溃、卡顿）
现场性能数据收集
与崩溃报告系统集成

Runtime Console Capture

运行时控制台捕获

Capture simulator console output →

/axiom:console

Capture print(), os_log(), Logger output from simulator
Structured JSON with level, subsystem, category
Bounded collection with
```
--timeout
```
and
```
--max-lines
```
Filter by subsystem or regex

捕获模拟器控制台输出 →

/axiom:console

捕获模拟器中的print()、os_log()、Logger输出
带级别、子系统、分类的结构化JSON
支持
```
--timeout
```
和
```
--max-lines
```
的有限收集
按子系统或正则表达式过滤

Runtime State Inspection

运行时状态检查

LLDB interactive debugging → See axiom-build (skills/lldb.md)

Set breakpoints, inspect variables at runtime
Crash reproduction from crash logs
Thread state analysis for hangs
Swift value inspection (po vs v)

LLDB command reference → See axiom-build (skills/lldb-ref.md)

Complete command syntax
Breakpoint recipes
Expression evaluation patterns

LLDB交互式调试 → 查看axiom-build（skills/lldb.md）

设置断点、运行时检查变量
通过崩溃日志重现崩溃
卡顿线程状态分析
Swift值检查（po vs v）

LLDB命令参考 → 查看axiom-build（skills/lldb-ref.md）

完整命令语法
断点配置方案
表达式求值模式

Decision Tree

决策树

Memory climbing + UI stutter/jank? → memory-debugging FIRST (memory pressure causes GC pauses that drop frames), then performance-profiling if memory is fixed but stutter remains
Memory leak (Swift)? → memory-debugging
Memory leak (Objective-C blocks)? → objc-block-retain-cycles
App hang/freeze — is UI completely unresponsive (can't tap, no feedback)?
- YES → hang-diagnostics (busy vs blocked diagnosis)
- NO, just slow → performance-profiling (Time Profiler)
- First launch only? → Also check for synchronous I/O or lazy initialization in hang-diagnostics
Slowdown when multiple async operations complete at once? → Cross-route to
```
axiom-concurrency
```
(callback contention, not profiling)
Battery drain (know the symptom)? → energy-diag
Battery drain (need API reference)? → energy-ref
Battery drain (general)? → energy
MetricKit setup/parsing? → metrickit-ref
Profile with GUI (Instruments)? → performance-profiling
Profile with CLI (xctrace)? → xctrace-ref
Run automated profile now? → performance-profiler agent
General slow/lag? → performance-profiling
Want proactive memory leak scan? → memory-auditor (Agent)
Want energy anti-pattern scan? → energy-auditor (Agent)
Want Swift performance audit (ARC, generics, collections)? → swift-performance-analyzer (Agent)
Need to inspect variable/thread state at runtime? → See axiom-build (skills/lldb.md)
Need exact LLDB command syntax? → See axiom-build (skills/lldb-ref.md)
Timer stops during scrolling? → timer-patterns (RunLoop mode)
EXC_BAD_INSTRUCTION crash with DispatchSourceTimer? → timer-patterns (4 crash patterns)
Choosing between Timer, DispatchSourceTimer, Combine timer, async timer? → timer-patterns
Need timer API syntax/lifecycle? → timer-patterns-ref
Code review for outdated Swift patterns? → swift-modern
Claude generating legacy APIs (DateFormatter, CGFloat, DispatchQueue)? → swift-modern
Need to see runtime console output before profiling? → axiom-tools (skills/xclog-ref.md) or
```
/axiom:console
```

内存持续增长 + UI卡顿？→ 优先使用memory-debugging（内存压力会导致GC暂停，进而丢帧），若内存问题修复后仍存在卡顿，再使用performance-profiling
Swift内存泄漏？→ memory-debugging
Objective-C Blocks内存泄漏？→ objc-block-retain-cycles
应用卡顿/冻结——UI完全无响应（无法点击、无反馈）？
- 是 → hang-diagnostics（繁忙vs阻塞诊断）
- 否，只是缓慢 → performance-profiling（Time Profiler）
- 仅首次启动时出现？→ 同时在hang-diagnostics中检查同步I/O或懒加载问题
多个异步操作同时完成时出现减速？→ 跳转至
```
axiom-concurrency
```
（回调竞争，不属于性能分析范畴）
电池耗电（已知症状）？→ energy-diag
电池耗电（需要API参考）？→ energy-ref
电池耗电（一般性问题）？→ energy
MetricKit配置/解析？→ metrickit-ref
使用GUI（Instruments）进行性能分析？→ performance-profiling
使用CLI（xctrace）进行性能分析？→ xctrace-ref
立即运行自动化性能分析？→ performance-profiler Agent
一般性缓慢/卡顿？→ performance-profiling
主动扫描内存泄漏？→ memory-auditor（Agent）
扫描能耗反模式？→ energy-auditor（Agent）
审计Swift代码性能反模式（ARC、泛型、集合）？→ swift-performance-analyzer（Agent）
需要在运行时检查变量/线程状态？→ 查看axiom-build（skills/lldb.md）
需要精确的LLDB命令语法？→ 查看axiom-build（skills/lldb-ref.md）
滚动时计时器停止？→ timer-patterns（RunLoop模式）
DispatchSourceTimer导致EXC_BAD_INSTRUCTION崩溃？→ timer-patterns（4种崩溃模式）
在Timer、DispatchSourceTimer、Combine计时器、异步计时器之间选型？→ timer-patterns
需要计时器API语法/生命周期？→ timer-patterns-ref
代码审查：过时Swift模式？→ swift-modern
Claude生成了旧版API（DateFormatter、CGFloat、DispatchQueue）？→ swift-modern
性能分析前需要查看运行时控制台输出？→ axiom-tools（skills/xclog-ref.md）或执行
```
/axiom:console
```

Anti-Rationalization

误区纠正

Thought	Reality
"I know it's a memory leak, let me find it"	Memory leaks have 6 patterns. memory-debugging diagnoses the right one in 15 min vs 2 hours.
"I'll just run Time Profiler"	Wrong Instruments template wastes time. performance-profiling selects the right tool first.
"Battery drain is probably the network layer"	Energy issues span 8 subsystems. energy skill diagnoses the actual cause.
"App feels slow, I'll optimize later"	Performance issues compound. Profiling now saves exponentially more time later.
"It's just a UI freeze, probably a slow API call"	Freezes have busy vs blocked causes. hang-diagnostics has a decision tree for both.
"Memory is climbing AND scrolling stutters — two separate bugs"	Memory pressure causes GC pauses that drop frames. Fix the leak first, then re-check scroll performance.
"It only freezes on first launch, must be loading something"	First-launch hangs have 3 patterns: synchronous I/O, lazy initialization, main thread contention. hang-diagnostics diagnoses which.
"UI locks up when network requests finish — that's slow"	Multiple callbacks completing at once = main thread contention = concurrency issue. Cross-route to axiom-concurrency.
"I'll just add print statements to debug this"	Print-debug cycles cost 3-5 min each (build + run + reproduce). An LLDB breakpoint costs 30 seconds. axiom-build (skills/lldb.md) has the commands.
"I can't see what the app is logging"	xclog captures print() + os_log from the simulator with structured JSON. `/axiom:console` .
"I'll just use Timer.scheduledTimer, it's simpler"	Timer stops during scrolling ( `.default` mode), retains its target (leak). timer-patterns has the decision tree.
"DispatchSourceTimer crashed but it's intermittent, let's ship"	DispatchSourceTimer has 4 crash patterns that are ALL deterministic. timer-patterns diagnoses which one.
"Claude already knows modern Swift"	Claude defaults to pre-5.5 patterns (Date(), CGFloat, filter().count). swift-modern has the correction table.

错误想法	实际情况
"我知道这是内存泄漏，我自己找就行"	内存泄漏有6种模式。使用memory-debugging可在15分钟内定位正确模式，而自行排查可能需要2小时。
"我直接运行Time Profiler就行"	选错Instruments模板会浪费时间。performance-profiling会帮你先选择合适的工具。
"电池耗电可能是网络层的问题"	能耗问题涉及8个子系统。energy技能可诊断实际原因。
"应用有点慢，以后再优化"	性能问题会不断恶化。现在进行性能分析能节省未来大量时间。
"只是UI冻结，可能是API调用慢"	冻结分为繁忙和阻塞两种原因。hang-diagnostics包含针对这两种情况的决策树。
"内存持续增长且滚动卡顿——这是两个独立的bug"	内存压力会导致GC暂停，进而丢帧。先修复泄漏，再重新检查滚动性能。
"仅首次启动时冻结，肯定是加载东西导致的"	首次启动卡顿有3种模式：同步I/O、懒加载、主线程竞争。hang-diagnostics可诊断具体类型。
"网络请求完成时UI卡住——只是速度慢"	多个回调同时完成会导致主线程竞争，属于并发问题。跳转至axiom-concurrency。
"我加print语句调试就行"	每次print调试周期需要3-5分钟（构建+运行+重现）。而LLDB断点仅需30秒。axiom-build（skills/lldb.md）包含相关命令。
"我看不到应用在输出什么日志"	xclog可捕获模拟器中的print() + os_log输出，并生成结构化JSON。执行 `/axiom:console` 即可。
"我用Timer.scheduledTimer就行，更简单"	Timer在滚动时会停止（ `.default` 模式），且会持有目标对象导致泄漏。timer-patterns包含选型决策树。
"DispatchSourceTimer偶尔崩溃，先发布再说"	DispatchSourceTimer的4种崩溃模式都是确定性的。timer-patterns可诊断具体类型。
"Claude已经了解现代Swift"	Claude默认使用Swift 5.5之前的模式（Date()、CGFloat、filter().count）。swift-modern包含修正表。

Critical Patterns

关键模式

Memory Debugging (memory-debugging):

6 leak patterns: timers, observers, closures, delegates, view callbacks, PhotoKit
Instruments workflows
Leak vs caching distinction

Performance Profiling (performance-profiling):

Time Profiler for CPU bottlenecks
Allocations for memory growth
Core Data SQL logging for N+1 queries
Self Time vs Total Time

Energy Optimization (energy):

Power Profiler subsystem diagnosis
8 anti-patterns: timers, polling, location, animations, background, network, GPU, disk
Audit checklists by subsystem
Pressure scenarios for deadline resistance

内存调试（memory-debugging）：

6种泄漏模式：计时器、观察者、闭包、代理、视图回调、PhotoKit
Instruments工作流程
泄漏与缓存的区别

性能分析（performance-profiling）：

Time Profiler用于CPU瓶颈分析
Allocations用于内存增长分析
Core Data SQL日志用于N+1查询问题
Self Time与Total Time的区别

能耗优化（energy）：

Power Profiler子系统诊断
8种反模式：计时器、轮询、定位、动画、后台、网络、GPU、磁盘
各子系统的审计清单
Deadline抗性的压力场景

Example Invocations

调用示例

User: "My app's memory usage keeps growing" → See skills/memory-debugging.md

User: "I have a memory leak but deinit isn't being called" → See skills/memory-debugging.md

User: "My app feels slow, where do I start?" → See skills/performance-profiling.md

User: "My Objective-C block callback is leaking" → See skills/objc-block-retain-cycles.md

User: "My app drains battery quickly" → See skills/energy.md

User: "Users say the device gets hot when using my app" → See skills/energy-diag.md

User: "What's the best way to implement location tracking efficiently?" → See skills/energy-ref.md

User: "Profile my app's CPU usage" → Use:

performance-profiler

agent (or

/axiom:profile

)

User: "How do I run xctrace from the command line?" → See skills/xctrace-ref.md

User: "I need headless profiling for CI/CD" → See skills/xctrace-ref.md

User: "My app hangs sometimes" → See skills/hang-diagnostics.md

User: "The UI freezes and becomes unresponsive" → See skills/hang-diagnostics.md

User: "Main thread is blocked, how do I diagnose?" → See skills/hang-diagnostics.md

User: "How do I set up MetricKit?" → See skills/metrickit-ref.md

User: "How do I parse MXMetricPayload?" → See skills/metrickit-ref.md

User: "Scan my code for memory leaks" → Invoke:

memory-auditor

agent

User: "Check my app for battery drain issues" → Invoke:

energy-auditor

agent

User: "Audit my Swift code for performance anti-patterns" → Invoke:

swift-performance-analyzer

agent

User: "How do I inspect this variable in the debugger?" → Invoke: See axiom-build (skills/lldb.md)

User: "What's the LLDB command for conditional breakpoints?" → Invoke: See axiom-build (skills/lldb-ref.md)

User: "I need to reproduce this crash in the debugger" → Invoke: See axiom-build (skills/lldb.md)

User: "My list scrolls slowly and memory keeps growing" → See skills/memory-debugging.md first, then skills/performance-profiling.md if stutter remains

User: "App freezes for a few seconds on first launch then works fine" → See skills/hang-diagnostics.md

User: "UI locks up when multiple API calls return at the same time" → Cross-route:

/skill axiom-concurrency

(callback contention)

User: "My timer stops when the user scrolls" → Read:

axiom-integration

(skills/timer-patterns.md)

User: "EXC_BAD_INSTRUCTION crash in my timer code" → Read:

axiom-integration

(skills/timer-patterns.md)

User: "Should I use Timer or DispatchSourceTimer?" → Read:

axiom-integration

(skills/timer-patterns.md)

User: "How do I create an AsyncTimerSequence?" → Read:

axiom-integration

(skills/timer-patterns-ref.md)

User: "Review my Swift code for outdated patterns" → Invoke: See axiom-swift (skills/swift-modern.md)

User: "Is there a more modern way to do this?" → Invoke: See axiom-swift (skills/swift-modern.md)

User: "What is the app logging? I need to see console output" → Invoke:

/axiom:console

User: "Capture the simulator logs while I reproduce this bug" → Invoke:

/axiom:console

用户："我的应用内存占用持续增长" → 查看 skills/memory-debugging.md

用户："我遇到内存泄漏，但deinit方法没被调用" → 查看 skills/memory-debugging.md

用户："我的应用运行缓慢，该从哪里开始排查？" → 查看 skills/performance-profiling.md

用户："我的Objective-C Block回调出现泄漏" → 查看 skills/objc-block-retain-cycles.md

用户："我的应用电池耗电过快" → 查看 skills/energy.md

用户："用户反馈使用应用时设备发热" → 查看 skills/energy-diag.md

用户："如何高效实现定位跟踪？" → 查看 skills/energy-ref.md

用户："分析我的应用CPU占用情况" → 使用：

performance-profiler

Agent（或执行

/axiom:profile

）

用户："如何从命令行运行xctrace？" → 查看 skills/xctrace-ref.md

用户："需要为CI/CD配置无界面性能分析" → 查看 skills/xctrace-ref.md

用户："我的应用偶尔卡顿" → 查看 skills/hang-diagnostics.md

用户："UI冻结且无响应" → 查看 skills/hang-diagnostics.md

用户："主线程阻塞，该如何诊断？" → 查看 skills/hang-diagnostics.md

用户："如何配置MetricKit？" → 查看 skills/metrickit-ref.md

用户："如何解析MXMetricPayload？" → 查看 skills/metrickit-ref.md

用户："扫描我的代码是否存在内存泄漏" → 调用：

memory-auditor

Agent

用户："检查我的应用是否存在电池耗电问题" → 调用：

energy-auditor

Agent

用户："审计我的Swift代码是否存在性能反模式" → 调用：

swift-performance-analyzer

Agent

用户："如何在调试器中检查这个变量？" → 调用：查看axiom-build（skills/lldb.md）

用户："设置条件断点的LLDB命令是什么？" → 调用：查看axiom-build（skills/lldb-ref.md）

用户："需要在调试器中重现这个崩溃" → 调用：查看axiom-build（skills/lldb.md）

用户："我的列表滚动缓慢且内存持续增长" → 先查看 skills/memory-debugging.md，若卡顿仍存在再查看 skills/performance-profiling.md

用户："应用首次启动时冻结几秒，之后恢复正常" → 查看 skills/hang-diagnostics.md

用户："多个API调用同时返回时UI卡住" → 跳转：

/skill axiom-concurrency

（回调竞争）

用户："我的计时器在用户滚动时停止" → 阅读：

axiom-integration

（skills/timer-patterns.md）

用户："我的计时器代码出现EXC_BAD_INSTRUCTION崩溃" → 阅读：

axiom-integration

（skills/timer-patterns.md）

用户："我应该用Timer还是DispatchSourceTimer？" → 阅读：

axiom-integration

（skills/timer-patterns.md）

用户："如何创建AsyncTimerSequence？" → 阅读：

axiom-integration

（skills/timer-patterns-ref.md）

用户："审查我的Swift代码是否存在过时模式" → 调用：查看axiom-swift（skills/swift-modern.md）

用户："有没有更现代的实现方式？" → 调用：查看axiom-swift（skills/swift-modern.md）

用户："应用在输出什么日志？我需要查看控制台输出" → 调用：

/axiom:console

用户："在我重现这个bug时捕获模拟器日志" → 调用：

/axiom:console