Community研究&データ分析github.com

steipete/Instrumentsプロファイリング

Instruments/xctrace プロファイリング:macOS/iOS トレース、バイナリ、引数、エクスポート。

Instrumentsプロファイリング とは?

このスキルは、ネイティブアプリのパフォーマンスプロファイリングやスタック分析を実施するためのものです。主にmacOS/iOS向けのInstrumentsツールと`xctrace`CLIを活用し、Time Profilerテンプレートを使用したトレースの記録、バイナリの選択、エクスポート、トラブルシューティングをカバーします。開発者は、アプリ起動時や特定の処理中のCPU使用率の高いコードパスを特定し、コールツリーの解析やスタックデータのエクスポートによってボトルネックを効率的に発見できます。正しいバイナリを確実にプロファイルするためのガイダンスが含まれており、特にローカルビルドとインストール済みアプリの混同を防ぐためのチェックリストや注意点が重要です。iOSデバイスでのリモートプロファイリングやプライバシー権限の設定方法にも対応しており、アプリの最適化フローを自動化したいAIエージェントや開発者にとって有用なスキルです。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/steipete/agent-scripts/tree/main/skills/instruments-profiling

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Instruments プロファイリング (macOS/iOS)

このスキルは、ユーザーがネイティブアプリのパフォーマンスプロファイリングやスタック分析を必要とする場合に使用します。 焦点:Time Profiler、xctrace CLI、適切なバイナリ/アプリインスタンスの選択。

クイックスタート (CLI)

  • テンプレート一覧表示:xcrun xctrace list templates
  • Time Profiler 記録 (起動):
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --launch -- /path/To/App.app
  • Time Profiler 記録 (アタッチ):
    • アプリを自分で起動し、PID を取得して、次を実行:
    • xcrun xctrace record --template 'Time Profiler' --time-limit 60s --output /tmp/App.trace --attach <pid>
  • Instruments でトレースを開く:
    • open -a Instruments /tmp/App.trace

注意:xcrun xctrace --help は有効なサブコマンドではありません。xcrun xctrace help record を使用してください。

正しいバイナリの選択 (重要)

注意点:Instruments が異なるアプリをプロファイルする可能性があります(例:LaunchServices が別のバンドルに解決された場合)。 以下のルールに従ってください:

  • 確定的な起動のために、直接バイナリパスを優先:
    • xcrun xctrace record ... --launch -- /path/App.app/Contents/MacOS/App
  • .app を起動する場合は、意図したバンドルであることを確認:
    • open -n /path/App.app
    • ps -p <pid> -o comm= -o command= で確認
  • /Applications/App.app とローカルビルドの両方が存在する場合、ローカルビルドのパスを明示的にターゲットにする。
  • 起動後、プロセスのパスを確認してからトレースを信頼する。

コマンド引数 (xctrace)

  • --template 'Time Profiler':xctrace list templates のテンプレート名。
  • --launch -- <cmd>:-- 以降はターゲットコマンド(バイナリまたはアプリバンドル)。
  • --attach <pid|name>:実行中のプロセスにアタッチ。
  • --output <path>:.trace 出力。省略した場合、ファイルはカレントディレクトリに保存。
  • --time-limit 60s|5m:キャプチャ時間を設定。
  • --device <name|UDID>:iOS デバイス実行時に必須。
  • --target-stdout -:起動したプロセスの標準出力をターミナルにストリーム(CLI ツールに便利)。

スタックのエクスポート (CLI)

  • トレーステーブルの調査:
    • xcrun xctrace export --input /tmp/App.trace --toc
  • 生のタイムプロファイルサンプルをエクスポート:
    • xcrun xctrace export --input /tmp/App.trace --xpath '/trace-toc/run[@number="1"]/data/table[@schema="time-profile"]' --output /tmp/time-profile.xml
  • スクリプト(Python/Rust)で後処理し、スタックを集計。

Instruments UI ワークフロー

  • テンプレート:Time Profiler
  • 「Record」を使用し、遅いパスをキャプチャ(起動時 vs 定常状態)
  • Call Tree のヒント:
    • Hide System Libraries
    • Invert Call Tree
    • Separate by Thread
    • ホットフレームとコール数に注目

注意点と修正

  • 間違ったアプリがプロファイルされる:LaunchServices がインストール済みアプリをローカルビルドの代わりに解決する。
    • 修正:直接バイナリパスを使用するか、既知の PID で --attach を使用。
  • サンプルが取得されない/空のトレース:アプリがすぐに終了するか、処理が実行されない。
    • 修正:より長いキャプチャ時間、録画中にワークロードをトリガー。
  • プライバシープロンプト:xctrace に Developer Tools 権限が必要な場合がある。
    • 修正:システム設定 → プライバシーとセキュリティ → デベロッパツール → ターミナル/Xcode を許可。
  • XML エクスポートが大きい:time-profile エクスポートは巨大になる。
    • 修正:XPath でフィルタリングし、オフラインで集計。ターミナルに出力しない。

iOS 固有の注意事項

  • デバイス:xcrun xctrace list devices と --device <UDID> を使用。
  • 必要に応じて Xcode から起動し、xctrace --attach でアタッチ。
  • 意味のあるスタックを得るためにデバッグシンボルを確保。

確認チェックリスト

  • トレースプロセスパスがターゲットビルドと一致することを確認。
  • スタックに期待するアプリフレームが表示されていることを確認。
  • キャプチャが遅い操作(起動/更新)をカバーしていること。
  • 最適化時の自動差分比較のためにスタックをエクスポート。

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/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.

steipete/nano-banana-pro

Nano Banana/Gemini image gen/edit: text/image input, 512-4K workflows.

関連スキル