为 Android 应用接入 AppFunctions 时…

当要让 Android 系统或 AI 智能体无需打开应用 UI 就能发现并执行应用内工作流（如创建笔记、播放媒体、发送消息）时使用。

适用场景

解决思路

1. 确认并配置应用满足 AppFunctions 前提：targetSdk 36 或更高、compileSdk 37 或更高；AppFunctions 属于 Android 平台 API，从 Android 16 起可用。
2. 始终使用 Jetpack 库，以处理向后兼容。
3. 第 1 步 Discovery：分析 Android 代码库，识别并推荐可暴露为 AppFunctions 的潜在功能，例如创建笔记、播放媒体、发送自动化或 AI 智能体触发的消息、语音命令、系统快捷方式。
4. 第 2 步 Implementation and configuration：生成 AppFunctions 的 Kotlin 实现，管理系统级配置，并配置构建依赖，包括为 AppFunctions 配置 Hilt。
5. 第 3 步 KDoc refinement：针对 AI 智能体和 Model Context Protocol（MCP）优化 AppFunction 的 KDoc；重写或重构面向 LLM 的工具描述。
6. 第 4 步 Testing and debugging：提供使用 ADB 与 AppFunctions 交互的命令，用于测试和调试，包括列出 app functions、调用 app function、验证 app function 注册。
7. 如果用户只请求部分步骤，应鼓励他们使用全部四个步骤。
8. 生成 Kotlin 代码，将这些工作流暴露给 Android 系统，使智能体能在设备上发现并执行它们，而无需打开应用 UI。
9. 优化 KDoc 文档，确保 AI 智能体正确理解并使用所提供功能。
10. 适用时加载 references/context.md：获取通用语言、架构定义和设计模式；理解核心架构术语，并检查现代与旧版 AppFunctions API 的区别。
11. 适用时加载 references/migrate-to-service-entry-point.md：按系统化流程将使用 AppFunctions 1.0.0-alpha09 及更低版本的应用迁移到 1.0.0-alpha10 引入的 AppFunctionServiceEntryPoint 架构；遇到旧版 AppFunctionConfiguration.Provider 实现时也要加载。
12. 保持模块一致性：生成 AppFunction 实现后，立即完善 KDoc。
13. 遵守安全约束：不暴露敏感数据；未经用户确认不执行破坏性操作。
14. 遇到 KSP 等构建期错误时，查阅 references/implementation-configuration.md。
15. 遇到缺失服务或执行失败等运行期错误时，查阅 references/adb-interaction-testing.md。
16. 需要架构定义和词汇时，查阅 references/context.md。
17. 升级旧配置遇到问题时，查阅 references/migrate-to-service-entry-point.md。

适用边界 · 注意事项

• 应用 targetSdk 低于 36 或 compileSdk 低于 37，或目标平台低于 Android 16 时，不适用。
• 任务与 Android AppFunctions 或让系统智能体发现并执行应用内工作流无关时，不适用。
• 无法使用 Android SDK、Jetpack、KSP、ADB 或无法修改 Android 工程时，不适用。