Android Skills 官方说明解读：Google 给 AI Agent 的 Android 开发 SOP

Android Skills 是 Google 官方给 AI Agent 准备的 Android 开发标准作业手册。它把 Android 官方最佳实践、迁移流程和检查步骤打包成可按需加载的 SKILL.md，帮助 AI 在处理 Android 工程任务时按官方流程执行，减少漏项和误改。

1. 官方资料来源

本文基于以下 Google / Android 官方资料整理：

• Android Skills 官方介绍：https://developer.android.com/tools/agents/android-skills
• Android CLI 官方介绍：https://developer.android.com/tools/agents/android-cli
• Android Studio Agent Mode Skills：https://developer.android.com/studio/gemini/skills
• Android Skills GitHub 仓库：https://github.com/android/skills
• Agent Skills 开放标准：https://agentskills.io/home

Google 官方定义：

Android skills are AI-optimized instructions, to help AI tools and agents better understand and execute specific patterns that follow best practices and guidance on Android development.

中文理解：

Android Skills 是为 AI 优化的指令集，帮助 AI 工具和 Agent 按 Android 官方最佳实践执行特定工程任务。

---

2. Android Skills 是什么

Android Skills 不是新的 Android 框架，也不是面向人类开发者的入门教程。

它更像是：

Google 官方写给 AI Agent 的 Android 开发 SOP。

典型用途包括：

• 升级 Android Gradle Plugin；
• XML View 迁移到 Jetpack Compose；
• 接入 Navigation 3；
• 适配 Android 15 Edge-to-Edge；
• 审计 R8 / ProGuard 规则；
• 升级 Google Play Billing Library。

执行逻辑可以理解为：

---

3. 为什么需要 Android Skills

AI 直接改 Android 工程，容易出现三类问题：

1. 知识过期
   Android 工具链变化快，模型可能使用旧版本写法。

2. 流程遗漏
   例如升级 AGP 不只是改版本号，还涉及 Gradle DSL、Kotlin、废弃 flag、构建验证等。

3. 误改范围过大
   例如 XML 迁移 Compose，本来只该改 UI，AI 可能顺手重构业务逻辑。

Android Skills 的作用，就是把这些高风险任务拆成固定步骤，让 AI 按流程做，而不是自由发挥。

---

4. 官方强调的核心价值

价值	含义
专家知识注入	让 AI 按 Android 官方最新实践执行任务
可重复流程	多步骤任务每次按同一套流程处理，减少遗漏
资源打包	Skill 可附带脚本、模板、参考文档
团队共享	团队可以把自己的工程规范也沉淀成 Skill

---

5. 当前 Android Skills 合集

截至整理时，android/skills 仓库主分支包含以下 9 个 SKILL.md：

Skill	适用场景	说明
base / Android CLI	Android CLI 基础能力	让 Agent 使用 android 命令处理项目创建、部署、SDK、环境诊断等任务
agp-9-upgrade	AGP 9 升级	迁移 Android Gradle Plugin 到 9，处理相关构建配置变化
camera1-to-camerax	相机迁移	将 Camera1 / Camera2 迁移到 CameraX
migrate-xml-views-to-jetpack-compose	XML 迁移 Compose	迁移 UI 层，保持现有架构互操作，避免误改业务逻辑
navigation-3	Navigation 3	接入或迁移到 Jetpack Navigation 3
r8-analyzer	R8 / ProGuard 审计	检查冗余、过宽或可被替代的 keep 规则
play-billing-library-version-upgrade	Play Billing 升级	将旧版 Google Play Billing Library 升级到最新稳定版
edge-to-edge	Android 15 全面屏适配	修复状态栏、导航栏、IME Insets、系统栏可读性等问题
display-ai-glasses-with-jetpack-compose-glimmer	Android XR / AI Glasses	使用 Jetpack Compose Glimmer 构建眼镜形态体验

说明：一些文章提到“6 个核心 Skills”，这是早期版本口径。当前官方仓库已扩展到更多 Skill。

---

6. Android CLI 安装与初始化

Android CLI 是 Google 官方命令行工具，用于管理 Android Skills，也提供 SDK、模拟器、部署、文档检索等能力。

官方入口：

https://developer.android.com/tools/agents/android-cli

6.1 安装步骤

1. 打开 Android CLI 官方页面；
2. 下载对应系统版本；
3. 解压安装包；
4. 将 android 可执行文件所在目录加入系统 PATH；
5. 重新打开终端；
6. 验证命令是否可用。

验证方式：

command -v android
# 或
which android

查看帮助：

android --help

更新到最新版本：

android update

---

7. 使用 Android CLI 管理 Skills

7.1 初始化 Agent 支持

android init

该命令会安装 android-cli Skill，让 Agent 理解如何使用 Android CLI。

7.2 查看可用 Skills

android skills list

查看详细信息：

android skills list --long

7.3 搜索 Skill

android skills find 'performance'

7.4 安装指定 Skill

android skills add --skill=edge-to-edge

安装到指定 Agent：

android skills add --agent='gemini' --skill=edge-to-edge

7.5 安装全部 Skills

android skills add --all

如果没有检测到已有 Agent 目录，也没有指定 Agent，官方默认会安装到：

~/.gemini/antigravity/skills

7.6 删除 Skill

android skills remove --skill=edge-to-edge

---

8. 在 Android Studio 中使用 Skills

Android Studio 的 Gemini Agent Mode 支持 Skills。

使用方式：

1. 从 GitHub 仓库下载 Skill；
2. 放到项目根目录下的 .skills/ 或 .agent/skills/；
3. 在 Agent Mode 中提出相关任务；
4. Agent 会根据任务和 Skill 描述自动选择是否加载；
5. 也可以用 @skill-name 手动触发。

目录示例：

my-android-project/
├── app/
├── build.gradle.kts
├── settings.gradle.kts
└── .agent/
    └── skills/
        └── edge-to-edge/
            ├── SKILL.md
            └── references/

自动触发示例：

Make my app UI edge-to-edge.

手动触发示例：

@edge-to-edge
帮我检查当前页面的系统栏适配问题。

---

9. Skill 文件结构

一个 Skill 的核心是 SKILL.md。

基本结构：

---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill instructions...

关键字段：

字段	作用
name	Skill 唯一名称，通常与目录名一致
description	说明 Skill 做什么、什么时候用
metadata	作者、版本、关键词等信息
正文	Agent 激活 Skill 后要遵循的步骤和规则

Skill 目录还可以包含：

目录	用途
scripts/	可执行脚本
references/	技术参考文档
assets/	模板、图示、JSON Schema 等资源

---

10. 推荐试用流程

团队首次试用，建议这样做：

# 1. 验证 Android CLI
command -v android

# 2. 更新 CLI
android update

# 3. 初始化 Agent 支持
android init

# 4. 查看 Skills
android skills list --long

# 5. 安装全部 Skills
android skills add --all

然后选择低风险任务验证，例如：

Make my app UI edge-to-edge.

建议要求 Agent 输出：

• 使用了哪个 Skill；
• 修改了哪些文件；
• 为什么这么改；
• 如何验证；
• 是否存在风险。

---

11. 典型使用场景

11.1 Edge-to-Edge 适配

帮我把这个 Compose App 适配 Android 15 的 Edge-to-Edge。

适用 Skill：edge-to-edge

重点检查：状态栏、导航栏、Insets、IME、系统栏可读性。

11.2 XML 迁移 Compose

把登录页从 XML View 迁移到 Jetpack Compose。

适用 Skill：migrate-xml-views-to-jetpack-compose

重点要求：只迁移 UI 层，不顺手改业务逻辑。

11.3 R8 规则审计

帮我检查项目里 ProGuard / R8 keep 规则有没有冗余。

适用 Skill：r8-analyzer

重点要求：先给分析结论，再小步修改和验证。

---

12. 对团队的启发

Android Skills 的价值不只是 Google 提供的这些官方 Skill，更重要的是它提供了一种方法：

把团队经验沉淀成 AI Agent 能执行的标准流程。

我们可以参考它沉淀内部 Skill：

内部 Skill 方向	可沉淀内容
Jenkins 构建排障	常见失败日志、排查顺序、重跑策略、产物路径
Gerrit 提交流程	commit message 规范、review 前检查项、提交流程
项目刷机与冒烟测试	设备准备、刷机步骤、验证 checklist
易链权限申请	申请入口、审批人、权限类型、注意事项
发版 checklist	构建、签名、测试、灰度、回滚预案

---

13. 最终结论

Android Skills 是 Google 官方推出的 AI Agent Android 开发能力包。

它的本质不是新框架，而是：

把 Android 官方最佳实践写成 AI 可执行的标准流程，让 AI 在改 Android 工程时更稳、更少犯低级错误。

对开发团队来说，它有两层价值：

1. 直接使用 Google 官方 Android Skills，提升 Android 工程任务的稳定性；
2. 学习这种 Skill 机制，把团队自己的工程流程、排障经验和交付规范沉淀成内部 Skill。