appfunctions

分析 Android 应用，识别可通过 AppFunctions 实现的关键用户工作流，例如创建笔记、播放媒体，或发送由自动化或 AI Agent 触发的消息，以及语音命令或系统快捷方式，无需打开应用 UI。

生成 Kotlin 代码，将这些工作流开放给 Android 系统，以便 Agent 在设备上发现并执行它们。

还会优化 KDoc 文档，确保 AI Agent 正确理解并使用所提供的功能。

先决条件

应用必须使用 targetSdk 36 或更高版本，并且使用 compileSdk 37 或更高版本，因为 AppFunctions 是 Android 平台 API 的一部分，从 Android 16 起提供。 务必使用 Jetpack 库，因为它负责处理向后兼容性。

工作流

此技能可让调用方发现将提供给系统 Agent 的功能，使用 AppFunctions 实现这些功能，改进面向 Agent 的函数说明，并使用 ADB 命令进行本地评估和测试。

完整的 AppFunction 开发流程包含以下四个步骤：

• 步骤 1：发现：分析 Android 代码库，识别并推荐潜在的 AppFunctions。当用户要求“发现 AppFunctions”“查找适用于 AI 的功能”或“分析我的应用以寻找 Agent 工具”时，使用此步骤。
• 步骤 2：实现和配置：生成 AppFunctions 的 Kotlin 实现，管理系统范围的配置，并配置构建依赖项。当用户要求“实现 AppFunctions”“设置 AppFunctions 框架”或“为 AppFunctions 配置 Hilt”时，使用此步骤。
• 步骤 3：优化 KDoc：优化面向 AI Agent 和 Model Context Protocol 的 AppFunction KDoc。当用户要求“编写 KDoc”“针对 MCP 进行优化”或“为大模型重构工具说明”时，使用此步骤。
• 步骤 4：测试和调试：提供使用 ADB 与 AppFunctions 交互以进行测试和调试的命令。当用户想要在设备上“列出应用函数”“调用应用函数”或“验证应用函数注册情况”时，使用此步骤。

如果用户只要求执行部分步骤，必须鼓励他们使用全部步骤。

如果适用，必须加载以下参考资料：

• 上下文和术语：定义 AppFunctions 技能套件中的通用语言、架构定义和设计模式。当需要了解核心架构术语或确认现代与旧版 AppFunctions API 之间的区别时加载。
• 迁移到服务入口点 ：介绍将使用 AppFunctions 1.0.0-alpha09 及更低版本的 Android 应用迁移到 1.0.0-alpha10 版本引入的 AppFunctionServiceEntryPoint 架构的系统化流程。当用户要求迁移或升级现有 AppFunctions 代码，或遇到旧版 AppFunctionConfiguration.Provider 实现时加载。

关键限制

• 模块一致性：生成 AppFunction 实现后，必须立即优化 KDoc。
• 安全性：未经用户确认，不要公开敏感数据或执行破坏性操作。

故障排除

• 如果遇到 Kotlin Symbol Processing (KSP) 问题等构建时错误，请参阅实现和配置。
• 如果遇到服务缺失或执行失败等运行时错误，请参阅测试和调试。
• 如果需要了解架构定义和术语，请参阅上下文和术语。
• 如果升级旧版配置时遇到问题，请参阅迁移到服务入口点。