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

instruments-profiling — скилл для Claude Code: профилирование

Скилл instruments-profiling для Claude Code профилирует macOS- и iOS-приложения через Instruments и xctrace, записывает трассы и выгружает стеки. Помогает искать медленные участки.

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

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

Что делает 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-code

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

~/.claude/skills/instruments-profiling/SKILL.md

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Мобильная разработка» →
swiftui-expert-skill AvdLee Скилл swiftui-expert-skill для Claude Code, Codex, Cursor и других ИИ-ассистентов. Подключает правила ревью, оптимизации верстки и анализа трейсов Instruments при разработке на SwiftUI под iOS и macOS. CX Codex +1 36 800установок performance-profiling MengTo Скилл performance-profiling помогает находить зависания и утечки памяти в приложениях под платформы Apple. Направляет агента по инструментам Instruments и телеметрии MetricKit. CX Codex +1 1 700установок debugging-instruments dpearson2699 Скилл debugging-instruments помогает искать утечки памяти, зависания главного потока и сбои в iOS-приложениях через LLDB, Memory Graph Debugger и Instruments. CX Codex +1 4 400установок 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установок performance rshankras Скилл performance диагностирует медленные приложения, зависания и утечки памяти через Instruments, а также находит лишние перерисовки и проблемы идентификации представлений в SwiftUI. CX Codex +1 212установок

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

Весь набор →
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установок native-app-performance Скилл native-app-performance для анализа производительности нативных приложений через xctrace и Time Profiler. Записывает трассы, извлекает горячие места стека и показывает узкие места без открытия Instruments. CX Codex +1 251установок 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установок openclaw-relay Скилл openclaw-relay для Claude Code, Codex, Cursor и других агентных сред — пересылает промпты и сообщения в сессии OpenClaw через локальный acpx или SSH-транспорт. Работает с именованными алиасами сессий из config/session_aliases.json. CX Codex +1 120установок

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

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