尧图网页设计 
1. 为什么要在本地跑通 Android 官方 SkillsAndroid 官方在 2026 年推出了一套面向 Agent 的开发工具链核心是两样东西Android CLI 和 Android Skills。前者是一个android.exe可执行文件把gradlew、adb、emulator、sdkmanager这些零散命令收拢成android module action的统一入口后者是一批以SKILL.md为入口的能力模块告诉 Agent「Android 项目该怎么建、怎么构建、怎么部署、怎么查文档」。这套东西解决的真实痛点是你让 Claude Code、Codex、Gemini CLI 这类 Agent 去改一个 Android 工程它经常不知道gradlew在哪、不知道当前连了哪台设备、不知道 CameraX 的正确用法于是开始瞎猜。装上 Skills 之后Agent 手里就有了一份结构化的 Android 知识库和一套可调用的 CLI调用链路才真正闭环。适合谁本地已经装了至少一个 AgentClaude Code / CodeBuddy / Qoder / OpenClaw 等、想用 Agent 写 Android 代码但被环境问题卡住的开发者。这篇会从SKILL.md结构讲到 Android CLI 初始化再给一次完整的 Skills 加载与调用验证命令都能直接复制。2. 前置准备Android CLI 安装与 SKILL.md 目录结构2.1 安装 Android CLIWindows 下注意一点安装命令要在 CMD 里执行PowerShell 跑不通。命令如下curl.exe -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o %TEMP%\i.cmd %TEMP%\i.cmd执行过程大致是这样Installing android.exe... Downloading... Installing to C:\Users\daizh\AppData\AndroidCLI... Adding C:\Users\daizh\AppData\AndroidCLI to user PATH... Initializing CLI... Success! android is ready to use.装完之后去C:\Users\daizh\AppData\AndroidCLI看一眼里面就一个android.exe。这一点很关键如果安装脚本失败你完全可以手动拿到这个android.exe把它所在目录加进系统 PATH 就行不需要重装。验证安装android --version输出最后一行类似1.0.15498356这就是当前版本号。顺手检查更新android update看到Already up-to-date with version 1.0.15498356.说明没问题。2.2 SKILL.md 的结构长什么样每个 Skill 就是一个目录目录名即 Skill 名里面至少有一个SKILL.md还可以带几个可选子目录。官方对这几个目录的定位说得很清楚scripts/Agent 可以运行的可执行代码比如 Python 或 Bash。references/详细技术文档、API 参考或领域指南。assets/静态资源比如文档模板、界面图或 JSON 架构。在SKILL.md里引用这些文件时用相对于技能根目录的路径例如Run the script at scripts/cleanup.py。一个典型的 Skill 目录骨架android-cli/ ├── SKILL.md └── references/ ├── build.md ├── device.md └── skills.mdSKILL.md本身是给 Agent 读的说明书负责回答两个问题这个技能能干什么、具体怎么干。references/里放的是执行时按需加载的细节这样SKILL.md可以保持简洁不会一上来就把上下文塞满。2.3 初始化 Android CLI 技能先让 Agent 知道「有个 android.exe 存在而且它能干活」android init执行结果Initializing android-cli skill... Skill android-cli installed to C:\Users\daizh\.claude\skills\android-cli Skill android-cli installed to C:\Users\daizh\.codebuddy\skills\android-cli Skill android-cli installed to C:\Users\daizh\.openclaw\skills\android-cli Skill android-cli installed to C:\Users\daizh\.qoder\skills\android-cliAndroid CLI 会自动探测本机装了哪些 Agent然后把android-cli这个 Skill 分别写进各自的skills目录。从输出能看出一个通用规律各家 Agent 的 Skill 都放在~/.agent/skills/下SKILL.md是通用格式。这意味着你在 GitHub 上按 star 排序找一些高排名的 Skill复制进对应目录就能直接用。3. 可复制配置批量安装 Android Skills3.1 一次性装齐官方 Skillsandroid skills add --all这一步会从远端拉取官方 Skill 包。如果网络环境正常你会看到进度条和一连串安装日志[] 100% (679076/679076 bytes) Skill camera1-to-camerax installed to C:\Users\daizh\.claude\skills\camera1-to-camerax Skill appfunctions installed to C:\Users\daizh\.claude\skills\appfunctions Skill android-cli installed to C:\Users\daizh\.claude\skills\android-cli ...装完之后~/.claude/skills目录大致是这样adaptive agp-9-upgrade android-cli appfunctions camera1-to-camerax display-glasses-with-jetpack-compose-glimmer edge-to-edge engage-sdk-integration jetpack-compose-m3 migrate-xml-views-to-jetpack-compose navigation-3 perfetto-sql perfetto-trace-analysis play-billing-library-version-upgrade r8-analyzer styles testing-setup verified-email一共 18 个官方 Skill加上最开始android init装的android-cli合计 19 个。每个目录里都是一个SKILL.md加一个references/。3.2 查看和检索 Skills列出当前可用的 Skill 列表android skills list输出是一串 Skill 名比如camera1-to-camerax、appfunctions、perfetto-sql、jetpack-compose-m3等。这个命令会联网拉取列表所以网络不通时可能返回空。想装单个 Skill 而不是全量android skills install camerax搜索android skills search compose看某个 Skill 的详情android skills info camerax3.3 在 CLAUDE.md 里写清调用约定Skill 装好了还得让 Agent 知道什么时候该调。在项目的CLAUDE.md里加一段## Android CLI - 构建: android build - 部署: android device install - 日志: android device logs - 文档: android docs - 技能列表: android skills list注意别写成android deploy这种老式写法现在官方已经规范到android module action结构了写错 Agent 会调不到。4. 验证请求跑通一次完整的 Skills 加载与调用4.1 确认命令树先看整体帮助android --help输出里能看到完整的命令模块Commands: create Create a new Android project describe Analyzes an Android project to generate descriptive metadata. docs Android documentation commands emulator Emulator commands info Print environment information (SDK Location, etc.) init Initializes the environment (eg. skills) for Android CLI. layout Returns the layout tree of an application run Deploy an Android Application screen Commands to view the device sdk Download and list SDK packages skills Manage skills studio Android Studio commands update Update the Android CLI想看某个模块的细节用子命令帮助android skills --help android device --help android docs --help4.2 让 Agent 真正调用一次打开 Claude Code在 Android 工程目录下提一个需要查文档的问题比如帮我看下 CameraX 的 PreviewView 怎么和 ImageAnalysis 一起用用 android docs 查一下官方文档再回答。Agent 会去读~/.claude/skills/android-cli/SKILL.md发现里面写了android docs这个能力于是执行android docs camerax这个命令会返回结构化的官方文档片段比让 Agent 直接爬网页省 token也更准。你可以在 Claude Code 的终端输出里看到它确实调用了android.exe这就是调用链路跑通的标志。再验证一个设备相关的android device list输出当前连接的设备列表等价于adb devices但格式更规整。接着android device logs能实时看到日志流。Agent 在排查崩溃时就会用这条命令。4.3 构建与部署验证android build构建 debug APK。要 release 或 AABandroid build release android build bundle部署到设备android device install app.apk android device launch截图和录屏android device screenshot android device record模拟器管理android emulator list android emulator start Pixel_9 android emulator stop测试android test android test connected android test compose这一整套跑下来Agent 手里就有了从构建、部署、日志到测试的完整工具链不再需要你手动敲gradlew和adb。5. 本篇常见错排查5.1android skills add --all下载失败典型报错Error downloading skills: release-assets.githubusercontent.com这是拉取 Skill 包时网络不通。先确认基础网络再检查是否需要给 JDK 配代理。注意 Android CLI 是 Java 程序它不一定读 CMD 里set HTTPS_PROXY设的环境变量得走 JVM 参数set JAVA_TOOL_OPTIONS-Dhttps.proxyHost127.0.0.1 -Dhttps.proxyPort8082 -Dhttp.proxyHost127.0.0.1 -Dhttp.proxyPort8082设完之后再跑android skills add --all你会看到输出里多了一行Picked up JAVA_TOOL_OPTIONS: -Dhttps.proxyHost127.0.0.1 -Dhttps.proxyPort8082 ...这说明 JVM 确实吃到了代理配置下载就能走通。android skills list同理它也要联网没配代理会返回空列表。5.2 PowerShell 里装不上安装脚本在 PowerShell 下会失败必须在 CMD 里跑。如果你习惯用 PowerShell先cmd切过去再执行那条curl.exe命令。5.3 Skill 装了但 Agent 不调用先确认 Skill 目录真的存在dir C:\Users\daizh\.claude\skills\android-cli里面应该有SKILL.md和references/。如果目录在但 Agent 不调检查CLAUDE.md里的命令写法是不是老式的android deploy改成android device install这种规范写法。5.4 Qoder 系列目录混乱本机可能同时存在.qoder、.qoder-cli、.qoder-cn三个目录。android init只会写进.qoder如果你用的是 Qoder 的 CLI 版本可能读的是.qoder-cli。解决办法很简单把.qoder/skills/android-cli整个目录复制到.qoder-cli/skills/和.qoder-cn/skills/下即可。5.5 没有网络环境时的离线方案官方 Skill 仓库在 GitHub 上如果拉不下来可以手动下载后复制到对应 Agent 的skills目录。每个 Skill 就是一个目录复制过去就能用不需要额外注册。Gitee 上也有镜像仓库可以备用。6. 让 Agent 稳定调用 Android CLI 的下一步Skill 装好只是第一步真正影响体验的是 Agent 的模型能力和上下文管理。Android 工程动辄几十个模块Agent 在长会话里很容易丢上下文导致它忘了android docs这个能力存在。这时候可以考虑用 TaoToken 的 Coding Plan 来跑长期编码任务它的上下文策略对 Agent 工作流更友好配合 Android Skills 用下来Agent 调用android.exe的稳定性会明显好一些。如果你只是想先验证模型对 Android CLI 命令的理解可以直接在模型对话里贴一段android --help的输出让它解释每个模块的用途快速判断模型是否吃透了这套工具链。接入相关的 Key 和文档在 API Keys 和接入文档里按需取用即可。最后给一个实用建议把android skills list的输出存成一个skills-inventory.md放在项目根目录每次 Agent 会话开始时让它先读这个文件它就知道当前有哪些 Skill 可用不用每次重新探测。这个习惯能省掉不少「Agent 不知道有某个 Skill」的来回。 安装 Android 官方 Skills：用 SKILL.md 与 Android CLI 打通 Agent 工作流
1. 为什么要在本地跑通 Android 官方 SkillsAndroid 官方在 2026 年推出了一套面向 Agent 的开发工具链核心是两样东西Android CLI 和 Android Skills。前者是一个android.exe可执行文件把gradlew、adb、emulator、sdkmanager这些零散命令收拢成android module action的统一入口后者是一批以SKILL.md为入口的能力模块告诉 Agent「Android 项目该怎么建、怎么构建、怎么部署、怎么查文档」。这套东西解决的真实痛点是你让 Claude Code、Codex、Gemini CLI 这类 Agent 去改一个 Android 工程它经常不知道gradlew在哪、不知道当前连了哪台设备、不知道 CameraX 的正确用法于是开始瞎猜。装上 Skills 之后Agent 手里就有了一份结构化的 Android 知识库和一套可调用的 CLI调用链路才真正闭环。适合谁本地已经装了至少一个 AgentClaude Code / CodeBuddy / Qoder / OpenClaw 等、想用 Agent 写 Android 代码但被环境问题卡住的开发者。这篇会从SKILL.md结构讲到 Android CLI 初始化再给一次完整的 Skills 加载与调用验证命令都能直接复制。2. 前置准备Android CLI 安装与 SKILL.md 目录结构2.1 安装 Android CLIWindows 下注意一点安装命令要在 CMD 里执行PowerShell 跑不通。命令如下curl.exe -fsSL https://dl.google.com/android/cli/latest/windows_x86_64/install.cmd -o %TEMP%\i.cmd %TEMP%\i.cmd执行过程大致是这样Installing android.exe... Downloading... Installing to C:\Users\daizh\AppData\AndroidCLI... Adding C:\Users\daizh\AppData\AndroidCLI to user PATH... Initializing CLI... Success! android is ready to use.装完之后去C:\Users\daizh\AppData\AndroidCLI看一眼里面就一个android.exe。这一点很关键如果安装脚本失败你完全可以手动拿到这个android.exe把它所在目录加进系统 PATH 就行不需要重装。验证安装android --version输出最后一行类似1.0.15498356这就是当前版本号。顺手检查更新android update看到Already up-to-date with version 1.0.15498356.说明没问题。2.2 SKILL.md 的结构长什么样每个 Skill 就是一个目录目录名即 Skill 名里面至少有一个SKILL.md还可以带几个可选子目录。官方对这几个目录的定位说得很清楚scripts/Agent 可以运行的可执行代码比如 Python 或 Bash。references/详细技术文档、API 参考或领域指南。assets/静态资源比如文档模板、界面图或 JSON 架构。在SKILL.md里引用这些文件时用相对于技能根目录的路径例如Run the script at scripts/cleanup.py。一个典型的 Skill 目录骨架android-cli/ ├── SKILL.md └── references/ ├── build.md ├── device.md └── skills.mdSKILL.md本身是给 Agent 读的说明书负责回答两个问题这个技能能干什么、具体怎么干。references/里放的是执行时按需加载的细节这样SKILL.md可以保持简洁不会一上来就把上下文塞满。2.3 初始化 Android CLI 技能先让 Agent 知道「有个 android.exe 存在而且它能干活」android init执行结果Initializing android-cli skill... Skill android-cli installed to C:\Users\daizh\.claude\skills\android-cli Skill android-cli installed to C:\Users\daizh\.codebuddy\skills\android-cli Skill android-cli installed to C:\Users\daizh\.openclaw\skills\android-cli Skill android-cli installed to C:\Users\daizh\.qoder\skills\android-cliAndroid CLI 会自动探测本机装了哪些 Agent然后把android-cli这个 Skill 分别写进各自的skills目录。从输出能看出一个通用规律各家 Agent 的 Skill 都放在~/.agent/skills/下SKILL.md是通用格式。这意味着你在 GitHub 上按 star 排序找一些高排名的 Skill复制进对应目录就能直接用。3. 可复制配置批量安装 Android Skills3.1 一次性装齐官方 Skillsandroid skills add --all这一步会从远端拉取官方 Skill 包。如果网络环境正常你会看到进度条和一连串安装日志[] 100% (679076/679076 bytes) Skill camera1-to-camerax installed to C:\Users\daizh\.claude\skills\camera1-to-camerax Skill appfunctions installed to C:\Users\daizh\.claude\skills\appfunctions Skill android-cli installed to C:\Users\daizh\.claude\skills\android-cli ...装完之后~/.claude/skills目录大致是这样adaptive agp-9-upgrade android-cli appfunctions camera1-to-camerax display-glasses-with-jetpack-compose-glimmer edge-to-edge engage-sdk-integration jetpack-compose-m3 migrate-xml-views-to-jetpack-compose navigation-3 perfetto-sql perfetto-trace-analysis play-billing-library-version-upgrade r8-analyzer styles testing-setup verified-email一共 18 个官方 Skill加上最开始android init装的android-cli合计 19 个。每个目录里都是一个SKILL.md加一个references/。3.2 查看和检索 Skills列出当前可用的 Skill 列表android skills list输出是一串 Skill 名比如camera1-to-camerax、appfunctions、perfetto-sql、jetpack-compose-m3等。这个命令会联网拉取列表所以网络不通时可能返回空。想装单个 Skill 而不是全量android skills install camerax搜索android skills search compose看某个 Skill 的详情android skills info camerax3.3 在 CLAUDE.md 里写清调用约定Skill 装好了还得让 Agent 知道什么时候该调。在项目的CLAUDE.md里加一段## Android CLI - 构建: android build - 部署: android device install - 日志: android device logs - 文档: android docs - 技能列表: android skills list注意别写成android deploy这种老式写法现在官方已经规范到android module action结构了写错 Agent 会调不到。4. 验证请求跑通一次完整的 Skills 加载与调用4.1 确认命令树先看整体帮助android --help输出里能看到完整的命令模块Commands: create Create a new Android project describe Analyzes an Android project to generate descriptive metadata. docs Android documentation commands emulator Emulator commands info Print environment information (SDK Location, etc.) init Initializes the environment (eg. skills) for Android CLI. layout Returns the layout tree of an application run Deploy an Android Application screen Commands to view the device sdk Download and list SDK packages skills Manage skills studio Android Studio commands update Update the Android CLI想看某个模块的细节用子命令帮助android skills --help android device --help android docs --help4.2 让 Agent 真正调用一次打开 Claude Code在 Android 工程目录下提一个需要查文档的问题比如帮我看下 CameraX 的 PreviewView 怎么和 ImageAnalysis 一起用用 android docs 查一下官方文档再回答。Agent 会去读~/.claude/skills/android-cli/SKILL.md发现里面写了android docs这个能力于是执行android docs camerax这个命令会返回结构化的官方文档片段比让 Agent 直接爬网页省 token也更准。你可以在 Claude Code 的终端输出里看到它确实调用了android.exe这就是调用链路跑通的标志。再验证一个设备相关的android device list输出当前连接的设备列表等价于adb devices但格式更规整。接着android device logs能实时看到日志流。Agent 在排查崩溃时就会用这条命令。4.3 构建与部署验证android build构建 debug APK。要 release 或 AABandroid build release android build bundle部署到设备android device install app.apk android device launch截图和录屏android device screenshot android device record模拟器管理android emulator list android emulator start Pixel_9 android emulator stop测试android test android test connected android test compose这一整套跑下来Agent 手里就有了从构建、部署、日志到测试的完整工具链不再需要你手动敲gradlew和adb。5. 本篇常见错排查5.1android skills add --all下载失败典型报错Error downloading skills: release-assets.githubusercontent.com这是拉取 Skill 包时网络不通。先确认基础网络再检查是否需要给 JDK 配代理。注意 Android CLI 是 Java 程序它不一定读 CMD 里set HTTPS_PROXY设的环境变量得走 JVM 参数set JAVA_TOOL_OPTIONS-Dhttps.proxyHost127.0.0.1 -Dhttps.proxyPort8082 -Dhttp.proxyHost127.0.0.1 -Dhttp.proxyPort8082设完之后再跑android skills add --all你会看到输出里多了一行Picked up JAVA_TOOL_OPTIONS: -Dhttps.proxyHost127.0.0.1 -Dhttps.proxyPort8082 ...这说明 JVM 确实吃到了代理配置下载就能走通。android skills list同理它也要联网没配代理会返回空列表。5.2 PowerShell 里装不上安装脚本在 PowerShell 下会失败必须在 CMD 里跑。如果你习惯用 PowerShell先cmd切过去再执行那条curl.exe命令。5.3 Skill 装了但 Agent 不调用先确认 Skill 目录真的存在dir C:\Users\daizh\.claude\skills\android-cli里面应该有SKILL.md和references/。如果目录在但 Agent 不调检查CLAUDE.md里的命令写法是不是老式的android deploy改成android device install这种规范写法。5.4 Qoder 系列目录混乱本机可能同时存在.qoder、.qoder-cli、.qoder-cn三个目录。android init只会写进.qoder如果你用的是 Qoder 的 CLI 版本可能读的是.qoder-cli。解决办法很简单把.qoder/skills/android-cli整个目录复制到.qoder-cli/skills/和.qoder-cn/skills/下即可。5.5 没有网络环境时的离线方案官方 Skill 仓库在 GitHub 上如果拉不下来可以手动下载后复制到对应 Agent 的skills目录。每个 Skill 就是一个目录复制过去就能用不需要额外注册。Gitee 上也有镜像仓库可以备用。6. 让 Agent 稳定调用 Android CLI 的下一步Skill 装好只是第一步真正影响体验的是 Agent 的模型能力和上下文管理。Android 工程动辄几十个模块Agent 在长会话里很容易丢上下文导致它忘了android docs这个能力存在。这时候可以考虑用 TaoToken 的 Coding Plan 来跑长期编码任务它的上下文策略对 Agent 工作流更友好配合 Android Skills 用下来Agent 调用android.exe的稳定性会明显好一些。如果你只是想先验证模型对 Android CLI 命令的理解可以直接在模型对话里贴一段android --help的输出让它解释每个模块的用途快速判断模型是否吃透了这套工具链。接入相关的 Key 和文档在 API Keys 和接入文档里按需取用即可。最后给一个实用建议把android skills list的输出存成一个skills-inventory.md放在项目根目录每次 Agent 会话开始时让它先读这个文件它就知道当前有哪些 Skill 可用不用每次重新探测。这个习惯能省掉不少「Agent 不知道有某个 Skill」的来回。