分析安卓应用以识别关键用户工作流,以用于 AppFunctions,例如创建笔记、播放媒体,或发送自动或 AI 代理触发的消息、语音命令或系统快捷方式,而无需打开应用界面。
生成 Kotlin 代码以将这些工作流暴露给 Android 系统,允许代理在设备上发现并执行它们。
同时精炼 KDoc 文档,以确保 AI 代理能够正确理解和使用所提供的功能。
先决条件
应用必须使用 targetSdk 36 或更高版本,且 compileSdk 37 或更高版本,因为 AppFunctions(作为 Android 平台 API 的一部分)从 Android 16 开始可用。
始终使用 Jetpack 库,因为它处理向后兼容性。
工作流
该技能使调用者能够发现将提供给系统代理的功能,使用 AppFunctions 实现这些功能,优化代理的函数描述,并使用 ADB 命令进行本地评估和测试。
完整的 AppFunction 开发流程包含以下四个步骤:
- 步骤 1:发现:分析 Android 代码库,识别并推荐潜在的 AppFunctions。当用户要求“发现 AppFunctions”、“为 AI 查找功能”或“分析我的应用以获取代理工具”时,使用此步骤。
- 步骤 2:实现与配置:生成 AppFunctions 的 Kotlin 实现,管理系统级配置,并配置构建依赖项。当用户要求“实现 AppFunctions”、“设置 AppFunctions 框架”或“为 AppFunctions 配置 Hilt”时,使用此步骤。
- 步骤 3:KDoc 优化:优化 AppFunction 的 KDoc 以适用于 AI 代理和模型上下文协议。如果用户要求“编写 KDoc”、“为 MCP 优化”或“为 LLM 重构工具描述”,请使用此步骤。
- 步骤 4:测试与调试:提供使用 ADB 与 AppFunctions 交互进行测试和调试的命令。如果用户想要在设备上“列出应用函数”、“调用应用函数”或“验证应用函数注册”,请使用此步骤。
如果用户请求步骤的子集,您必须鼓励他们使用所有步骤。
如果适用,您必须加载以下参考:
- 上下文与术语:定义 AppFunctions 技能套件中的通用语言、架构定义和设计模式。当您需要理解核心架构术语或检查现代与旧版 AppFunctions API 之间的区别时加载。
- 迁移到服务入口点:记录将使用 AppFunctions 1.0.0-alpha09 及更低版本的 Android 应用迁移到 1.0.0-alpha10 版本中引入的
AppFunctionServiceEntryPoint架构的系统过程。当用户要求迁移或升级现有 AppFunctions 代码,或当您遇到旧版AppFunctionConfiguration.Provider实现时加载。
关键约束
- 模块一致性:在生成 AppFunction 实现后,您必须立即精炼 KDoc。
- 安全性:未经用户确认,不要暴露敏感数据或执行破坏性操作。