Android 技能是经过 AI 优化的指令,可帮助 AI 工具和智能体更好地理解和执行特定模式,这些模式遵循 Android 开发的最佳实践和指南。这些示例位于 Android 技能 GitHub 代码库中。
您可以使用 Android 技能执行以下任务:
- 从 XML 迁移到 Compose
- 让应用界面能够自适应手机、可折叠设备、平板电脑、Googlebook 和 ChromeOS 设备
- 升级到 AGP 9
- 设置 Navigation 3 等较新的框架
- 通过采用无边框设计,让应用界面更具现代感
- 通过审核 R8 配置来提升性能
通过使用 Android 技能,您可以帮助 LLM 掌握有关专业 Android 工作流的最新知识和上下文。
Android 技能遵循智能体技能开放标准,因此可与任何支持技能的 AI 工具兼容。本页面介绍了如何在 Android Studio 中使用技能,以及如何使用 Android CLI 安装技能,以便与您选择的任何代理和工具搭配使用。
Android skill 的主要优势
Android 技能可提供多项关键优势,旨在加速您的智能体工作流,从而更高效地生成高质量的 Android 代码:
- 以专家知识为依据:为智能体提供更多 Android 专属上下文,使其能够按需接地,并在常规模型训练周期之外扩展其默认知识和专业技能。
- 可重复的工作流:提供标准说明,帮助确保 Android 开发者在 Android 开发中的多步骤任务能够一致地执行。
- 资源打包:将脚本、模板或附加文档与主要 SKILL.md 指令一起打包,以便智能体在一个位置获取所需的所有内容,从而避免手动为提示附加文件。
- 共享专业知识:将团队的 Android 开发模式打包到共享文件夹中,以便统一访问和协作。
使用 Android 技能
Android skills 已集成到 Android CLI 中,可与您选择的任何智能体搭配使用。

Android CLI
我们建议您使用 Android CLI 安装 Android skill,这样可以更轻松地为您选择的任何智能体发现、下载和管理 skill。
- 如需查看可用技能列表,请运行
android skills list。 - 如需安装技能,请运行
android skills add skill-name。如果您已安装该技能,skills add会将其更新到最新版本。
Android Studio
您可以从 Android 技能 GitHub 代码库下载技能,并将其导入到 Android Studio 中的项目中。
激活技能
智能体会自动启用与您的任务相关的技能。如需使用技能,请提示智能体完成与该技能相关的任务,例如“让我的应用界面采用边到边设计”。如果技能可用,智能体应该会自动找到并使用该技能。
在 Android Studio 中,您还可以直接在对话窗口中输入 @skill-name,手动调用技能。
创建您自己的技能
您可以创建自己的技能,以打包和分享团队的工作流程。 如需详细了解技能要求,请参阅智能体技能规范。
智能体会从项目根目录下的 .skills/ 或 .agent/skills/ 目录开始查找技能。如需构建自定义技能,请按照以下步骤操作:
- 为您的技能创建一个目录(例如
my-new-skill/)。 - 在新目录中创建一个
SKILL.md文件(区分大小写)。
技能必须遵循以下规则:
- 每个技能一个目录:每个技能都必须有自己的专属目录,其中包含一个
SKILL.md文件和任何其他资源。 - 嵌套:所有技能都必须位于项目根目录下的
.skills/或.agent/skills/目录中。不过,您可以使用子目录来更好地整理文件(例如skills/ui-flows/<skill name>/SKILL.md或skills/testing/<skill name>/SKILL.md)。 - 范围:仅支持位于项目代码库中的技能。
SKILL.md 文件使用 YAML 块来存储元数据,并使用标准 Markdown 来存储指令。
name:技能的唯一标识符。此名称应与目录名称一致。description:清晰说明技能的功能以及智能体应在何时使用该技能。- 正文:YAML 代码块下方的 Markdown 正文包含在技能处于活跃状态时指导智能体行为的指令。
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
author: example-org
version: "1.0"
---
Skill content
格式准则
- 名称:最多 64 个字符(仅限小写字母、数字和连字符)。
- 说明:最多 1024 个字符。
- 正文内容:建议控制在 1 万到 2 万个字符(约 2,500 到 5,000 个 token)之间。如果您的指令超出此限制,请考虑将详细文档移至资源文件,如可选技能目录中所述。
可选技能目录
为了使 SKILL.md 文件保持简洁和模块化,您可以在技能文件夹中的以下可选目录中添加其他资源:
scripts/:包含智能体可以运行的可执行代码(例如 Python 或 Bash)。references/:包含详细的技术文档、API 参考文档或特定领域的指南。assets/:包含静态资源,例如文档模板、界面图表或 JSON 架构。
在 SKILL.md 指令中引用这些文件时,请使用相对于技能根目录的相对路径。例如:Run the script at scripts/cleanup.py。
技能的运作方式
技能代表按需提供的专业知识。这种结构使智能体能够保持大量专业化功能,而不会使模型的直接上下文窗口变得杂乱。
模型会根据您的请求和技能的说明,自主决定何时使用技能。识别出相关技能后,模型会动态拉取完成任务所需的完整指令和资源。