1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | appfunctions-android-skills |
| 作者/维护者 | Google LLC（android/skills 官方仓库） |
| 来源链接 | https://github.com/android/skills/tree/main/device-ai/appfunctions |
| 许可证 | Apache License 2.0（来自 GitHub API，适用于整个 android/skills 仓库） |
| GitHub Stars | 7,324（来自 GitHub API；数字属整个 android/skills 合集仓库，不代表本技能自身热度） |
| Forks | 476（来自 GitHub API） |
| 最新版本 | 无独立版本号，随仓库滚动更新；本技能文件最近一次更新于 2026-08-14（来自 SKILL.md metadata） |
| 安装方式 | Android CLI 一条命令，或手动复制该子目录进 agent 的 skills 目录 |
2. 功能介绍与亮点
本技能指导在 Android 应用中实现 AppFunctions——Android 16 引入的平台级能力，让系统代理（以及连接设备的 AI agent）无需打开应用界面即可发现并调用应用内的具体工作流（如创建笔记、播放媒体、发送消息）。核心能力分四步：
- 功能发现分析：扫描现有代码库，识别哪些用户工作流适合暴露为 AppFunctions。
- 实现与配置：生成暴露工作流所需的 Kotlin 代码，并配置 Hilt/KSP 等构建依赖。
- KDoc 优化：把函数文档改写为 AI agent 能准确理解的描述，供 Model Context Protocol 等场景复用。
- 调试测试：给出通过 ADB 命令列出、调用、校验已注册 AppFunction 的具体操作。
亮点：官方 Google 出品、完全开源可审计；明确要求“生成实现后必须同步刷新 KDoc”，把文档漂移这个常见问题写进了强制流程；另附从旧版 AppFunctionConfiguration.Provider 迁移到新版服务入口架构的专门指南。
3. 适用场景
固定分类：工程效率与代码质量（围绕在既有 Android 代码库中新增/重构平台 API 集成代码这一编码任务，与同仓库 ml-kit-genai-prompt-api、verified-email、restore-credentials 等平台 SDK 集成类技能同类）。
适用于应用已升级到 targetSdk 36、compileSdk 37（Android 16）及以上、希望让应用功能被系统级 AI agent 发现调用的 Android 工程师——包括新增可被语音/agent 触发的工作流、为现有功能补充符合 MCP 规范的函数描述、或从旧版 AppFunctions 实现迁移到新架构。
4. 跨 Agent 兼容性
- Claude Code：✅ 原生支持——标准 SKILL.md（YAML front matter + Markdown 正文），符合 Agent Skills 开放规范。
- Codex：✅ 原生支持——同一开放规范，可直接安装到 Codex 的技能目录。
- OpenClaw：⚠️ 未验证。
- Hermes Agent：⚠️ 未验证。
5. 推荐理由
Google 官方对 Android 16 全新平台能力 AppFunctions 的第一手实现指南，把“扫描代码找候选工作流→生成实现→优化 agent 可读文档→调试校验”完整流程标准化，尤其抓住了“文档必须与实现同步刷新”这个此前极易被忽略的细节，帮工程师少走弯路。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 发布方 Google 是 Android 平台与 AppFunctions API 的第一方；本技能 2026-08-14 才加入仓库，尚无该技能自身的独立第三方讨论或引用证据 |
| 可用性 | 7 | 四步工作流与参考文档齐全、近一个月内有更新，但硬性要求 targetSdk 36/compileSdk 37（Android 16）——多数现存应用短期内达不到该前置条件，实际可用范围受限 |
| 安全性 | 9 | 纯代码生成与文档指南，无外联；正文明确写入“不得在未经用户确认前暴露敏感数据或执行破坏性操作”的安全约束；开源可审计，无可疑指令 |
安全检查清单：①无 shell 命令执行（仅涉及本地 Gradle 编译）②不联网外发数据 ③不要求 API Key ④正文未见提示注入或隐蔽指令，且主动写入“不得未经确认暴露敏感数据/执行破坏性操作”的约束 ⑤作者为 Google LLC，信誉良好 ⑥License 明确（Apache-2.0）⑦最近维护时间为 2026-08-14，处于活跃期。
7. 跟同类 Skills 相比的优势
| 对比对象 | 定位 | 与本技能的差异 |
|---|---|---|
| mcp-builder-anthropics-skills（同索引内） | 指导构建 Model Context Protocol 服务器，供 AI 客户端跨进程调用外部工具 | 面向“任意平台+MCP 协议”的工具封装，运行在应用进程之外；本技能面向 Android 系统原生 API，工作流直接注册进应用本身、由系统级 agent 发现调用，无需额外起服务进程 |
| ml-kit-genai-prompt-api-android-skills（同仓库） | 集成设备端 Gemini Nano 生成式 AI 推理接口 | 解决“应用如何调用 AI 模型”；本技能解决“AI agent 如何调用应用功能”，两者方向相反且可配合使用 |
| 传统 Android App Shortcuts / Slices | 静态声明快捷方式供启动器展示 | 面向人类用户点击触发，功能与参数固定；AppFunctions 面向 agent 动态发现与传参调用，覆盖更灵活的工作流 |
8. 用户评价
该技能所在的 android/skills 仓库已被多个第三方镜像与聚合目录收录，但截至目前在 GitHub Issues、Reddit、Hacker News 等平台尚无针对 appfunctions 这一具体技能文件的具名用户评价；其底层的 AppFunctions 平台 API 本身也仍处于 Android 16 刚发布后的早期采用阶段。
9. 其他补充
暂无。
10. 安装使用方式
- Android CLI（推荐）：
android skills add appfunctions --project=. - 手动安装：将
device-ai/appfunctions/目录（含 SKILL.md 及 references/）复制进所用 agent 的 skills 目录。 - 安装后无需重启；当用户提出“发现 AppFunctions”“实现 AppFunctions”“优化 KDoc 供 agent 使用”或“调试/校验 AppFunction 注册”等相关需求时，agent 会自动识别并调用本技能。
11. 注意事项
- 硬性前置条件：应用必须
targetSdk 36且compileSdk 37及以上（对应 Android 16），低于该版本的项目需先完成 SDK 升级才能使用本技能。 - 技能要求“生成实现后必须立即刷新 KDoc”，若中途跳过某个工作流步骤，正文明确要求鼓励用户仍完整走完全部四步。
- 仅覆盖客户端实现与调试，不含服务端逻辑；AppFunctions 作为平台新特性，实际生态与工具链仍在快速演进中。