Android 技能概览

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 中,可与您选择的任何智能体搭配使用。

gemini_cli_skills_demo.gif

Android CLI

我们建议您使用 Android CLI 安装 Android skill,这样可以更轻松地为您选择的任何智能体发现、下载和管理 skill。

Android Studio

您可以从 Android 技能 GitHub 代码库下载技能,并将其导入到 Android Studio 中的项目中。

激活技能

智能体会自动启用与您的任务相关的技能。如需使用技能,请提示智能体完成与该技能相关的任务,例如“让我的应用界面采用边到边设计”。如果技能可用,智能体应该会自动找到并使用该技能。

在 Android Studio 中,您还可以直接在对话窗口中输入 @skill-name,手动调用技能。

创建您自己的技能

您可以创建自己的技能,以打包和分享团队的工作流程。 如需详细了解技能要求,请参阅智能体技能规范。

智能体会从项目根目录下的 .skills/ 或 .agent/skills/ 目录开始查找技能。如需构建自定义技能,请按照以下步骤操作:

  1. 为您的技能创建一个目录(例如 my-new-skill/)。
  2. 在新目录中创建一个 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。

技能的运作方式

技能代表按需提供的专业知识。这种结构使智能体能够保持大量专业化功能,而不会使模型的直接上下文窗口变得杂乱。

模型会根据您的请求和技能的说明,自主决定何时使用技能。识别出相关技能后,模型会动态拉取完成任务所需的完整指令和资源。