К основному содержанию
скилл CX Codex

native-app-performance — скилл для Claude Code

Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments.

MIT 251 установок ★ 7 554 обновлён 2026-10-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add steipete/agent-scripts --skill native-app-performance -a claude-code
Открыть на GitHub

Что делает native-app-performance

Работает из командной строки: записывает профиль Time Profiler через xctrace record (можно приаттачиться к запущенному приложению или запустить его заново), извлекает семплы времени в XML, получает адрес загрузки __TEXT через vmmap, а затем символицирует стек и ранжирует топ фреймов приложения.

В комплекте три скрипта: record_time_profiler.sh для записи, extract_time_samples.py для экспорта XML из трассы и top_hotspots.py для символизации и ранжирования. Важное условие: при ASLR нужно использовать реальный адрес __TEXT из vmmap, а бинарник в --binary должен совпадать с тем, что профилировался (иначе символы не совпадут).

Поток полностью в терминале: не нужно открывать Instruments, если стеки уже символицированы через atos. Главное — убедиться, что запись попала именно на медленный путь (открытие меню, рефреш, лаг).

Какие задачи решает

  • записать профиль Time Profiler для iOS или macOS приложения без Instruments
  • извлечь горячие места и узкие места из трассы xctrace
  • символицировать стеки и найти топ фреймов по времени CPU
  • профилировать приложение, приаттачившись к уже запущенному процессу

Примеры запросов агенту

  • Приаттачься к процессу с PID 1234 и запиши 90 секунд Time Profiler в /tmp/App.trace
  • Запусти /path/App.app/Contents/MacOS/App и профилируй его 60 секунд, потом извлеки горячие места
  • Символицируй /tmp/time-sample.xml с адресом загрузки 0x100000000 и покажи топ 30 фреймов

Как установить native-app-performance

1Через Skills CLI (Vercel)

npx skills add steipete/agent-scripts --skill native-app-performance -a claude-code

2Вручную: положить файлы

~/.claude/skills/native-app-performance/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/native-app-performance/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о native-app-performance

Как установить native-app-performance в Claude Code?

Запусти npx skills add steipete/agent-scripts --skill native-app-performance -a claude-code, затем открой ~/.claude/skills/native-app-performance/SKILL.md.

Что делает native-app-performance?

Записывает профиль Time Profiler через xctrace, извлекает семплы времени, символицирует стек и показывает узкие места приложения — всё из командной строки без Instruments.

Почему не работает символизация или стеки пусты?

Проверь три вещи: бинарник в --binary должен совпадать с профилировавшимся, адрес __TEXT из vmmap должен быть актуальным (получай его во время запуска приложения), и запись должна захватить медленный путь (меню, рефреш), не пустые промежутки.

Исходный текст

SKILL.md · MIT
---
name: native-app-performance
description: "Native app performance: xctrace, Time Profiler, traces, hotspots."
---

# Native App Performance (CLI-only)

Goal: record Time Profiler via `xctrace`, extract samples, symbolicate, and propose hotspots without opening Instruments.

## Quick start (CLI)

1) Record Time Profiler (attach):

```bash
# Start app yourself, then attach
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
```

2) Record Time Profiler (launch):

```bash
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /path/App.app/Contents/MacOS/App
```

3) Extract time samples:

```bash
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
```

4) Get load address for symbolication:

```bash
# While app is running
vmmap <pid> | rg -m1 "__TEXT" -n
```

5) Symbolicate + rank hotspots:

```bash
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
  --binary /path/App.app/Contents/MacOS/App \
  --load-address 0x100000000 --top 30
```

## Workflow notes

- Always confirm you’re profiling the correct binary (local build vs /Applications). Prefer direct binary path for `--launch`.
- Ensure you trigger the slow path during capture (menu open/close, refresh, etc.).
- If stacks are empty, capture longer or avoid idle sections.
- `xcrun xctrace help record` and `xcrun xctrace help export` show correct flags.

## Included scripts

- `scripts/record_time_profiler.sh`: record via attach or launch.
- `scripts/extract_time_samples.py`: export time-sample XML from a trace.
- `scripts/top_hotspots.py`: symbolicate and rank top app frames.

## Gotchas

- ASLR means you must use the runtime `__TEXT` load address from `vmmap`.
- If using a new build, update the `--binary` path; symbols must match the trace.
- CLI-only flow: no need to open Instruments if stacks are symbolicated via `atos`.

© steipete · MIT · steipete/agent-scripts

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
performance daveebbelaar Скилл performance для Claude Code, который измеряет нагрузку на CPU, память и энергию в macOS-приложениях. Помогает находить причины зависаний и переносить вычисления с основного потока на GPU. CX Codex +1 1 000установок argent-native-profiler software-mansion Скилл argent-native-profiler для Claude Code находит узкие места CPU, зависания UI и утечки памяти в мобильных и настольных приложениях. Запускается при отладке производительности на iOS, Android и macOS. CX Codex +1 32 400установок swiftui-performance dpearson2699 Скилл swiftui-performance для Claude Code, Cursor, Codex и других агентов, который ведёт от воспроизводимого симптома торможения SwiftUI к измеренному результату. CX Codex +1 5 000установок ios-ettrace-performance dpearson2699 Скилл ios-ettrace-performance для Claude Code помогает снять и разобрать ETTrace-профиль конкретного сценария запуска или работы iOS-приложения. Он подключается к задачам с замером и сравнением производительности. CX Codex +1 1 500установок swiftui-performance-audit официальный OpenAI Скилл swiftui-performance-audit находит причины просадок кадров, долгого рендеринга и утечек памяти в SwiftUI. Помогает разобрать код вьюшек или подготовить замеры для профилирования. CX Codex GP ChatGPT +1 109установок swiftui-expert-skill AvdLee Скилл swiftui-expert-skill для Claude Code, Codex, Cursor и других ИИ-ассистентов. Подключает правила ревью, оптимизации верстки и анализа трейсов Instruments при разработке на SwiftUI под iOS и macOS. CX Codex +1 36 800установок

Из того же набора20

Весь набор →
markdown-converter Скилл markdown-converter переводит офисные документы, таблицы, PDF, разметку и медиафайлы в чистый Markdown прямо через uvx без ручной настройки парсеров. CX Codex +1 346установок codex-first Скилл codex-first маршрутизирует разработку между Claude и воркерами Codex. Claude пишет спецификации и проверяет код, а Codex выполняет реализацию и авторевью. CX Codex +1 288установок browser-use Скилл browser-use для Claude Code и Codex — управляет реальным профилем Chrome пользователя с сохранёнными логинами и расширениями. Запускается через плагин Codex, расширение OpenClaw или прямое подключение DevTools. CX Codex +1 278установок github-deep-review Скилл github-deep-review для глубокого разбора GitHub-проблем и PR. Читает код, ищет корень бага, предлагает лучший фикс и называет, что именно нужно проверить перед слиянием. CX Codex +1 275установок instruments-profiling Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки. CX Codex +1 242установок ssh-doctor Скилл ssh-doctor диагностирует сбои SSH на macOS: обрывы до авторизации, зависшие сессии sshd и проблемы службы Remote Login. CX Codex +1 239установок domain-dns-ops Скилл domain-dns-ops для Claude Code ведёт операции с доменами, зонами Cloudflare и редиректами. Настраивает новые домены и проверяет DNS и HTTPS. CX Codex +1 192установок discord-clawd Скилл discord-clawd для отправки вопросов Discord-бэкированному агенту через OpenClaw реле. Не для поиска в архивах — используйте для прямого общения с сессией. CX Codex +1 122установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой