Android CLI 与 Skills：提升 AI Coding 效率

随着 AI Agent 在软件开发领域的快速发展，Android 应用开发迎来了全新的"Agent-First "工作流。Google 推出的 Android CLI 和 Android Skills，正是为 AI Agent量身打造的工具集，帮助开发者利用任意 AI Agent（如 Gemini、Claude、Cursor 等）更快、更规范地构建高质量 Android 应用。

据官方介绍，使用 Android CLI 可将应用构建速度提升至原来的 3 倍，同时显著降低 LLM token 消耗（内部实验显示项目与环境设置阶段 token 使用量减少 70% 以上），并确保代码严格遵循 Android 最新最佳实践。

一、当前 Android 应用 AI Coding 的痛点

尽管 AI Coding Agent 在代码生成速度上表现出色，但传统 Android 开发仍存在明显瓶颈：

• 需要通过脆弱的自定义脚本或手动步骤与 Android SDK、Gradle、模拟器等交互，易因路径配置、权限、工具版本差异导致中断。
• 大模型容易产生"幻觉"，在处理 Gradle 配置、SDK 管理、UI 导航等复杂流程时频繁出错。
• 知识滞后：模型训练数据无法实时跟进 Android 的最新 API、架构变更和最佳实践。

示例：要求 Claude Code 创建一个 Android 模板应用时，模型会先规划 TODO List，再逐步生成代码、Gradle 脚本，期间还需编译、校验、修复 bug，整个过程往往耗时约 10 分钟。

而应用 Android CLI 后，同一任务几乎瞬间完成模板创建、版本升级和编译，总耗时不超过 3 分钟，效率提升显著。

---

二、 Android CLI

Android CLI 是专为智能体优先（agent-first）工作流设计的命令行接口。它将 Android 开发的众多核心任务标准化，提供统一的 android 命令入口，让 AI Agent能够可靠、高效地与 Android 工具链交互。

不同于传统脚本，大模型可直接调用 CLI 指令（如 android create），避免一行一行手动编写易错的配置代码。

2.1 快速安装与基础配置

Linux / macOS / Windows 安装（推荐使用官方一键脚本）：

# Linux x86_64 示例（其他平台请访问官网）
curl -fsSL https://dl.google.com/android/cli/latest/linux_x86_64/install.sh | bash

# macOS Apple Silicon
curl -fsSL https://dl.google.com/android/cli/latest/darwin_arm64/install.sh | bash

# 验证安装
which android   # 或 command -v android

# 更新至最新版本
android update

详细多平台安装指令及归档下载：developer.android.com/tools/agent...

2.2 应用于 AI Coding Agent

初始化环境（关键步骤，会自动将 android-cli 技能注入到常用 AI Agent）：

android init

执行后会看到类似输出：

Initializing android-cli skill...
Skill 'android-cli' installed to ~/.claude/skills/android-cli
Skill 'android-cli' installed to ~/.gemini/skills/android-cli

技能（Skills）是根据场景自动触发的专家级指令集，可通过对话让 AI 帮你创建/管理。

2.3 高频核心命令

项目与模板管理

• android create list ------ 列出可用项目模板
• android create --output=./MyApp empty-activity-agp-9 ------ 基于模板快速创建新项目（支持 AGP 9 等现代配置）
• android describe ------ 解析项目结构，输出构建产物路径（便于 Agent 定位 APK、测试报告等）

模拟器管理

• android emulator create --profile=medium_phone ------ 创建手机模拟器
• android emulator list ------ 列出已创建设备
• android emulator start <设备名> ------ 启动模拟器
• android emulator stop <序列号> ------ 停止模拟器（Windows 暂不支持）

SDK 包管理

• android sdk list --all ------ 查看所有可安装/已安装 SDK 包
• android sdk install platforms/android-34 build-tools/34.0.0 ------ 安装指定版本 SDK 与构建工具
• android sdk update ------ 更新全部 SDK 至最新稳定版
• android sdk remove <包名> ------ 卸载指定组件

应用部署与界面操作

• android run --apks=app-debug.apk ------ 直接部署 APK 到设备/模拟器
• android screen capture --annotate --output=ui.png ------ 设备截图附带支持 UI 元素标注
• android screen resolve --screenshot=ui.png --string="input tap #5" ------ 将标注转为坐标，用于实现自动化点击
• android layout --pretty ------ 以 JSON 输出当前界面布局树（支持差异对比与保存）

知识库与信息查询

• android docs search <关键词> ------ 检索官方知识库
• android info ------ 查看默认 SDK 路径
• android --sdk=<路径> <命令> ------ 临时切换 SDK（不修改全局环境变量）

Android CLI 不仅服务于 AI Agent，开发者也可手动在终端执行，极大简化日常开发流程。

---

三、Android Skills

Android Skills 是面向 AI 优化的模块化指令集，遵循开放的 Agent Skills 标准（agentskills.io/）。它们帮助大模型快速... Android 专属最佳实践，解决知识滞后、专业流程不规范等问题，实现可复用、标准化的专家级开发。

3.1 技能管理常用命令

# 列出所有可用技能
android skills list

# 安装指定技能
android skills add --skill=edge-to-edge

# 为指定 Agent 安装技能
android skills add --agent=gemini edge-to-edge

# 搜索相关技能
android skills find performance

# 卸载技能
android skills remove --agent=gemini --skill=edge-to-edge

# 安装全部可用技能
android skills add --all

3.2 当前可用 Skills（2026 年 4 月）

• play-billing-library-version-upgrade：自动升级 Google Play Billing Library，处理废弃 API 迁移，确保合规与新功能支持。
• navigation-3：指导迁移或设置 Jetpack Navigation 3，实现现代、可靠的导航结构。
• edge-to-edge：实现 Edge-to-Edge UI 现代化，使界面延伸至屏幕全区域（包括系统栏），符合最新设计规范。
• r8-analyzer：审计并优化 R8 配置，提升 App 性能并减小包体积。
• migrate-xml-views-to-jetpack-compose：提供结构化的 10 步方法，安全稳定地将 XML 布局迁移到 Jetpack Compose。
• agp-9-upgrade：帮助升级 Android Gradle Plugin (AGP) 9，自动处理依赖更新、DSL 变更、Kapt 迁移等 breaking changes。

更多 Skills 持续更新，源码库：github.com/android/ski...

安装示例（以 navigation-3 为例）：

android skills add --skill=navigation-3

安装成功后，AI Agent（如 Claude Code）即可在相关任务中自动调用该技能，给出专业、符合最佳实践的迁移建议或代码。

Skill 'navigation-3' installed to /home/link/.claude/skills/navigation-3
Skill 'navigation-3' installed to /home/link/.gemini/skills/navigation-3
Skill 'navigation-3' installed to /home/link/.trae-cn/skills/navigation-3

示例：在 claude code 使用 navigation3 skill 。

接着，大模型就会给出专业的迁移或改进建议。

---

四、最佳实践

以下实践基于 Google 官方 Android CLI + Skills 的 agent-first 工作流，经过验证，能显著降低 token 消耗、减少幻觉，并让 AI 产出更高质量、可维护的 Android 代码。

1. 项目启动阶段：使用 Android CLI 创建项目（避免手动或 AI 瞎写 Gradle）

为什么重要：AI 单独写 Gradle 配置和项目结构时极易出错（版本冲突、AGP 配置错误等），使用 CLI 可确保从第一行代码就符合官方最佳实践。

落地步骤：

• 先安装skills：android skills add --all
• 运行 android create list 查看可用模板。
• 使用命令快速创建：android create --output=./XXXXApp empty-activity-agp-9 --min-sdk=24

提示词示例：

使用 android CLI 创建的项目位于 ./MyTodoApp，请基于此项目继续开发。严格遵循已安装的 Skills（navigation-3、edge-to-edge 等）。

这样项目初始化时间可以从 8-10 分钟缩短到 1-2 分钟，token 消耗减少 50% 以上。

任务拆分 + 明确 Scope 原则（小步迭代，避免大范围重构）

AI 在大任务中容易幻觉或破坏现有代码，拆分成小任务 + 明确范围能大幅提高成功率。

落地步骤：

• 每次只让 AI 处理 一个文件 或 一个明确功能。
• 要求 AI 先输出计划（Plan），再执行。
• 使用 android describe 让 AI 先了解项目结构。

提示词模板：

在本项目中使用 navigation-3 skill。 任务：仅修改 app/src/main/java/com/example/MainActivity.kt 文件，实现 XXX 功能。 步骤：

1. 先使用 android describe 分析当前项目结构和现有导航方式。
2. 输出修改计划（涉及哪些文件、依赖变更）。
3. 只输出需要修改的代码块，并说明变更理由。
4. 修改后运行 android run 测试。

这样可以减少"全屏重写"风险，代码审查更容易通过。

---

五、总结

将 Android CLI 和 Android Skills 结合使用，能显著提升 AI Coding Agent 在 Android 开发中的编程效率：

• 自动化端到端流程，从项目创建到部署测试高度自动化。
• 减少幻觉与错误，通过官方 Skills 和标准化 CLI 操作，Agent 行为更可靠。
• 灵活性与兼容性强，支持多种 AI 工具，同时享受 Google 官方工具链优势。

官方资源：

• Android CLI 与 Skills 总览：developer.android.com/tools/agent...

• Android CLI 文档：developer.android.com/tools/agent...

• Android Skills 文档：developer.android.com/tools/agent...

• Skills GitHub：github.com/android/ski...

以上就是我简单试用两天后，总结的一些经验与看法，希望对你所有帮助。

（本文使用Grok fast辅助完成全文编写）