# instruments-profiling

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 242 установки · ★ 7554 у репозитория
- Автор: steipete
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/steipete/agent-scripts/tree/HEAD/skills/instruments-profiling/SKILL.md
- Обновлён: 2026-10-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/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.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill instruments-profiling -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/instruments-profiling/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/instruments-profiling/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill instruments-profiling -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/instruments-profiling/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill instruments-profiling -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/instruments-profiling/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install steipete/agent-scripts skills/instruments-profiling
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/instruments-profiling/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill instruments-profiling -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/steipete/agent-scripts --path skills/instruments-profiling
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/instruments-profiling/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add steipete/agent-scripts --skill instruments-profiling -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/steipete/agent-scripts/tree/HEAD/skills/instruments-profiling/SKILL.md

## Когда брать
- записать 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.

## Похожие
- [swiftui-expert-skill](https://affpapa.org/nevibecode/skills/swiftui-expert-skill.md) — скилл · 36800 установок
- [performance-profiling](https://affpapa.org/nevibecode/skills/mengto-performance-profiling.md) — скилл · 1700 установок
- [debugging-instruments](https://affpapa.org/nevibecode/skills/debugging-instruments.md) — скилл · 4400 установок
- [argent-native-profiler](https://affpapa.org/nevibecode/skills/argent-native-profiler.md) — скилл · 32400 установок
- [swiftui-performance](https://affpapa.org/nevibecode/skills/swiftui-performance.md) — скилл · 5000 установок
- [performance](https://affpapa.org/nevibecode/skills/rshankras-performance.md) — скилл · 212 установок

Из того же набора: [steipete/agent-scripts](https://affpapa.org/nevibecode/by/steipete/agent-scripts.md) — 20 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
