Agent skill

Android Version Platform Adapt

by afkT in afkT/DevUtils

依据 Android 官方「版本」文档完成平台适配:按版本号 N 抓取行为变更(所有应用、 targetSdk=N)、changes/features 子页与探索新功能/API;归纳影响项并落地到 Manifest/Gradle/工具类封装。在用户要求 Android 版本适配、行为变更排查、 targetSdk 升级、新 API 封装或对照…

Apache-2.0Auto-check passedMobile

Install Android Version Platform Adapt

skills CLI
$ npx skills add afkT/DevUtils --skill android-version-platform-adapt -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install afkT/DevUtils android-version-platform-adapt --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/afkT/DevUtils.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.cursor/skills/android-version-platform-adapt .claude/skills/android-version-platform-adapt && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
android-version-platform-adapt
GitHub stars
1.6k
Token cost
~1.8k tokens
SKILL.md length
372 words
Files
2 (incl. references)
Skills in repo
13
Repo updated
First seen
Licence
Apache-2.0

At a glance

依据 Android 官方「版本」文档完成平台适配:按版本号 N 抓取行为变更(所有应用、 targetSdk=N)、changes/features 子页与探索新功能/API;归纳影响项并落地到 Manifest/Gradle/工具类封装。在用户要求 Android 版本适配、行为变更排查、 targetSdk 升级、新 API 封装或对照…

  • Works in 5 steps: 确认目标 → 查看应用的行为变更 → 探索新功能和 API → …
  • Tasks that involve Android development
  • SKILL.md covers 适用范围, 仓库落点(弱化类名锚点), 版本参数 and 执行原则, plus 4 more sections
  • Calls curl; reaches developer.android.com

What it does

Android Version Platform Adapt is an agent skill from afkT/DevUtils. 依据 Android 官方「版本」文档完成平台适配:按版本号 N 抓取行为变更(所有应用、 targetSdk=N)、changes/features 子页与探索新功能/API;归纳影响项并落地到 Manifest/Gradle/工具类封装。在用户要求 Android 版本适配、行为变更排查、 targetSdk 升级、新 API 封装或对照 developer.android.com/about/versions 时使用。

Its SKILL.md is about 1.8k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including reference files (for example `references/reference.md`).

It sits in Mobile, covering Android development. It works with Android. The repository describes itself as: :fire: ( 持续更新,目前含 300+ 工具类 ) DevUtils 是一个 Android 工具库,主要根据不同功能模块,封装快捷使用的工具类及 API 方法调用。该项目尽可能的便于开发人员,快捷、高效开发安全可靠的项目。 The licence is Apache-2.0.

When your agent uses it

  • Tasks that involve Android development

Example prompts

  • “/android-version-platform-adapt”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. 确认目标
  2. 查看应用的行为变更
  3. 探索新功能和 API
  4. 产出与代码落地
  5. 扫描子目录(必做)

What it can do on your machine

Read from SKILL.md and the folder at commit 6022ede. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • curl

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • developer.android.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Android Version Platform Adapt loads about 1.8k tokens when it runs, and up to ~3.6k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 372 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~61
When it runs · the whole SKILL.md, loaded when a task matches
~1.8k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from afkT/DevUtils at commit 6022ede, republished under its Apache-2.0 licence (© afkT). 372 words, ~1,805 tokens.

Download SKILL.mdSave it as .claude/skills/android-version-platform-adapt/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
android-version-platform-adapt
description
依据 Android 官方「版本」文档完成平台适配:按版本号 N 抓取行为变更(所有应用、 targetSdk=N)、changes/features 子页与探索新功能/API;归纳影响项并落地到 Manifest/Gradle/工具类封装。在用户要求 Android 版本适配、行为变更排查、 targetSdk 升级、新 API 封装或对照 developer.android.com/about/versions 时使用。
disable-model-invocation
true

Android 版本平台适配(官方文档驱动)

适用范围

  • 为指定 Android 版本号 N(如 17、16)做 兼容性测试清单、targetSdk 升级、新 API 工具封装、行为变更修复。
  • 唯一事实来源:https://developer.android.com/about/versions/ 下该版本页面及子页(优先 ?hl=zh-cn)。
  • 禁止仅凭记忆或第三方转载编写适配结论;未读官方页面前不得断言某变更是否存在。

与仓库方法风格:生成或改写 方法体与文档 前,Read 并按 code-method-normalize/SKILL.md 执行。

仓库落点(弱化类名锚点)

符号当前值(DevUtils)说明
DEVAPP_ROOTlib/DevAppAndroid 平台工具类与版本判断封装的优先落点

新增平台 API 封装或行为变更缓解时,先在 {DEVAPP_ROOT} 按领域关键词检索同类 *Utils / *Version*,再决定扩展现有类或新增文件;不要在 SKILL 正文固定依赖某个历史类名。扫描示例、关键词与历史对照入口见 references/reference.md §仓库落点发现。

版本参数

用户表述URL 段 versions/{N}行为变更(target)页典型 API level
Android 1717behavior-changes-1737
Android 1616behavior-changes-1636
Android 1515behavior-changes-1535
  • N 与官网路径一致(Android 17 → 17)。
  • API level、VERSION_CODES 常量名以该版 setup-sdk 与 API 参考 为准;写 @RequiresApi 时与 {DEVAPP_ROOT} 下既有版本判断封装或同领域工具类对齐。
URL 模板(将 {N} 换为版本号)
用途URL
版本首页https://developer.android.com/about/versions/{N}?hl=zh-cn
行为变更 · 所有应用https://developer.android.com/about/versions/{N}/behavior-changes-all?hl=zh-cn
行为变更 · targetSdk={N}https://developer.android.com/about/versions/{N}/behavior-changes-{N}?hl=zh-cn
探索新功能与 APIhttps://developer.android.com/about/versions/{N}/features?hl=zh-cn
迁移指南https://developer.android.com/about/versions/{N}/migration?hl=zh-cn
SDK 设置https://developer.android.com/about/versions/{N}/setup-sdk?hl=zh-cn
发布说明https://developer.android.com/about/versions/{N}/release-notes?hl=zh-cn

Android 17 固定示例(与上表一致):

执行原则

  1. 先读再写:每个子步骤对应 URL 必须用 WebFetch(失败则 WebSearch + 重试)拉取正文后再归纳。
  2. 扫描子目录:主站导航不会列出全部深度页;在步骤 1、2 完成后,对 版本首页、两条 behavior 页、features 页、migration 页 提取指向 /about/versions/{N}/ 的链接,去重后按 references/reference.md 分类补读。
  3. 区分受众:
    • 所有应用:设备跑在 N 上即可能受影响(与 targetSdkVersion 无关)。
    • target N:仅 targetSdkVersion >= N 时强制或默认生效。
  4. 落地范围:只改任务相关模块;工具类优先扩展 {DEVAPP_ROOT} 下同领域 *Utils,落点不明确时先用 Glob / 内容检索找相近封装;类级或方法级 <pre> 可链官方页(历史扫描示例见 references/reference.md)。
  5. API 引用:新 API 以 Android API reference 为准;features 页仅作索引,实现前核对方法签名与 @RequiresApi。

工作流

0. 确认目标
  • 用户给出的 N、是否仅兼容性、是否升级 targetSdk / compileSdk。
  • 记录仓库当前 targetSdkVersion、compileSdk(build.gradle / versions.gradle)。
1. 查看应用的行为变更

按顺序执行;每步 WebFetch 对应 URL,摘录:变更名、影响条件、涉及 API/权限、缓解措施、是否需改代码。

1.1 所有应用
  • 阅读:.../behavior-changes-all?hl=zh-cn
  • 标注每条为 全量 / 条件(权限、厂商、前台等)。
1.2 以 Android {N} 为目标平台的应用
  • 阅读:.../behavior-changes-{N}?hl=zh-cn
  • 与 1.1 对比,避免重复记两条;target 专有条目标 「仅 target≥N」。
1.3 行为变更深度子页(changes/)
Show full SKILL.md (150 more words)Show less
1.4 行为变更相关参考子页
  • 阅读 migration 链接的辅助页,例如(存在则读):
    • .../changes/non-sdk-{N}
    • .../reference/compat-framework-changes
  • 用于测试开关、非 SDK 接口与兼容框架,不替代 1.1–1.2 主清单。
2. 探索新功能和 API
2.1 功能总览页
  • 阅读:.../features?hl=zh-cn
  • 按官方章节(Core / Privacy / Security / Media / Connectivity / UX 等)列出 新 API、新权限、新 Manifest 属性。
2.2 功能深度子页(features/)
  • 扫描 features 与版本首页中的 .../features/*,逐页 WebFetch(如 Android 17 的 features/contact-picker)。
2.3 交叉核对
  • release-notes:beta/最终版补充项与已修复问题。
  • migration / setup-sdk:构建、测试、兼容 toggles、模拟器/真机要求。
  • 需要 API 差异表时,读 features 页给出的 API diff report 链接(若有)。
3. 产出与代码落地
3.1 适配摘要(回复或 issue 均可)
markdown
## Android {N} 适配摘要

### 行为变更 · 所有应用
| 变更 | 影响模块/场景 | 建议动作 | 官方锚点 |
|------|---------------|----------|----------|

### 行为变更 · targetSdk {N}+
| 变更 | 影响 | 建议动作 | 官方锚点 |
|------|------|----------|----------|

### 新功能 / API(可选实现)
| 能力 | API/权限 | 仓库落点建议 | 文档 |
|------|----------|--------------|------|

### 测试建议
- [ ] 在 API {level} 模拟器/真机跑核心流程
- [ ] 若升级 targetSdk:复测 1.2 条目 + Play 目标平台要求
3.2 代码与文档
  • 新增/修改 Java 或 Kotlin 方法前:Read code-method-normalize。
  • @RequiresApi / {DEVAPP_ROOT} 下既有版本判断封装与 API level 一致;官方链接放在类或方法 <pre> 的 @see <a href="...">。
  • 行为变更 缓解(如后台音频、MessageQueue 反射、SMS OTP)优先 安全默认 + 可选 API,与 DevUtils 工具类风格一致。
4. 扫描子目录(必做)

对 {N} 执行链接发现(Agent 可用 shell 或解析 WebFetch 正文):

bash
# 将 17 换成目标 N;输出去重后的 /about/versions/{N}/ 路径
for u in \
  "https://developer.android.com/about/versions/{N}?hl=zh-cn" \
  "https://developer.android.com/about/versions/{N}/behavior-changes-all?hl=zh-cn" \
  "https://developer.android.com/about/versions/{N}/behavior-changes-{N}?hl=zh-cn" \
  "https://developer.android.com/about/versions/{N}/features?hl=zh-cn" \
  "https://developer.android.com/about/versions/{N}/migration?hl=zh-cn"; do
  curl -sL "$u" | grep -oE 'https://developer\.android\.com/about/versions/{N}[^"<> ]+' | sed 's/?hl=zh-cn//;s/?hl=en//'
done | sort -u
  • 将结果分为 behavior-changes-*、changes/*、features/*、reference/*、其它(migration/setup-sdk/release-notes/...)。
  • 凡未在 1–2 步读过的 changes/* 与 features/* 路径,补读后再更新摘要。

工作流清单(可复制)

- [ ] 0. 确认 Android N、API level、是否升 targetSdk
- [ ] 1.1 WebFetch behavior-changes-all
- [ ] 1.2 WebFetch behavior-changes-{N}
- [ ] 1.3 WebFetch 全部 changes/* 子页
- [ ] 1.4 WebFetch non-sdk / compat-framework(若 migration 指向)
- [ ] 2.1 WebFetch features
- [ ] 2.2 WebFetch 全部 features/* 子页
- [ ] 2.3 WebFetch release-notes、migration、setup-sdk(按需)
- [ ] 4. 扫描链接并补读遗漏子页
- [ ] 3.1 输出适配摘要表
- [ ] 3.2 代码:Read code-method-normalize → 实现/修复 → 链官方 URL

与其它 Skill 的分工

场景Skill
平台行为变更、新 API、targetSdk 适配本 Skill
方法 JavaDoc/KDoc、final、安全返回code-method-normalize
新增 Maven 依赖、AndroidX 版本project-gradle-central-deps / project-gradle-third-party-version-upgrade
DataBinding app:binding_*project-binding-adapter-from-source

附加说明

  • 页面以 英文 为主时,?hl=zh-cn 可能仍部分英文;以正文为准,链接用官方路径。
  • 官方页「Note: 详见 release notes」→ 必须打开 release-notes 补全。
  • 更多 Android 17 已扫描路径与 API 对照见 references/reference.md。

© afkT, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (references) in .cursor/skills/android-version-platform-adapt of afkT/DevUtils.

  • SKILL.md
  • references/reference.md

Open the folder on GitHubat commit 6022ede

Compare with similar skills

Android Version Platform Adapt next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Android Version Platform Adapt compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Android Version Platform Adapt this skillafkT/DevUtils1.6k—~1.8kAutomated safety check: PassApache-2.0
Android Hidden API and R8 Checkgkd-kit/gkd43k—~1.5kAutomated safety check: PassGPL-3.0
Android API Diffgkd-kit/gkd43k—~796Automated safety check: PassGPL-3.0
Android Readme Screenshot Studiopermissionlesstech/bitchat-android7.7k—~3kAutomated safety check: PassGPL-3.0
Compose Multiplatform Patternsmonta-app/ocpp-emulator1795 repos~2kAutomated safety check: PassApache-2.0
Android Tombstone Symbolicationdotnet/skills5.6k1 repos~2.1kAutomated safety check: PassMIT

Similar skills

  • Checks whether Android hidden-API implementations and system callbacks survive R8 minification, and diagnoses Release-only failures such as AbstractMethodError.

    43k GitHub stars~1.5k tokensUpdated yesterday
    MobileAuto-check passed
  • Android API Diff

    gkd-kit/gkd

    Looks up Android framework Java and AIDL APIs across versions with the android-api-diff CLI: signatures, availability, source files and hidden-API access code.

    43k GitHub stars~796 tokensUpdated yesterday
    MobileAuto-check passed
  • Android Readme Screenshot Studio

    permissionlesstech/bitchat-android

    Create or refresh polished, high-resolution screenshots of the Bitchat Android app for README and repository showcase use.

    7.7k GitHub stars~3k tokensUpdated yesterday
    MobileAuto-check passed
  • Compose Multiplatform Patterns

    monta-app/ocpp-emulator

    Compose Multiplatform and Jetpack Compose patterns for KMP projects — state management, navigation, theming, performance, and platform-specific UI.

    179 GitHub starsUsed in 5 repos~2k tokens
    MobileAuto-check passed
  • Official

    Resolves native crash frames from .NET Android tombstones to function names, source files and line numbers using BuildIds, Microsoft's symbol server and llvm-symbolizer.

    5.6k GitHub starsUsed in 1 repo~2.1k tokens
    MobileAuto-check passed
  • OpenGUI Bootstrap

    Core-Mate/OpenGUI

    Installs, configures and runs OpenGUI's backend and Android client from a plain-language request, running the repo's own setup scripts and asking the user only for physical phone steps or secrets.

    1.8k GitHub stars~1.7k tokensUpdated today
    MobileAuto-check: notes

More from afkT/DevUtils

All 13 skills in this repo
  • 统一 Android XML 资源命名:layout、drawable、mipmap、color、values、id 的前缀与 snakecase 规则;把颜色/圆角/描边/状态编码进文件名(bg、border、textcolor…selector)。

    1.6k GitHub stars~1.3k tokensUpdated 1 mo ago
    Auto-check passed
  • 根据用户给出的 Java/Kotlin 工具类或 View 相关源码,设计并实现 androidx.databinding.BindingAdapter。

    1.6k GitHub stars~1.6k tokensUpdated 1 mo ago
    Auto-check passed
  • 对 DevUtils 工程(DEPSROOT=file/gradle、DEPSMANIFEST=file/deps)中定义的第三方库 GAV 依赖做版本查证与升级;结合 Maven Central、Google Maven、Gradle Plugin Portal、 JitPack 与 GitHub Releases/README 交叉校验「最新可用版本」;必要时修正…

    1.6k GitHub stars~1.2k tokensUpdated 1 mo ago
    Auto-check passed
  • 为布局 XML 中的控件默认补全 DevSimple(lib/DevSimple)的 ViewTheme 样式引用: 按控件继承链匹配 ViewTheme.&lt;类名&gt;,ImageView/AppCompatImageView 使用 ViewTheme.ImageView.FITXY,无匹配则用 ViewTheme.View。工作区内优先 Read…

    1.6k GitHub stars~727 tokensUpdated 1 mo ago
    Auto-check passed
  • UI Devwidget Round

    afkT/DevUtils

    在需要圆角矩形纯色背景、描边边框时,优先用 DevWidget(io.github.afkt:DevWidgetX)的 dev.widget.ui.round 包替代 shape / layer-list drawable。流程与核心坑在 SKILL,Round 系列 View、R.styleable.DevWidget 中 app:dev 属性及源码对照见…

    1.6k GitHub stars~880 tokensUpdated 1 mo ago
    Auto-check passed
  • UI Dialogx Dialog

    afkT/DevUtils

    需要对话框、弹窗、菜单、加载等待、轻提示(Toast 替代)、应用内通知、底部弹窗、 上下文菜单、全屏/自定义弹层或操作引导时,默认使用 DialogX (com.github.kongzue.DialogX,本工程已依赖)而非系统 AlertDialog/Toast/PopupMenu。

    1.6k GitHub stars~1.1k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Categories

Questions about Android Version Platform Adapt

What does Android Version Platform Adapt do?

依据 Android 官方「版本」文档完成平台适配:按版本号 N 抓取行为变更(所有应用、 targetSdk=N)、changes/features 子页与探索新功能/API;归纳影响项并落地到 Manifest/Gradle/工具类封装。在用户要求 Android 版本适配、行为变更排查、 targetSdk 升级、新 API 封装或对照…. Android Version Platform Adapt is an agent skill from afkT/DevUtils.

When should I use Android Version Platform Adapt?

Android Version Platform Adapt fits situations like: tasks that involve Android development.

How do I install Android Version Platform Adapt in Claude Code?

Run `npx skills add afkT/DevUtils --skill android-version-platform-adapt -a claude-code`. Or copy the skill folder (.cursor/skills/android-version-platform-adapt in afkT/DevUtils) into .claude/skills/android-version-platform-adapt in your project. Claude Code loads it when a task matches its description.

How do I install Android Version Platform Adapt in Codex?

Run `npx skills add afkT/DevUtils --skill android-version-platform-adapt -a codex`. Or copy the skill folder (.cursor/skills/android-version-platform-adapt in afkT/DevUtils) into .agents/skills/android-version-platform-adapt in your project. Codex loads it when a task matches its description.

Can I use Android Version Platform Adapt in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add afkT/DevUtils --skill android-version-platform-adapt -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/android-version-platform-adapt, .gemini/skills/android-version-platform-adapt, .github/skills/android-version-platform-adapt and .opencode/skills/android-version-platform-adapt in your project.

What does Android Version Platform Adapt need to run?

Going by SKILL.md and its folder, Android Version Platform Adapt needs the command-line tools its instructions call (curl).

Does Android Version Platform Adapt access the network?

SKILL.md names 1 domain. In commands or code: developer.android.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Android Version Platform Adapt safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Android Version Platform Adapt use?

Android Version Platform Adapt is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Android Version Platform Adapt use?

About 1.8k tokens (SKILL.md is roughly 7.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.8k tokens, read only when the agent opens those files.

What are the alternatives to Android Version Platform Adapt?

Skills that share tags, products or a category with Android Version Platform Adapt: Android Hidden API and R8 Check (gkd-kit/gkd, 43k stars), Android API Diff (gkd-kit/gkd, 43k stars), Android Readme Screenshot Studio (permissionlesstech/bitchat-android, 7.7k stars) and Compose Multiplatform Patterns (monta-app/ocpp-emulator, 179 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Android Version Platform Adapt?

afkT (a GitHub user) maintains it in afkT/DevUtils, which has 1,612 GitHub stars. The repository holds 13 skills in this directory. The repository was last updated on September 2, 2026.

Source: afkT/DevUtils on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.