google-mobile-ads-android-migrate-to-next-gen-google-skills

1. 基本信息

项目	内容
名称	google-mobile-ads-android-migrate-to-next-gen-google-skills
作者/维护者	Google LLC（google/skills 官方仓库，数据来自 GitHub API）
来源链接	https://github.com/google/skills/tree/main/skills/ads/google-mobile-ads-android-migrate-to-next-gen
许可证	Apache-2.0（数据来自 GitHub API）
GitHub Stars	仓库整体 15,349★（合集仓库整体数字，不代表本技能个体热度，数据来自 GitHub API）
Forks	仓库整体 1,201（数据来自 GitHub API）
最新版本	SKILL.md metadata 记录 version 1.1.0（数据来自 SKILL.md）
安装方式	`npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen`（数据来自官方文档页面）

项目自述名称：SKILL.md 中的 name 字段为 google-mobile-ads-android-migrate-to-next-gen；为遵循命名规范（合集仓库子技能需带拥有者与仓库名，避免跨合集重名冲突），正式名称记为 google-mobile-ads-android-migrate-to-next-gen-google-skills。

2. 功能介绍与亮点

指导 Agent 把 Android 应用从旧版 Google Mobile Ads（GMA）SDK（com.google.android.gms:play-services-ads）迁移到新版 GMA Next-Gen SDK（com.google.android.libraries.ads.mobile.sdk）。
提供一份约 40KB 的完整迁移清单：Gradle 依赖替换 → minSdk/compileSdk 升级 → 按 API 映射表与方法映射表逐文件重构 import/类名/方法签名 → gradle build 验证；映射表覆盖 Banner/Interstitial/Rewarded/Native/App Open 等全部广告形式的类、方法与回调接口对应关系。
明确标注若干迁移陷阱（如新 SDK 回调统一运行在后台线程，UI 操作必须包裹进 runOnUiThread，否则应用会崩溃；Mediation Adapter 实现类仍须保留旧 SDK 引用）。
2026 年 7 月，Google Ads 开发者官方博客发布专文，宣布 GMA Next-Gen SDK 成为 Android 首选 SDK；developers.google.com 为本技能单独开辟了产品文档页面（admob/android/next-gen/migration/migrate-with-ai-tools），页面本身而非仅代码仓库列出安装命令与受支持的 Agent 工具，且标注“beta”并于 2026-07-30 更新。
独立第三方科技媒体 ppc.land 于 2026-07-12 发文点名介绍本技能，背景是 Google 已公布旧版 SDK 2028-06-30 停用的明确时间表。

3. 适用场景

固定分类：集成与工作流自动化

已有旧版 Google Mobile Ads SDK 集成、需要在 Google 公布的时间表内完成迁移的 Android 开发者与团队。
广告变现代码分散在多个文件、手动比对新旧 API 差异成本高的中大型 Android 项目维护者。
使用 Mediation 混合多家广告联盟的开发者，可借助技能内 Mediation 专项规则避免迁移后适配器失效。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——官方文档页面明确列出 Claude Code 为受支持助手，安装路径 .claude/skills/。
Codex：✅ 原生支持——同一官方文档页面明确列出 Codex，安装路径 .agents/skills/。
OpenClaw：✅ 支持——官方安装命令使用的 CLI 工具（npx skills add，对应 npm 包 skills，仓库指向 vercel-labs/skills）在其自身 README 中明确列出 OpenClaw 支持，安装路径 skills/ 或 ~/.openclaw/skills/。
Hermes Agent：✅ 支持——同一 CLI README 列出 Hermes Agent 支持，安装路径 .hermes/skills/ 或 ~/.hermes/skills/。

注：Google 官方文档页面本身点名的是 Antigravity / Claude Code / Codex / Cursor 四款助手；OpenClaw 与 Hermes Agent 的支持证据来自其推荐安装器 CLI 自身文档的通用兼容性列表，而非 Google 文档直接点名。

5. 推荐理由

Google 已明确 GMA Next-Gen SDK 的迁移时间表，涉及数十个类名、方法签名与回调接口的破坏性变更，人工逐文件比对极易出错且耗时。这个技能把官方迁移规则转成 Agent 可直接执行的结构化映射表与校验清单，并显式标注了容易导致崩溃的隐蔽陷阱，帮助开发者在截止日期前更快、更少出错地完成迁移。

6. 评分

维度	分数	说明
受欢迎程度	8	Google Ads 开发者官方博客专文宣布 + `developers.google.com` 为本技能单独开辟的产品文档页面（非仅存在于代码仓库）+ 独立第三方科技媒体 ppc.land 专文点名介绍；仓库整体星数不计入本技能个体评分
可用性	8	官方一条命令可安装，SKILL.md 含完整 API/方法映射表与分步 checklist，官方文档页 2026-07-30 刚更新、标注持续维护，零付费依赖；迁移任务本身需要在真实 Android 代码库中配合 Gradle 构建反复验证才能完成
安全性	9	内容以配置指导与代码重构规则为主，仅含一条读取 Google 公开 Maven 元数据的透明 `curl` 命令，无凭据索取、无用户数据外发，来源为官方仓库、Apache-2.0 完全开源可审计

安全检查清单： ① Shell 命令/权限范围：仅一条读取公开 Maven 版本元数据的 curl 命令与标准 gradle build 构建命令，用途透明 ② 联网外发数据：无——仅读取 Google 官方公开元数据，不上传任何项目或用户数据 ③ API Key/凭据：不涉及——技能只处理代码层面的 SDK 迁移，不索取任何账号凭据 ④ 可疑指令：未发现——通读全文（约 200 行）无混淆代码或隐蔽指令 ⑤ 作者/组织信誉：Google LLC 官方出品，信誉良好 ⑥ License：Apache-2.0，明确

综合评分 = (8+8+9)/3 ≈ 8.33

7. 跟同类 Skills 相比的优势

对比对象	定位	与本技能的差异
Gemini in Android Studio + AGENTS.md 方案（Google 官方）	在项目中放置 AGENTS.md 文件，为 Android Studio 内置的 Gemini 提供 GMA Next-Gen SDK 迁移上下文	绑定 Android Studio 内置 Gemini，不支持 Claude Code/Codex 等外部 Agent；本技能是可移植的独立 SKILL.md，能安装进任意遵循 Agent Skills 规范的工具
官方人工迁移指南（`developers.google.com/admob/android/next-gen/migration`）	面向人类阅读的传统分步文档与 API 参考页面	需要开发者自行阅读、逐条比对新旧 API 差异后手动改写代码；本技能把同一批规则转成结构化映射表与 checklist，交给 Agent 直接执行迁移而非人工誊抄

目前 Android 广告 SDK 迁移场景尚未见到其他结构化 Agent Skill 覆盖同等完整度的 API/方法映射；现有替代方案要么锁定单一 IDE 内置助手，要么是需要人工逐条比对的传统文档。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价。独立科技媒体 ppc.land 于 2026-07-12 发文介绍了该技能的用途与发布背景，但属于媒体报道而非用户评价。

9. 其他补充

该技能与同目录下的 google-mobile-ads-get-started、banner、interstitial、rewarded 共同构成完整的 Google Mobile Ads 技能簇，前者负责全新接入，本技能负责已有集成的版本迁移，可按需搭配安装。官方文档页面将本技能标注为 “beta” 阶段。

10. 安装使用方式

通用多 Agent CLI（推荐，支持 Claude Code / Codex / OpenClaw / Hermes Agent）：

npx skills add google/skills --skill google-mobile-ads-android-migrate-to-next-gen

后续更新用 npx skills update --all。安装完成无需重启，向 Agent 描述迁移需求即可自动触发（如“帮我把这个 Android 项目从旧版 Google Mobile Ads SDK 迁移到 Next-Gen SDK”）。

11. 注意事项

仅覆盖 Android 平台的迁移规则，不含 iOS/Unity 迁移内容。
迁移涉及大量 API 签名与回调接口的破坏性变更，建议在独立分支中进行并配合完整测试；跳过“UI 操作需包裹进主线程”等提示可能导致应用崩溃。
官方文档页面标注技能仍处于 “beta” 阶段，接口与映射表内容可能随 SDK 版本更新而调整。
使用 Mediation（第三方广告联盟）的项目需留意：实现 Adapter 接口的类仍须继续使用旧 SDK 引用，技能内已注明该例外规则。