GitHub热榜上手｜android/skills：周涨1317的Android技能包

📌 本文整理自官方文档与社区公开资料，未做真机实测。

LLM 写 Jetpack Compose 基操没问题，一碰到 R8 混淆分析、Wear Compose M3 适配就开始翻车。android/skills 专治这些 LLM 短板——本周 star 直接 +1317，总数冲过 9684。

项目介绍

android/skills 是 Android 官方推出的仓库，核心产物是一组 AI-optimized、modular instructions（即 SKILL.md 文件）。它遵循 open-standard agent skills 规范，把 developer.android.com 上的最佳实践和技术规格"喂"给 LLM，让 agent 在特定 Android 领域不再瞎编。

关键定位一句话：不做 LLM 已经擅长的事情（项目原话：不优先覆盖基础 Jetpack Compose best practices 等 LLM 已经 proficient 的领域），只补评估中表现差的 use cases 和 workflows。

安装路径有三条：Android CLI 装到项目目录、Android CLI 批量装到所有已检测 agent、作为 plugin 接入 Claude Code 或 Codex。

上手指南

本文整理自官方文档与社区反馈，未做真机实测。

安装指定 skill：

android skills add r8-analyzer --project=.

安装全部 skill：

android skills add --all

如果环境中没有已有 agent 目录且未指定 agent，skills 默认装到 ~/.gemini/antigravity/skills（覆盖 Gemini 和 Antigravity）。

作为 agent plugin 安装：

Claude Code：

/plugin marketplace add android/skills
/plugin install android-skills@android-skills

Codex：

codex plugin marketplace add android/skills
codex plugin add android-skills@android-skills

激活方式： Agent 自动匹配。你只需在 prompt 里描述任务，比如 “Make my app UI edge-to-edge”，agent 就会自动找到并调用对应 skill，不需要手动开关。

踩坑记录

clone 阶段：LibreSSL 握手失败

执行 git clone --depth 1 https://github.com/android/skills 时，部分系统（尤其默认用 LibreSSL 的发行版）会直接失败：

$ git clone --depth 1 https://github.com/android/skills
Cloning into '/tmp/ght-smoke/android__skills'...
fatal: unable to access 'https://github.com/android/skills/': LibreSSL SSL_connect: SSL_ERROR_SYSCALL in connection to github.com:443

exit code 128。原因是系统 SSL 库（LibreSSL 2.x）与 GitHub 当前 TLS 协商不兼容，或中间代理截断了握手。换 OpenSSL 3.x 或通过 git config --global http.sslCAInfo 指定 CA 证书可绕过。

issue 区

官方 issue 区暂无高频问题（本次未获取到 issues 数据，不做编造引用）。

使用说明

更新已安装的 skill：

android skills update --all
android skills update wear-compose-m3

可选参数（逐字来自 README）：

参数	行为
--all	安装全部 Android skills；省略则只装 android-cli 这一个
--agent	逗号分隔的 agent 列表；省略则装到所有已检测 agent
--project	项目根路径，skill 安装到该目录下

默认行为注意： 不带 --all 时只装 android-cli 一个 skill，不是全部。想一次拉齐必须显式加 --all。

激活逻辑： 无手动开关。Agent 根据 prompt 关键词自动匹配 SKILL.md——提到 R8 混淆就触发 r8-analyzer，提到 edge-to-edge 就触发对应 UI 适配 skill。

总结

该用的人：

• 日常用 Claude Code / Codex / Gemini 等 agent 写 Android 代码，经常碰到 R8、Wear Compose、edge-to-edge 这类 LLM 容易翻车的场景
• 想在 agent 工作流里挂一层"Android 官方兜底知识"，减少幻觉

不该用的人：

• 纯手写、不用 agent 的开发者（SKILL.md 是给 LLM 读的，对人没有直接收益）
• 只做基础 Compose UI 的开发者（项目明确不覆盖 LLM 已擅长的基操，装了也触发不了什么）

---

本周共带来 7 个 GitHub 热榜项目，后续每天更新一篇。关注我，跟着热榜项目练手，下一篇见。

你平时用 agent 写 Android，更常翻车的是 R8 混淆还是 Compose 状态管理？评论区扣 1（R8）或 2（Compose 状态管理），我看看哪类坑人更多。

---

做自动化这几年，最耗时间的从来不是写代码，是摸清每个平台的脾气。

这篇里提到的坑，都是真金白银踩出来的。
如果你手上也有重复度很高的活儿——批量发布、数据搬运、有固定规则的机械操作
——可以在评论区说说你的场景，我看看能不能自动化掉。