CommunityPesquisa e Análise de Dadosgithub.com

steipete/desempenho-de-app-nativo

Desempenho de aplicativos nativos: xctrace, Time Profiler, traces, hotspots.

O que é desempenho-de-app-nativo?

Esta skill capacita agentes de IA a realizar análise de desempenho de aplicativos nativos (macOS, iOS) diretamente pela linha de comando, sem a necessidade de abrir o Instruments. Ela utiliza a ferramenta `xctrace` do Xcode para gravar o perfil 'Time Profiler' de um processo em execução ou ao iniciar o aplicativo. Após a captura, scripts auxiliares extraem as amostras de tempo (time samples) em formato XML, obtém o endereço de carga (`__TEXT load address`) via `vmmap` para lidar com a aleatoriedade de layout de espaço de endereço (ASLR), e então simbolizam os rastreios usando `atos`, ranqueando as funções mais quentes (hotspots) sem depender da interface gráfica do Instruments. A skill suporta plataformas Apple (macOS, iOS) e é útil para desenvolvedores que precisam de automação ou análise remota de desempenho, com scripts em Python e shell incluídos para integração em pipelines ou workflows de IA. A funcionalidade principal é fornecer uma solução completa de profiling de CPU via CLI: iniciar ou anexar a um aplicativo, capturar rastreios, extrair amostras e gerar uma lista priorizada de hotspots simbolizados. As instruções detalhadas no SKILL.md alertam para práticas importantes como confirmar o binário correto (build local vs. /Applications), garantir que a funcionalidade lenta seja acionada durante a captura, e atualizar o caminho do binário e endereço de carga para cada nova build devido ao ASLR. Os scripts incluídos automatizam as etapas de gravação, extração e simbolização, tornando o processo eficiente e repetível.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/native-app-performance

Installed? Explore more Pesquisa e Análise de Dados skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Desempenho de App Nativo (apenas CLI)

Objetivo: gravar o Time Profiler via xctrace, extrair amostras, simbolizar e propor hotspots sem abrir o Instruments.

Início rápido (CLI)

  1. Gravar Time Profiler (anexar):
# Inicie o app você mesmo, depois anexe
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --attach <pid>
  1. Gravar Time Profiler (iniciar):
xcrun xctrace record --template 'Time Profiler' --time-limit 90s --output /tmp/App.trace --launch -- /caminho/App.app/Contents/MacOS/App
  1. Extrair amostras de tempo:
scripts/extract_time_samples.py --trace /tmp/App.trace --output /tmp/time-sample.xml
  1. Obter endereço de carga para simbolização:
# Enquanto o app estiver em execução
vmmap <pid> | rg -m1 "__TEXT" -n
  1. Simbolizar + ranquear hotspots:
scripts/top_hotspots.py --samples /tmp/time-sample.xml \
  --binary /caminho/App.app/Contents/MacOS/App \
  --load-address 0x100000000 --top 30

Notas de fluxo de trabalho

  • Sempre confirme que você está analisando o binário correto (build local vs /Applications). Prefira o caminho direto do binário para --launch.
  • Certifique-se de acionar o caminho lento durante a captura (abrir/fechar menu, atualizar, etc.).
  • Se as pilhas estiverem vazias, capture por mais tempo ou evite seções ociosas.
  • xcrun xctrace help record e xcrun xctrace help export mostram as flags corretas.

Scripts incluídos

  • scripts/record_time_profiler.sh: gravar via anexar ou iniciar.
  • scripts/extract_time_samples.py: exportar XML de time-sample a partir de um trace.
  • scripts/top_hotspots.py: simbolizar e ranquear os principais frames do app.

Armadilhas

  • ASLR significa que você deve usar o endereço de carga __TEXT em tempo de execução obtido do vmmap.
  • Se usar uma nova build, atualize o caminho --binary; os símbolos devem coincidir com o trace.
  • Fluxo apenas CLI: não há necessidade de abrir o Instruments se as pilhas forem simbolizadas via atos.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

steipete/agent-transcript

GitHub PR/issue agent transcripts: redact, preview, and insert safely.

steipete/beeper

Beeper cache: contact hints, room lookup, WhatsApp/iMessage traces, FTS.

steipete/browser-use

Existing Chrome automation: Chrome plugin first, mcporter fallback.

steipete/clawsweeper-status

ClawSweeper status: URLs, workflow health, active workers, ops snapshot.

steipete/clickclack

ClickClack ops: chat app, Hetzner deploy, DNS/docs/app, Docker rollout.

steipete/cloudflare-registrar

Cloudflare Registrar: domain availability, prices, registration via mcporter.

steipete/codex-debugging

Codex debugging: codex-rs core/tui/exec/cli/app-server/config.

steipete/create-cli

CLI UX/spec: args, flags, help, output, errors, config, dry-run.

steipete/discord-clawd

Discord-backed OpenClaw agent/session relay; not archive search.

steipete/domain-dns-ops

DNS/domain ops: registrars, zones, redirects, DNS/HTTP verify, manager truth.

steipete/frontend-design

Frontend UI: pages, apps, components, polished non-generic design.

steipete/github-author-context

GitHub contributor context: identity, activity, trust, company/team signal.

steipete/github-cache-hygiene

GitHub quota/cache hygiene: gh, ghx, xcache, gitcrawl, mirrors, limits.

steipete/github-deep-review

GitHub deep review: bugs, PRs, best fix, stale-or-real, read code first.

steipete/github-project-triage

GitHub issue/PR triage: queues, CI, blockers, risk, proof, next actions.

steipete/hopper-debugger

Hopper debugging: macOS/iOS binaries, ObjC/Swift symbols, dyld, LLDB.

steipete/instruments-profiling

Instruments/xctrace profiling: macOS/iOS traces, binaries, args, exports.

steipete/mac-maintenance

Mac upkeep: brew update/upgrade, pull clean repos, empty Trash.

steipete/maintainer-orchestrator

Open-source maintainer orchestration: Codex app workers, work recovery, dependencies, vision, releases.

steipete/markdown-converter

Markdown conversion: PDF, Office, HTML, data, OCR, audio, ZIP, YouTube.

Habilidades Relacionadas