instruments-profiling — скилл для Claude Code: профилирование
Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки.
MIT 242 установок ★ 7 554 обновлён 2026-10-20
npx skills add steipete/agent-scripts --skill instruments-profiling -a claude-codeЧто делает instruments-profiling
Скилл подсказывает, как выбрать шаблон Time Profiler, запустить запись через xcrun xctrace или подключиться к уже работающему процессу. Он учитывает путь к бинарнику, PID, длительность записи, файл .trace и параметры iOS-устройства.
Для анализа трассы используются xcrun xctrace export, XPath-фильтр и последующая обработка в Python или Rust. В инструкции также есть шаги для открытия результата в Instruments и работы с Call Tree. Перед доверием к результату нужно проверить путь процесса: LaunchServices может выбрать установленное приложение вместо локальной сборки.
Для iOS пригодятся xcrun xctrace list devices и параметр --device; для осмысленных стеков нужны debug symbols. xctrace может потребовать разрешение Developer Tools для Terminal или Xcode.
Какие задачи решает
- записать Time Profiler-трассу для macOS-приложения
- подключиться к работающему процессу по PID
- выбрать локальную сборку вместо установленного приложения
- выгрузить samples из
.traceчерез XPath - найти горячие кадры в Call Tree
Примеры запросов агенту
- Профилируй запуск локальной сборки через Time Profiler и сохрани трассу в
/tmp/App.trace. - Подключись к процессу с PID
<pid>, проверь путь бинарника и найди медленный участок. - Выгрузи time-profile из
/tmp/App.traceв/tmp/time-profile.xmlдля обработки скриптом на Python.
Как установить instruments-profiling
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill instruments-profiling -a claude-code2Вручную: положить файлы
~/.claude/skills/instruments-profiling/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/instruments-profiling/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill instruments-profiling -a codex2Вручную: положить файлы
.agents/skills/instruments-profiling/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill instruments-profiling -a cursor2Вручную: положить файлы
.cursor/skills/instruments-profiling/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install steipete/agent-scripts skills/instruments-profiling2Вручную: положить файлы
.github/skills/instruments-profiling/SKILL.md1Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill instruments-profiling -a gemini-cli2Командой платформы
gemini skills install https://github.com/steipete/agent-scripts --path skills/instruments-profilingВручную: положить файлы
.devin/skills/instruments-profiling/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add steipete/agent-scripts --skill instruments-profiling -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об instruments-profiling
Как установить instruments-profiling в Claude Code?
Выполните npx skills add steipete/agent-scripts --skill instruments-profiling -a claude-code, затем проверьте файл ~/.claude/skills/instruments-profiling/SKILL.md.
Что делает instruments-profiling?
Он помогает записывать и разбирать профили производительности нативных macOS/iOS-приложений через Instruments и xctrace, включая экспорт стеков.
Почему Instruments профилирует не ту сборку?
LaunchServices может выбрать приложение из /Applications вместо локальной сборки. Используйте прямой путь к бинарнику или подключайтесь к процессу по известному PID, затем проверьте путь процесса.
Исходный текст
SKILL.md · MIT
--- name: instruments-profiling description: "Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports." metadata: short-description: Instruments profiling for macOS/iOS apps --- # Instruments Profiling (macOS/iOS) Use this skill when the user wants performance profiling or stack analysis for native apps. Focus: Time Profiler, `xctrace` CLI, and picking the correct binary/app instance. ## Quick Start (CLI) - List templates: `xcrun xctrace list templates` - Record Time Profiler (launch): - `xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app` - Record Time Profiler (attach): - Launch app yourself, get PID, then: - `xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>` - Open trace in Instruments: - `open -a Instruments /tmp/App.trace` Note: `xcrun xctrace --help` is not a valid subcommand. Use `xcrun xctrace help record`. ## Picking the Correct Binary (Critical) **Gotcha: Instruments may profile the wrong app** (e.g., one in `/Applications`) if LaunchServices resolves a different bundle. Use these rules: - Prefer direct binary path for deterministic launch: - `xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App` - If launching `.app`, ensure it’s the intended bundle: - `open -n /path/App.app` - Verify with `ps -p <pid> -o comm= -o command=` - If both `/Applications/App.app` and a local build exist, explicitly target the local build path. - After launch, confirm the process path before trusting the trace. ## Command Arguments (xctrace) - `--template 'Time Profiler'`: template name from `xctrace list templates`. - `--launch -- <cmd>`: everything after `--` is the target command (binary or app bundle). - `--attach <pid|name>`: attach to running process. - `--output <path>`: `.trace` output. If omitted, file saved in CWD. - `--time-limit 60s|5m`: set capture duration. - `--device <name|UDID>`: required for iOS device runs. - `--target-stdout -`: stream launched process stdout to terminal (useful for CLI tools). ## Exporting Stacks (CLI) - Inspect trace tables: - `xcrun xctrace export --input /tmp/App.trace --toc` - Export raw time-profile samples: - `xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml` - Post-process in a script (Python/Rust) to aggregate stacks. ## Instruments UI Workflow - Template: Time Profiler - Use “Record” and capture the slow path (startup vs steady-state) - Call Tree tips: - Hide System Libraries - Invert Call Tree - Separate by Thread - Focus on hot frames and call counts ## Gotchas & Fixes - **Wrong app profiled**: LaunchServices resolves installed app instead of local build. - Fix: use direct binary path or `--attach` with known PID. - **No samples / empty trace**: App exits quickly or never hits work. - Fix: longer capture, trigger workload during recording. - **Privacy prompts**: `xctrace` may need Developer Tools permission. - Fix: System Settings → Privacy & Security → Developer Tools → allow Terminal/Xcode. - **Large XML exports**: `time-profile` exports are huge. - Fix: filter with XPath and aggregate offline; don’t print to terminal. ## iOS Specific Notes - Device: use `xcrun xctrace list devices` and `--device <UDID>`. - Launch via Xcode if needed; attach with `xctrace --attach`. - Ensure debug symbols for meaningful stacks. ## Verification Checklist - Confirm trace process path matches target build. - Confirm stacks show expected app frames. - Capture covers the slow operation (startup/refresh). - Export stacks for automated diffing if optimizing.
© steipete · MIT · steipete/agent-scripts