⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.6.0

ios-trace

@kmgcc⭐ 9 stars

Agent-native runbook for evidence-based profiling and optimization of native iOS and iPadOS apps with xctrace and Xcode Instruments on physical devices or simulators. Use for CPU or battery use, memory growth or Jetsam, UI hitches, slow launch, concurrency stalls, audio glitches, or network activity. Choose instruments and workload reproduction to fit the issue; bundled scripts are optional helpers.

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

Adopt or update this skill from https://proskills.md/skills/other/kmgcc-ios-trace. First identify the installation path supported by this platform, detect whether it is already installed, compare the installed version with the latest stable release, show me what will change, and only then install or update it. If no native installer is available, use the complete package or source fallback described on the page.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars

⭐ 9 on GitHubGitHub ↗

New / niche

🟢ProSkills Score

—

📍

Not yet listed on ClawHub or SkillsMP

// README

iOS-Trace

中文 | English

需要 macOS 桌面应用性能分析？见 macOS-Trace。

面向 AI 编码 Agent 的 iOS / iPadOS 性能分析 runbook。Agent 根据真实症状和目标设备选择 Instruments、复现路径与验收证据；真机与模拟器各有不同测量边界。附带脚本仅是可选的数据处理工具，不是固定执行流程。

前置条件

macOS 上可用的 Xcode 或 Command Line Tools；目标支持范围由当前 Xcode 与设备 OS 决定。Xcode 27 要求 macOS Tahoe 26.6 或更新版本，并仅支持 Apple silicon Mac。
真机需在线、解锁并信任此 Mac；真机 attach 和 UI 测试还受签名、Developer Mode 与系统版本影响。
Python 3.8+ 仅用于可选脚本。

安装

推荐：skills CLI

npx skills add kmgcc/iOS-Trace

使用 -g 安装到用户级目录；可用 -a 选择 CLI 支持的 Agent。

手动安装

Agent	用户级全局目录
Codex	`~/.agents/skills/ios-trace`
Antigravity	`~/.gemini/config/skills/ios-trace`
DSH	`~/.dsh/skills/ios-trace`
Claude Code	`~/.claude/skills/ios-trace`
Cursor	`~/.cursor/skills/ios-trace`
OpenCode	`~/.config/opencode/skills/ios-trace`

把仓库内容放入对应目录即可。具体发现路径可能随 Agent 版本变化；项目级安装请遵循该 Agent 当前文档。

使用

要求 Agent 使用 ios-trace 调查明确的用户场景，例如真机滚动掉帧、发热、启动变慢、音频断续或内存增长。Agent 会按目标选择设备、采样器、复现方式和对比方法；不需要先运行固定脚本。

文档地图

SKILL.md — 核心执行 runbook。
references/templates.md — Instruments 选择指南与 Xcode 27 增强项。
references/workload-reproduction.md — 按问题选择真机或模拟器的复现路径。
references/device-commands.md — 设备发现、进程确认、xctrace 能力发现、记录与导出。
references/storage-and-recovery.md — Mac 主机临时空间、已删除但仍打开的 .ktrace 诊断与安全恢复。
references/xcode-agent-mcp.md — 可选 Xcode MCP 工作流及权限边界。
references/subsystems.md — 射频、ProMotion、媒体解码、音频等优化线索。

使用边界

模拟器结果适合部分 CPU、逻辑和 UI 排查，不能证明真机功耗、射频或热表现。
trace 可能包含提示词、路径、媒体或日志信息，按敏感任务数据处理。
MCP 是可选的 Xcode 项目/开发集成；运行时性能证据来自 Instruments。
遵循项目自身的进程、设备、数据所有权、构建、测试和发布规则。

License

MIT License。见 LICENSE。

// HOW IT'S BUILT

KEY FILES

SKILL.mdREADME.md

// REPO STATS

9 stars

// SHARE

Share on X Share on LinkedIn