Community生产力与协作github.com

lerchenflo/claudeskills

分析安卓应用以识别关键用户工作流并生成 AppFunction,同时优化 KDoc 文档以帮助 AI 代理正确使用这些功能。

claudeskills 是什么?

该技能专门用于分析 Android 应用,识别出无需打开应用界面即可执行的关键用户工作流(例如创建笔记、播放媒体、发送自动化或 AI 代理触发的消息、语音命令或系统快捷方式)。它能够自动生成 Kotlin 代码,将这些工作流暴露为 Android 系统的 AppFunction,使系统代理能够发现并在设备上直接执行它们。此外,该技能还会优化和精炼 KDoc 文档,确保 AI 代理能够正确理解和调用所提供功能。它主要面向使用 `targetSdk 36` 及以上、`compileSdk 37` 及以上的 Android 项目,并推荐使用 Jetpack 库以实现向后兼容。整个工作流包括四个阶段:发现(分析代码识别潜在功能)、实现与配置(生成 Kotlin 代码和系统配置)、KDoc 优化(为 AI 代理和模型上下文协议优化描述)、以及测试与调试(通过 ADB 命令进行本地验证)。用户被鼓励完整遵循所有步骤。

兼容平台✓Claude Code~Codex CLI~Cursor✓Antigravity
npx skills add https://github.com/lerchenflo/claudeskills/tree/HEAD/android/appfunctions

Installed? Explore more 生产力与协作 skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

分析安卓应用以识别关键用户工作流,以用于 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。
  • 安全性:未经用户确认,不要暴露敏感数据或执行破坏性操作。

故障排除

  • 如果您遇到构建时错误(例如 Kotlin 符号处理 (KSP) 问题),请参阅 实现与配置。
  • 如果您遇到运行时错误(例如缺少服务或执行失败),请参阅 测试与调试。
  • 如果您需要架构定义和词汇,请参阅 上下文与术语。
  • 如果您在升级旧配置时遇到问题,请参阅 迁移到服务入口点。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

相关技能