native-app-performance — скилл для Claude Code
Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments.
MIT 251 установок ★ 7 554 обновлён 2026-10-20
npx skills add steipete/agent-scripts --skill native-app-performance -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/native-app-performance/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/native-app-performance/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill native-app-performance -a codex2Вручную: положить файлы
.agents/skills/native-app-performance/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill native-app-performance -a cursor2Вручную: положить файлы
.cursor/skills/native-app-performance/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install steipete/agent-scripts skills/native-app-performance2Вручную: положить файлы
.github/skills/native-app-performance/SKILL.md1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill native-app-performance -a gemini-cli2Командой платформы
gemini skills install https://github.com/steipete/agent-scripts --path skills/native-app-performanceВручную: положить файлы
.devin/skills/native-app-performance/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill native-app-performance -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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