1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | android-profiler-android-skills |
| 作者/维护者 | Google LLC |
| 来源链接 | https://github.com/android/skills/tree/main/profilers/android-profiler |
| 许可证 | Apache License 2.0（数据来自 GitHub API） |
| GitHub Stars | 所属合集仓库 android/skills 整体 7,317（数据来自 GitHub API；该数字属整个合集，不代表本技能自身热度） |
| Forks | 477（同上，属合集整体数字） |
| 最新版本 | 由 PR #132 “Unified Android profiler skill” 于 2026-08-17 合并创建（数据来自 GitHub API 提交记录） |
| 安装方式 | Android CLI 一条命令，或手动复制目录到 Agent 技能目录 |
2. 功能介绍与亮点
- 一个性能剖析编排器：整合此前分散的
perfetto-sql（SQL 查询）与perfetto-trace-analysis（trace 分析）两个技能，围绕“录制—分析”两阶段统一为单一技能，覆盖系统 trace、Java/Native 堆转储、方法采样、内存分配等主流剖析场景。 - 意图消歧路由：先明确用户想“录制什么”或“分析什么”，再路由到对应工作流；复合请求会拆解为顺序计划并逐步确认，避免一次性乱执行。
- 按子系统组织的分析提示库：CPU、图形、I/O、IPC、内存、电量六个子系统各有专家提炼的要点文件，并附触发条件与深挖指南，而非一份笼统的“怎么读 trace”说明。
- 录制侧提供现成配置模板：内置 7 份可直接复用的 Perfetto 采集配置，并调用官方 helper 脚本完成设备端采集，不要求手写原始
adb命令。 - 也支持编写、调试、执行临时 SQL 查询以直接检索 trace 数据，覆盖工作流未覆盖的定制排查场景。
- 全部 41 个文件（编排器、工作流、子系统提示、示例配置）经逐一核实路径与内容均真实存在，未发现文档承诺的脚本缺失情况。
3. 适用场景
所属固定分类：工程效率与代码质量——该技能的核心是辅助开发者定位并修复应用的性能缺陷（卡顿、内存泄漏、启动慢、耗电异常等），属调试/优化类工具，与库内 --neighbors "性能分析 内存泄漏 trace 调试" 命中的 38 条同类技能中占比最高（19/38）的分类一致。
适用人群：几乎所有需要排查 Android 应用性能问题的开发者与团队——无论是新功能上线前的性能验收、线上卡顿/内存泄漏的事后排查，还是持续的启动耗时与电量优化，都能通过描述症状（如“这里为什么卡顿”“帮我看这份 trace 里的内存泄漏”）让 Agent 自动匹配到对应工作流，无需开发者自己先学会 PerfettoSQL 或记住 adb 采集参数。
4. 跨 Agent 兼容性
- Claude Code：⚠️ 需适配。技能目录本身是标准 SKILL.md + YAML frontmatter + references 结构，遵循开放的 Agent Skills 规范，可手动复制到
.claude/skills/使用；但官方 Android CLI 安装器默认只为 Gemini 与 Antigravity 生成技能目录，不会自动识别 Claude Code。 - Codex：⚠️ 需适配，理由同上——技能内容本身与 Agent 无关（纯 Markdown + 标准 shell/adb/gradle 命令），但需手动放置或显式指定安装目标。
- OpenClaw：❓ 未验证。
- Hermes Agent：❓ 未验证。
判断依据：核对 android/skills 仓库 README「Install Android skills」章节，其官方安装命令 android skills add <skill> --project=. 明确写明“若未指定 --agent 且未检测到现有 Agent 目录，默认为 Gemini 与 Antigravity 安装”，未将 Claude Code / Codex 列入默认安装目标。
5. 推荐理由
Google 官方将两个此前独立、且用户使用中已出现路径失效问题的性能剖析技能重新整合为一个结构清晰的编排器，覆盖几乎每个 Android 团队都会遇到的“卡顿/内存泄漏/启动慢”排查刚需，文档深度与工程严谨度（41 个文件、按子系统拆分的专家提示、可复用采集配置）在同池技能中位居前列。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | Google LLC 官方出品（Android 平台所有者本身）；所属合集仓库整体 7,317★ 不代表本技能自身热度，且该技能 2026-08-17 才由两个旧技能合并而成、暂无独立于合集之外的第三方讨论证据 |
| 可用性 | 8 | 41 个文件的完整文档树逐一核实真实存在、无缺失脚本；意图路由清晰、复合请求分步确认；录制侧提供可直接复用的采集配置模板，无需手写原始命令；扣分点是该技能刚合并创建（历史仅 1 次提交），且完整流程依赖已连接的 Android 设备/模拟器与 adb 环境，非纯文本类“复制即用” |
| 安全性 | 9 | 官方出品、完全开源可审计；执行的 shell 命令（gradle 任务、adb、Python 脚本）均为本地开发调试范围，用途在文档中逐条说明；运行时会从 raw.githubusercontent.com/google/perfetto 下载官方 helper 脚本，来源透明可核实；无需任何第三方 API key 或凭据；License 明确 |
安全检查清单：
① Shell 命令：执行 ./gradlew 相关任务、adb 设备交互命令及本地 Python 脚本，范围限于本机开发/调试环境，文档逐条说明用途。
② 联网外发：录制工作流会从 raw.githubusercontent.com/google/perfetto 下载官方 helper 脚本；目标域名透明、属 Google 官方仓库，未发现向不明第三方外发数据。
③ API key/凭据：无需任何 API key 或账号凭据。
④ 可疑指令：逐份核对全部正文，未发现要求 Agent 顺带推广或访问无关文件/凭据的指令。
⑤ 作者信誉：Google LLC 官方维护（Android 平台团队），无造假迹象；创建 PR（#132）经 25 条内部代码评审意见后合并。
⑥ License：Apache License 2.0，明确。
⑦ 维护时间：所属仓库最近一次提交为 2026-09-07（数据来自 GitHub API），整体活跃；本技能自身自 2026-08-17 合并创建后暂无后续修改提交。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 差异 |
|---|---|---|
| Perfetto 官方 Agent Skill（google/perfetto 仓库自带，随 Claude Code/Codex 插件市场分发） | 覆盖 Android、Linux、Chrome、GPU/CUDA 全平台的 trace 分析与查询技能，附带自动下载的 trace_processor 引擎与配套评测（eval）体系 |
平台覆盖面更广，且有独立的评测框架验证改动质量；但只聚焦“trace 文件本身怎么读”，不包含 Android 特有的 AGP/Gradle 集成建议、R8 保留规则分析等 Android 工程侧扩展能力 |
| r8-analyzer（同仓库 android/skills） | 专注分析 R8/Proguard 保留规则、定位冗余或过宽规则以缩减包体积 | 解决的是“包体积与混淆规则”问题，与本技能“运行时性能与内存”问题是两类不同的优化维度，可搭配使用而非互相替代 |
差异化在于：本技能是 Android 生态下“从症状描述到具体剖析工作流”的一站式路由入口，覆盖录制到分析的完整闭环，而非单纯的 trace 查询引擎或单点优化工具。
8. 用户评价
该技能目前在第三方平台尚无具名用户评价；创建该技能的 GitHub PR #132 收到 25 条内部代码评审意见并已合并，但评审者均为项目内部协作者，不构成独立第三方评价。
9. 安装使用方式
方式一：Android CLI（官方，需先安装 Android CLI）
android skills add android-profiler --project=.未指定 --agent 时默认为 Gemini 与 Antigravity 自动安装；面向 Claude Code / Codex 需显式使用 --agent 参数，或使用下方手动方式。
方式二：手动安装（适用于 Claude Code / Codex）
从 https://github.com/android/skills/tree/main/profilers/android-profiler 下载整个目录（含 SKILL.md、recording/、analysis/、references/），整体复制到项目对应 Agent 的技能目录（如 .claude/skills/android-profiler/）。
安装后注意事项：向 Agent 描述具体的性能排查诉求（如“帮我分析这份 trace 里为什么卡顿”“录一份内存分配采样”），Agent 会自动匹配并按需读取子工作流文件；无需重启，生效范围仅限当前项目/会话；首次使用录制类工作流前需保证 Android 设备已开启开发者选项与 USB 调试，并处于 USB 连接状态。
10. 注意事项
- 该技能由两个旧技能（
perfetto-sql、perfetto-trace-analysis）于 2026-08-17 合并而来；若此前保存过旧技能目录的本地副本，建议改用新路径，避免新旧版本混用。 - 录制类工作流依赖已连接的真机或模拟器及
adb环境，纯代码分析场景（已有 trace 文件）则无此要求。 - 官方 Android CLI 默认不会为 Claude Code / Codex 自动安装，需按第 9 章手动处理。
- OpenClaw、Hermes Agent 兼容性未经验证，建议先小范围试点。
- 技能刚完成合并重构，暂无长期使用积累的问题反馈，建议关注仓库后续更新。