android/skills：用SKILL.md补强Android智能体的开发工作流
给Android智能体装上SKILL.md工作流指令，重点补足LLM容易做不好的开发场景。
GitHub android/skills 更新 2026-10-17 分支 main 星标 8.1K 分叉 536
Kotlin Python Android智能体 Android CLI SKILL.md

🧭 决策指南

为什么现在热： README强调AI优化的模块化SKILL.md、open-standard agent skills，以及针对LLM表现不足的Android工作流；同时项目发布了v1.0.15并在当日新增36星。材料支持这些关注点，但无法进一步确定上榜的唯一原因。

适合，如果你

  • 你要让Gemini或Antigravity执行带Android最佳实践的专门任务。
    README“Android skills”章节称其帮助agents理解并执行遵循developer.android.com指导的Android开发模式。
  • 你需要用Android CLI把skill安装到项目根目录或指定agent。
    README“Install Android skills”章节提供android skills add、--project和--agent选项。
  • 你的Android工作流使用Claude Code或Codex插件。
    README“Install as an agent plugin”章节提供Claude Code和Codex的安装命令。

不适合，如果你

  • 你主要寻找基础Jetpack Compose最佳实践，而不是LLM表现较弱的Android场景。
    README“Android skills”章节明确说不优先处理well-established areas，例如basic Jetpack Compose best practices。
  • 你的团队要求直接提交公开代码、skill或变更。
    README“Contributing”章节明确写着“Public contributions are not accepted at this time”。
  • 你没有Android agent环境，也不使用Android CLI、Claude Code或Codex。
    README的安装路径只列出Android CLI、Gemini、Antigravity、Claude Code和Codex。

前置条件

  • 需要Android CLI；README以“Use Android CLI to install a specific skill”作为安装方式。
  • 如不指定agent且没有现有agent目录，README规定安装到Gemini和Antigravity的~/.gemini/antigravity/skills。
  • 如需安装全部技能，使用README定义的--all选项；默认只安装android-cli skill。

第一步命令（README 原文）

android skills add --all

要注意

  • android skills add --all会面向所有检测到的agent安装全部Android skills。
    README“Install Android skills”章节同时说明--all添加全部skills，未指定--agent时面向所有检测到的agents。
  • 指定项目时必须使用README中的--project参数指向project root。
    README选项说明将--project定义为“Path to a project root in which to install the skills”。
  • 安装后不需要手动选择skill，agent会按任务相关性自动激活。
    README“Activate skills”章节说明agent automatically activates skills relevant to your task。

材料未说明

  • README没有说明Android CLI的最低版本或安装方式。
  • README没有列出v1.0.15包含哪些具体Android skills。
  • README没有提供各skill对应的评测数字、准确率或与其他agent instructions的对比结果。
  • README没有说明Gemini、Antigravity、Claude Code和Codex之外的agent兼容范围。
  • README没有说明Kotlin与Python代码分别承担哪些功能。

💡 深度解析

6
不适合 我主要维护后端或 iOS 项目，没有 Android CLI，也不使用 Gemini、Claude Code、Codex 或 Antigravity 做 Android 开发；这个项目适合我的日常代码工作吗？
适合读者： 主要维护后端或 iOS 项目、没有 Android CLI 和 Android Agent 工作流的开发者

不适合，因为项目的知识、安装方式和自动激活机制都围绕 Android 开发与兼容 Agent 展开。

  • README 将产物定义为 Android 专用、模块化的 Agent 指令和资源，来源是 Android 官方开发指导。
  • 安装入口是 Android CLI，插件入口则明确列出 Claude Code 和 Codex；这些都不是通用后端或 iOS 工作流的安装替代品。
  • 项目刻意不优先覆盖基础 Jetpack Compose 之外的通用能力，而是处理评估中 LLM 表现较弱的 Android 专业场景。
  • Apache License 2.0 允许再利用，但许可证并不会把 Android 技能转换成 iOS、后端或通用软件工程技能。
  • Android skills：AI-optimized, modular instructions ... on Android development
  • Install Android skills：Use Android CLI to install a specific skill
  • Install as an agent plugin：Claude Code 与 Codex
  • Android skills：Our Android skill development focuses on use cases and workflows where evaluations show LLMs underperform
  • 项目数据：Apache License 2.0
材料未说明：README 未说明是否计划提供 iOS、后端或其他非 Android 技能。；README 未说明这些技能能否被不支持 Agent Skills 标准的其他编程工具加载。
适合 我使用 Gemini 或 Antigravity 开发 Android 应用，目前只想在一个项目里让 Agent 执行 R8 分析，而不是安装全部技能，这个项目适合我吗？
适合读者： 使用 Gemini 或 Antigravity、需要在单个 Android 项目中处理 R8 分析的 Android 开发者

适合，因为 README 直接提供了面向 R8 分析的技能和项目级安装方式。

  • r8-analyzer 是可单独添加的技能，不必启用全部 Android skills。
  • --project=. 会把技能安装到当前项目，适合让项目内的 Agent 使用，而不是只改变用户级环境。
  • 技能通过 SKILL.md 提供任务规范和专业上下文，Agent 会根据相关任务自动激活。
  • 但它只是 Agent 指令资源，不能替代 R8 本身，也不能保证生成的配置一定正确；README 要求对 AI 结果进行复核。
  • Install Android skills：`android skills add r8-analyzer --project=.`
  • Android skills：markdown files (SKILL.md) that provide a technical specification of a task
  • Activate skills：Your agent automatically activates skills that are relevant to your task
  • Disclaimer：AI can make mistakes, so always double-check the results
android skills add r8-analyzer --project=.
材料未说明：README 未说明 r8-analyzer 覆盖的具体 R8 规则、AGP 版本兼容范围和评估准确率。；README 未说明 Gemini 或 Antigravity 的具体版本要求。
适合 我维护 Android CLI 集成环境，机器上已经有多个 Agent，希望一次安装全部 Android skills，并让 CLI 根据现有 Agent 目录选择安装位置，这个项目适合吗？
适合读者： 负责 Android CLI 与 Agent 集成的工具工程师，需要为多个已存在的 Agent 批量安装技能

适合，因为 Android CLI 支持批量安装，并会在未指定 Agent 时面向检测到的 Agent 安装技能。

  • --all 用于添加全部 Android skills，适合一次性部署而不是逐项执行命令。
  • 不指定 --agent 时，CLI 会把技能安装到所有检测到的 Agent；这正符合已有多个 Agent 目录的环境。
  • 也可以用 --project 改为项目根目录安装，说明工具同时支持项目级和用户级范围。
  • 需要注意，README 只描述检测机制，没有说明检测失败时的诊断接口；没有现有目录且未指定 Agent 时，默认位置是 Gemini 和 Antigravity 目录。
  • Install Android skills：`android skills add --all`
  • Options：`--agent` - A comma-separated list of agents to install the skill for. If omitted, the skill will be installed for all detected agents
  • Options：`--project` - Path to a project root in which to install the skills
  • Install Android skills：If you don't have any existing agent directories and don't specify particular agents, the skills will be installed for Gemini and Antigravity
android skills add --all
材料未说明：README 未列出 CLI 能检测的完整 Agent 名单。；README 未说明多个 Agent 发生路径冲突时的处理规则，也未给出检测失败的错误输出。
适合 我在同一套 Android 工作流中使用 Claude Code 和 Codex，不想分别维护提示词和配置；这个项目能否通过插件接入这两个 Agent？
适合读者： 同时使用 Claude Code 和 Codex、希望通过插件接入 Android 专业技能的 Android 开发者

适合，因为 README 为 Claude Code 和 Codex 分别提供了插件安装路径，并且技能遵循开放标准。

  • Claude Code 有专用的 /plugin install 命令，Codex 则有 marketplace 和 plugin 两步命令。
  • 技能以 Markdown SKILL.md 表达任务规范，目标不是为某一个模型维护一套独立提示词。
  • Agent 会在任务相关时自动发现并激活技能，因此 Android 工作流可以围绕同一套技能资源使用。
  • 但 README 没有承诺两个 Agent 的功能完全一致，也没有列出兼容版本；插件安装成功不等于每项技能都能自动激活。
  • Install as an agent plugin / Claude Code：`/plugin install android-skills --marketplace android/skills`
  • Install as an agent plugin / Codex：`codex plugin marketplace add android/skills` 与 `codex plugin add android-skills@android-skills`
  • Android skills follow the open-standard agent skills
  • Activate skills：Your agent automatically activates skills that are relevant to your task
/plugin install android-skills --marketplace android/skills
材料未说明：README 未说明 Claude Code 与 Codex 的最低版本或各技能的兼容矩阵。；README 未说明两个插件入口是否提供完全相同的技能集合。
适合 我负责一个使用 AI Agent 的 Android 项目，希望技能安装在项目根目录，让团队成员围绕同一代码库使用，而不是依赖每个人的用户目录，这个项目适合吗？
适合读者： 需要把技能随 Android 代码库共享的团队负责人，使用项目级目录而不是每台机器单独配置

适合，因为 README 明确支持通过 --project 把技能安装到指定项目根目录。

  • 项目级安装能把技能作用范围绑定到当前 Android 代码库，符合随项目共享 Agent 指令的需求。
  • --agent 可指定目标 Agent；不指定时则依赖当前环境中的 Agent 检测，因此团队若使用不同 Agent，安装行为可能不同。
  • 默认不带 --all 时只安装 android-cli 技能，团队需要明确决定是否批量安装全部技能。
  • 项目提供更新命令，但 README 没有说明项目目录中的技能文件是否适合提交版本控制，也没有定义团队如何锁定技能版本。
  • Options：`--project` - Path to a project root in which to install the skills
  • Install Android skills：If omitted, only the `android-cli` skill will be installed
  • Options：`--agent` - A comma-separated list of agents to install the skill for
  • To update all skills or specific ones：`android skills update --all`
android skills add --all
材料未说明：README 未说明项目级技能文件的目录结构、是否建议提交 Git，以及团队成员如何保持版本一致。；README 未说明技能是否支持版本锁定或回滚。
视情况 我维护的是 Wear Compose Material 3 项目，并希望 Agent 依据专门的 Wear 工作流而不是只使用基础 Jetpack Compose 知识，这个项目适合吗？
适合读者： 维护 Wear Compose Material 3 项目的 Android 开发者，需要让 Agent 使用专门的 Wear 工作流

视情况，因为 README 明确提供了 wear-compose-m3 技能，但没有展示其覆盖范围或兼容细节。

  • 更新命令中直接出现 wear-compose-m3，说明项目至少把 Wear Compose Material 3 作为独立技能管理。
  • 项目重点是 LLM 表现较弱的专业 Android 用例，而不是基础 Jetpack Compose 最佳实践，这与 Wear 专业工作流的需求方向一致。
  • 技能会根据任务自动激活，但前提是该技能已安装并且目标 Agent 支持相应的发现机制。
  • 如果你的问题超出该技能实际覆盖的 API、版本或设备场景，README 没有证据表明 Agent 能可靠处理。
  • Install Android skills：`android skills update wear-compose-m3`
  • Android skills：We aren't prioritizing well-established areas where LLMs are already proficient, such as basic Jetpack Compose best practices
  • Activate skills：Your agent automatically activates skills that are relevant to your task
  • Options：If omitted, only the `android-cli` skill will be installed
android skills update wear-compose-m3
材料未说明：README 未列出 `wear-compose-m3` 支持的 Wear Compose、Material 3 或 Android SDK 版本。；README 未说明该技能覆盖 UI、导航、测试还是完整 Wear 应用流程。

✨ 核心亮点

  • 提供面向Android的AI优化模块化SKILL.md指令
  • Android CLI支持按技能、项目和agent安装
  • 兼容Gemini、Antigravity、Claude Code与Codex
  • GitHub已有8,076星与v1.0.15版本

🔧 工程化

  • 用SKILL.md为Android agent提供专门任务规范
  • android skills add支持安装单项或全部Android skills
  • 可用--project写入项目根目录，用--agent指定agent
  • Claude Code和Codex可作为agent plugin安装

⚠️ 风险

  • 省略--all时只安装android-cli skill
  • 未指定agent时会安装到所有检测到的agent
  • README明确声明AI可能出错，需复核结果
  • 当前不接受公开贡献，仅可提交GitHub issue

👥 适合谁？

  • 使用Gemini或Antigravity处理Android任务的开发者
  • 需要Android CLI安装项目级skills的团队
  • 使用Claude Code或Codex插件机制的Android开发者
  • 只需要基础Jetpack Compose建议的使用者不在重点范围