跳转至

AI 辅助使用

perfetto-cli 通过 skills 系统与 Claude Code、Cursor、Codex、Gemini CLI 等 AI 编程助手集成。AI 工具能自动理解 perfetto-cli 的能力，以对话方式引导你进行 trace 分析。

工作原理

skills 系统将知识文件安装到 AI 工具的配置目录中。当你向 AI 询问 trace 分析相关问题时，它会自动知道如何使用 perfetto-cli — 该运行哪些命令、如何解读结果、下一步该做什么。

支持的 AI 工具：

工具 配置目录
Claude Code ~/.claude/skills/
Cursor ~/.cursor/skills/
Codex ~/.codex/skills/
Gemini CLI ~/.gemini/skills/
OpenCode ~/.opencode/skills/

安装 Skills

交互式安装

perfetto-cli skills install

启动交互式向导： 1. 展示可用的 skills 2. 检测系统中已安装的 AI 工具 3. 选择安装范围（全局或项目级） 4. 安装到选定的工具

一键安装全部

# 安装所有 skills 到所有检测到的工具（全局范围）
perfetto-cli skills install --all --target all --scope global

安装到指定工具

# 仅安装到 Claude Code
perfetto-cli skills install perfetto-cli-usage --target claude --scope global

# 仅安装到 Cursor
perfetto-cli skills install perfetto-cli-usage --target cursor --scope global

项目级安装

# 仅安装到当前项目（在项目根目录创建 .claude/skills/）
perfetto-cli skills install --all --scope project

项目级 skills 优先于全局 skills，适用于需要项目特定 AI 指导的场景。

查看安装状态

perfetto-cli skills list

展示每个 skill 在所有检测到的工具中的安装状态：

Skill: perfetto-cli-usage
Description: Guide for using perfetto-cli to analyze Android Perfetto trace files...
Status (global):
  ✓ claude     ~/.claude/skills/perfetto-cli-usage
  ✓ cursor     ~/.cursor/skills/perfetto-cli-usage
  ✗ codex      (not installed)
  - gemini     (not detected)

卸载 Skills

# 交互式卸载
perfetto-cli skills uninstall

# 从所有工具卸载指定 skill
perfetto-cli skills uninstall perfetto-cli-usage --target all --scope global

# 卸载全部
perfetto-cli skills uninstall --all --target all --scope global

配合 Claude Code 使用

安装 skills 后，你可以自然地与 Claude Code 对话：

> 我有一个 trace 文件 ./app-trace.perfetto-trace，应用感觉很卡

Claude 会自动：
1. 运行帧卡顿分析
2. 检查 CPU 热点
3. 查找 Binder 延迟问题
4. 给出诊断结果和下一步建议

对话示例

ANR 诊断： 

> 我的应用出了 ANR，帮我分析这个 trace：./anr-trace.perfetto-trace

Claude 执行：
  perfetto-cli -t ./anr-trace.perfetto-trace -p com.myapp anr detect
  perfetto-cli -t ./anr-trace.perfetto-trace -p com.myapp anr root-cause --anr-timestamp <ts>

全面性能检查： 

> 对 com.example.app 的这个 trace 做一次完整性能检查

Claude 执行：
  perfetto-cli -t trace.perfetto-trace -p com.example.app frame summary
  perfetto-cli -t trace.perfetto-trace -p com.example.app cpu utilization
  perfetto-cli -t trace.perfetto-trace -p com.example.app memory leak
  perfetto-cli -t trace.perfetto-trace -p com.example.app binder profile

抓取 Trace： 

> 从设备抓一个 15 秒的 trace

Claude 执行：
  perfetto-cli trace run --duration 15s -o ./traces

配合 Cursor 使用

安装 skills 后，Cursor 的 AI 助手能够：

  • 在终端中建议 perfetto-cli 命令
  • 内联解读 trace 分析结果
  • 基于性能数据提供修复建议

打开 Cursor 的终端，自然地向 AI 询问 trace 分析问题即可。

配合其他 AI 工具使用

skills 系统适用于任何支持 skills/ 目录的 AI 编程工具。skill 文件（SKILL.md）包含结构化的指导信息，帮助 AI 理解何时以及如何使用 perfetto-cli。

创建自定义 Skills

Skills 是包含 SKILL.md 文件的目录，文件使用 YAML frontmatter：

---
name: my-custom-analysis
description: 我的项目的自定义分析工作流
---

# 我的自定义分析

当用户询问 [特定场景] 时，运行：

\`\`\`bash
perfetto-cli -t <trace> -p com.myapp [commands...]
\`\`\`

将自定义 skills 放在项目根目录的 skills/ 目录下，然后用 perfetto-cli skills install 安装。

提示

  • 全局安装 (--scope global) 在所有项目中都可用，最方便
  • 项目级安装适用于有项目特定分析流程的场景
  • Skills 默认使用符号链接 — skill 文件更新后立即生效
  • 使用 --copy 标志创建独立副本而非符号链接
  • 使用 --force 覆盖已有安装