# ios-ettrace-performance

Скилл ведёт замер узкого iOS-сценария через ETTrace: от подбора dSYM до разбора по потокам. Нужен для сопоставимых замеров запуска или работы приложения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 установок · ★ 1237
- Автор: dpearson2699
- Лицензия: LicenseRef-Unknown · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/ios-ettrace-performance/SKILL.md
- Обновлён: 2026-07-31
- HTML: https://affpapa.org/nevibecode/skills/dpearson2699-ios-ettrace-performance

## Что делает

Скилл задаёт порядок работы с ETTrace для ограниченного сценария: фиксирует условия захвата, собирает dSYM по UUID финальной сборки и сохраняет обработанные `output_<threadId>.json`. Он различает запуск и замер уже работающего приложения, а также Simulator и устройство.

Внутри есть команды для установки ETTrace через Homebrew, скрипты `scripts/collect_dsyms.py` и `scripts/analyze_ettrace.py`. Анализатор проверяет формат вывода v1.1.1, сводит данные по потокам, показывает включительное и исключительное время, а проблемные адреса относит к `unresolved_frames`. Для работы нужны Python 3, ETTrace и подключение пакета ETTrace к измеряемой цели приложения. Если важные кадры остаются `<unknown>`, это повод сначала исправить символикацию, а не менять код.

Скилл просит повторять один и тот же сценарий после минимального изменения и не сравнивать захваты с разными условиями. Для общего поиска CPU-проблем, зависаний, ввода-вывода или конкуренции он направляет к Instruments.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill ios-ettrace-performance -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill ios-ettrace-performance -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill ios-ettrace-performance -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dpearson2699/swift-ios-skills ios-ettrace-performance
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill ios-ettrace-performance -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/ios-ettrace-performance
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dpearson2699/swift-ios-skills --skill ios-ettrace-performance -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dpearson2699/swift-ios-skills/tree/HEAD/skills/ios-ettrace-performance/SKILL.md

## Когда брать
- собрать dSYM, совпадающие с UUID сборки
- захватить запуск приложения в Simulator
- разобрать JSON-профили ETTrace по потокам
- найти кадры без символов и неверную атрибуцию
- сравнить замеры одного iOS-сценария

## Примеры запросов агенту
- «Сними ETTrace-профиль запуска iOS-приложения в Simulator и проверь dSYM по UUID.»
- «Разбери `output_*.json` через `scripts/analyze_ettrace.py` и покажи горячие кадры.»
- «Повтори ETTrace-замер после изменения, сохранив те же условия захвата.»

## Похожие
- [swiftui-performance-audit](https://affpapa.org/nevibecode/skills/swiftui-performance-audit.md) — скилл · 109 установок
- [android-performance](https://affpapa.org/nevibecode/skills/android-performance.md) — скилл · 19 установок
- [performance-profiling](https://affpapa.org/nevibecode/skills/mengto-performance-profiling.md) — скилл · 1400 установок
- [axiom-performance](https://affpapa.org/nevibecode/skills/axiom-performance.md) — скилл · 1300 установок
- [performance-engineer](https://affpapa.org/nevibecode/skills/performance-engineer.md) — скилл · 918 установок
- [agent-performance-engineer](https://affpapa.org/nevibecode/skills/agent-performance-engineer.md) — скилл · 555 установок

## Другие версии с тем же именем
- [ios-ettrace-performance · openai](https://affpapa.org/nevibecode/skills/ios-ettrace-performance.md) — 87 установок

Из того же набора: [dpearson2699/swift-ios-skills](https://affpapa.org/nevibecode/by/dpearson2699/swift-ios-skills.md) — 69 карточек

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