1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | ml-kit-genai-prompt-api-android-skills |
| 作者/维护者 | Google LLC（android/skills 官方仓库） |
| 来源链接 | https://github.com/android/skills/tree/main/device-ai/ml-kit-genai-prompt-api |
| 许可证 | Apache License 2.0（来自 GitHub API） |
| GitHub Stars | 7,313（来自 GitHub API；数字属整个 android/skills 合集仓库，不代表本技能自身热度） |
| Forks | 476（来自 GitHub API） |
| 最新版本 | 无独立版本号，随仓库滚动更新；本技能文件最近一次更新于 2026-09-07（来自 GitHub API 提交记录） |
| 安装方式 | Android CLI 一条命令，或手动复制该子目录进 agent 的 skills 目录 |
2. 功能介绍与亮点
本技能指导在 Android 应用中集成 ML Kit 的 GenAI Prompt API——一套面向 Gemini Nano 设备端大模型的自定义提示词接口。核心能力：
- 提示词优化：链接官方提示优化指南，指导如何改写提示以提升设备端模型输出质量。
- 前缀缓存（Prefix Caching）：提示词超过 200 词时，指导实现前缀缓存以降低重复推理开销。
- 生命周期管理：明确要求在 Activity/Fragment/ViewModel 销毁时调用
close()释放模型实例，并给出代码示例。 - 结构化输出（Structured Output）：给出把非结构化字符串返回值重构为
@Generable类型化对象的完整前后对比代码。
亮点：官方 Google 出品、完全开源可审计；单文件自包含，不依赖外部付费服务（推理完全在设备端进行）。
3. 适用场景
固定分类：工程效率与代码质量（围绕在既有 Android 代码库中集成、重构 SDK 调用这一编码任务）。
适用于已在应用中引入或计划引入 ML Kit GenAI Prompt API、需要为设备端 Gemini Nano 功能编写或重构代码的 Android 工程师——包括新增自然语言处理功能、把现有 Prompt 调用迁移为类型化结构化输出、或优化长提示词的推理性能。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 SKILL.md（YAML front matter + Markdown 正文），符合 Agent Skills 开放规范。
- Codex：✅ 原生支持——同一开放规范，可直接安装到 Codex 的技能目录。
- OpenClaw：⚠️ 未验证。
- Hermes Agent：⚠️ 未验证。
5. 推荐理由
Google 官方对 Gemini Nano 设备端生成式 AI 接入方式的第一手权威指南，把提示优化、前缀缓存、生命周期管理、结构化输出四项踩坑点提前写清楚，帮 Android 工程师减少反复查阅多篇文档的成本。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 是所服务的 Android 平台与 ML Kit SDK 的第一方；本技能 2026-09-07 才加入仓库，尚无该技能自身的独立第三方讨论或引用证据 |
| 可用性 | 9 | 单文件自包含、前置条件（API 26+、依赖版本）与代码示例齐全，一周内有更新，无付费依赖 |
| 安全性 | 9 | 纯 Markdown 指南，无 shell 执行、无外联；推理在设备端完成；开源可审计，无可疑指令 |
安全检查清单：①无 shell 命令执行 ②不联网外发数据（推理在设备端完成）③不要求 API Key，仅要求本地 Gradle 依赖 ④正文未见提示注入或隐蔽指令 ⑤作者为 Google LLC，信誉良好 ⑥License 明确（Apache-2.0）⑦最近维护时间为 2026-09-07，处于活跃期。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| googlesamples/mlkit（官方示例仓库） | 完整可运行的 Kotlin/Java 示例 App 源码 | 面向“看示例学用法”，非 Agent Skills 格式，AI 无法直接作为结构化指令加载执行 |
| camerax-android-skills（同仓库） | CameraX 相机 SDK 集成指南 | 覆盖完全不同的 SDK 领域（相机而非设备端生成式 AI），受众不重叠 |
| 通用提示词工程类技能 | 面向任意平台的 Prompt 编写方法论 | 不含 Android 特定的 API 签名、依赖版本、生命周期管理等平台细节 |
8. 用户评价
该技能于 2026-09-07 刚加入仓库，目前在 GitHub Issues、Reddit、Hacker News 等平台尚无针对该技能本身的具名用户评价。其底层的 ML Kit GenAI Prompt API 已有 InfoQ 等技术媒体报道及 Kakao Mobility 的公开生产案例（包裹信息提取、违规停车检测，官方博客披露带来 45% 新用户转化率提升），但该评价针对的是 API 本身，不构成对本技能文件的直接评价。
9. 其他补充
暂无。
10. 安装使用方式
- Android CLI（推荐）：
android skills add ml-kit-genai-prompt-api --project=. - 手动安装：将
device-ai/ml-kit-genai-prompt-api/目录（含 SKILL.md 及 references/）复制进所用 agent 的 skills 目录。 - 安装后无需重启；当用户提出与设备端 Gemini Nano、Prompt API 相关的开发需求时，agent 会自动识别并调用本技能。
11. 注意事项
- 要求应用
minSdk≥ 26，且 ML Kit GenAI Prompt API 依赖版本 ≥ 1.0.0-beta4（目前仍为 Beta 阶段，接口可能变动）。 - 该技能仅覆盖客户端集成，不含服务端逻辑；模型推理效果与设备硬件（尤其是否支持 Gemini Nano）直接相关，非全部 Android 机型可用。