Android 工程师的 AI 搭档：Android CLI + Skills 实战笔记

这不是一篇普通的安装教程而是一次完整的探索从搭建环境、安装专业知识模块到让 AI 真正读懂你的 Android 工程。过去我们依赖 Android Studio、Gradle、adb 完成开发闭环。但当 AI 能理解业务逻辑时我们更希望它能像一个资深同事一样看懂工程结构、审查 R8 规则、分析性能瓶颈甚至直接查阅官方文档给出建议。Google 推出的Android CLI和Skills 体系正是为此而来。我花了一些时间走通了完整链路记录下关键步骤、踩坑经验以及真正能落地的使用场景。一、新老工具定位很多开发者容易把 Android CLI 和sdkmanager搞混简单区分一下传统 SDK 工具链sdkmanager、adb 等负责 SDK 下载、设备调试、APK 构建。Android CLI新负责 AI Agent 能力管理为工程安装特定领域的分析技能也能直接查询官方文档。两者并不冲突而是这样协作Android CLI ├── 管理 Android SDK传统能力 └── 管理 Android SkillsAI Agent 知识模块 ├── R8 分析 ├── Perfetto 分析 ├── 官方文档检索 └── 安全/导航/AGP 升级等二、Skill 是什么你可以把 Skill 理解为AI Agent 的专业知识包。比如r8-analyzer这个 Skill它能指导 AI 审查你的 ProGuard 规则、分析 keep 规则合理性、给出 APK 瘦身建议。每个 Skill 都包含一个SKILL.md核心文件里面用 YAML 定义了名称、使用场景和分析准则。安装后你的 AI Agent 就相当于拥有了这个领域的专家经验。三、安装 Android CLI一行命令搞定curl-fsSLhttps://dl.google.com/android/cli/latest/darwin_arm64/install.sh|bash成功后确认版本android update# Already up-to-date with version 1.0.15857036四、实战安装r8-analyzerSkill下面记录安装过程中遇到的三个实际问题及解决办法这是文章最有价值的部分。1. 命令格式变化最初我按老文档执行android skillsadd--skillr8-analyzer--project.报错Unknown option。新版用法是直接跟 Skill 名称android skillsaddr8-analyzer经验优先用android skills list查看可用名称Skill 的注册名来自SKILL.md里的name字段不是文件夹名。2. GitHub 下载失败android skillsfindr8# Failed to connect to github.com/android/skills...怀疑是网络问题但用 curl 直接请求同一个地址却能正常下载并拿到 693KB 的 zip 包。说明网络通畅是 Android CLI 在下载环节出了问题。验证方法# 手动下载 skill 包curl-Lhttps://github.com/android/skills/releases/download/v1.0.5/android-skills.zip-o/tmp/android-skills.zip# 查看 skill 是否存在unzip-l/tmp/android-skills.zip|grepr8# 输出performance/r8-analyzer/确认 Skill 确实存在于官方包中。3. 缓存问题导致列表不完整检查本地缓存find~/.android ~/.cache ~/.local-iname*skill*# ~/.android/cli/skills发现里面只有android-cli说明 Skill Registry 没有同步完整。解决办法清空缓存后重新拉取rm-rf~/.android/cli/skills android skills list# 现在能看到r8-analyzer, perfetto-trace-analysis 等全部 skill之后android skills add r8-analyzer成功安装。五、国内网络注意事项Skill 下载走的是github.com/android/skills/releases国内访问 GitHub 时常会出现连接失败这是主要门槛。简单有效的处理方式给终端设置代理export https_proxy...或手动下载 Skill 包后放入本地缓存目录一旦下载成功、缓存到本地后续分析完全离线不再依赖 GitHub。所以第一次下载时稍加处理即可并不是用不了。六、推荐安装的几个 Skills基于目前的实用性这几个值得一试r8-analyzerAPK 瘦身、ProGuard 规则优化perfetto-trace-analysis卡顿、主线程阻塞分析perfetto-sql用 SQL 深度查询 trace 数据agp-9-upgrade辅助迁移到 Android Gradle Plugin 9android-intent-security扫描 Intent 安全漏洞七、实际使用场景从查文档到自动化分析安装只是第一步真正有趣的地方在于把 CLI 和 Skills 融入日常开发流程。下面两个场景是我正在实践的用法。场景一让 AI Agent 直接查阅官方文档传统方式是你打开 developer.android.com搜索、筛选、对照版本差异。用 Android CLI 之后你的 Agent 可以直接android docsCompose 中 recomposition 的优化策略CLI 从官方文档库检索并返回结构化答案这意味着回答基于最新文档不是过时的博客或训练数据能区分 API 版本差异Agent 可以把官方知识直接融入你的工程上下文实际价值做技术方案调研时Agent 能在一个窗口内完成查官方文档 → 对照当前工程 → 给出建议的完整闭环。场景二用 Skills 做自动化分析与测试安装好 Skills 后Agent 可以自动完成专业领域的分析任务R8 优化审查Agent 能检查冗余的 keep rules、识别缺失的反射保护、给出 APK 体积优化建议。以前需要手动对照文档一条条审查现在 Agent 直接输出报告。Perfetto 性能分析录一段 traceAgent 自动找出主线程阻塞点、识别过度绘制、分析 Binder 调用瓶颈生成优化建议。性能排查从肉眼翻 trace变成读报告。安全漏洞扫描Agent 自动扫描工程找出不安全的 Intent 处理、未保护的 exported component、权限缺失等问题。这两个场景串联起来你设想的调用 CLI 查文档 用 Skills 做测试就是一个完整工作流需求评审 ↓ Agent 查官方文档android docs ↓ Agent 分析现有工程Skills ↓ Agent 给出方案 改动建议 ↓ Agent 验证改动影响Skills 再次分析这比单纯用通用 AI 强在知识来源是官方文档而非可能过时的训练数据分析基于工程实际代码而非凭空猜测Skills 提供领域专业知识而非泛泛而谈。八、这到底意味着什么这次实战走通了完整链路安装 CLI → 同步 Skill Registry → 下载 Skill → 安装生效 → 接入 Agent 工作流。未来性能优化、构建排查、安全审计等场景都会沉淀为标准 Skill。Android CLI 不是一个普通的命令行工具它是 Google 为 Android 工程师搭建的AI Agent 能力入口而 Skills 就是上面最宝贵的拼图。你的 Agent 可以随时调用官方文档、随时启用专业分析能力这件事本身正在改变我们和 Android 工程交互的方式。相关推荐Cursor 智能代码编辑器新手入门指南adb 常用命令汇总